982 lines
69 KiB
XML
982 lines
69 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<Type Name="NameValueCollection" FullName="System.Collections.Specialized.NameValueCollection" FullNameSP="System_Collections_Specialized_NameValueCollection" Maintainer="ecma">
|
|
<TypeSignature Language="ILASM" Value=".class public serializable NameValueCollection extends System.Object" />
|
|
<TypeSignature Language="C#" Value="public class NameValueCollection : System.Collections.Specialized.NameObjectCollectionBase" />
|
|
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable beforefieldinit NameValueCollection extends System.Collections.Specialized.NameObjectCollectionBase" />
|
|
<MemberOfLibrary>Networking</MemberOfLibrary>
|
|
<AssemblyInfo>
|
|
<AssemblyName>System</AssemblyName>
|
|
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ]</AssemblyPublicKey>
|
|
<AssemblyVersion>1.0.x.x</AssemblyVersion>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ThreadingSafetyStatement>All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.</ThreadingSafetyStatement>
|
|
<Base>
|
|
<BaseTypeName>System.Collections.Specialized.NameObjectCollectionBase</BaseTypeName>
|
|
</Base>
|
|
<Interfaces>
|
|
</Interfaces>
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>This collection is based on the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" /> class. However, unlike the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" />, this class stores multiple string values under a single key.</para>
|
|
<para>This class can be used for headers, query strings and form data.</para>
|
|
<para>Each element is a key/value pair.</para>
|
|
<para>Collections of this type do not preserve the ordering of element, and no particular ordering is guaranteed when enumerating the collection.</para>
|
|
<para>The capacity of a <see cref="T:System.Collections.Specialized.NameValueCollection" /> is the number of elements the <see cref="T:System.Collections.Specialized.NameValueCollection" /> can hold. As elements are added to a <see cref="T:System.Collections.Specialized.NameValueCollection" />, the capacity is automatically increased as required through reallocation.</para>
|
|
<para>The hash code provider dispenses hash codes for keys in the <see cref="T:System.Collections.Specialized.NameValueCollection" />. The default hash code provider is the <see cref="T:System.Collections.CaseInsensitiveHashCodeProvider" />.</para>
|
|
<para>The comparer determines whether two keys are equal. The default comparer is the <see cref="T:System.Collections.CaseInsensitiveComparer" />.</para>
|
|
<para>In .NET Framework version 1.0, this class uses culture-sensitive string comparisons. However, in .NET Framework version 1.1 and later, this class uses <see cref="P:System.Globalization.CultureInfo.InvariantCulture" /> when comparing strings. For more information about how culture affects comparisons and sorting, see <format type="text/html"><a href="a097acf0-0bbe-46ac-8d54-b6f2bfd3fc6a">Comparing and Sorting Data for a Specific Culture</a></format> <format type="text/html"><a href="A097ACF0-0BBE-46AC-8D54-B6F2BFD3FC6A"></a></format>and <format type="text/html"><a href="579ef891-1f83-4c63-9ebd-2f40406b5b91">Performing Culture-Insensitive String Operations</a></format>.</para>
|
|
<para>null is allowed as a key or as a value.</para>
|
|
<block subset="none" type="note">
|
|
<para>The <see cref="M:System.Collections.Specialized.NameValueCollection.Get(System.String)" /> method does not distinguish between null which is returned because the specified key is not found and null which is returned because the value associated with the key is null.</para>
|
|
</block>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Represents a collection of associated <see cref="T:System.String" /> keys and <see cref="T:System.String" /> values that can be accessed either with the key or with the index.</para>
|
|
</summary>
|
|
</Docs>
|
|
<Members>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor()" />
|
|
<MemberSignature Language="C#" Value="public NameValueCollection ();" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
|
|
<MemberType>Constructor</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue />
|
|
<Parameters />
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The capacity of a <see cref="T:System.Collections.Specialized.NameValueCollection" /> is the number of elements that the <see cref="T:System.Collections.Specialized.NameValueCollection" /> can hold. As elements are added to a <see cref="T:System.Collections.Specialized.NameValueCollection" />, the capacity is automatically increased as required by reallocating the internal array.</para>
|
|
<para>If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
<para>The hash code provider dispenses hash codes for keys in the <see cref="T:System.Collections.Specialized.NameValueCollection" />. The default hash code provider is the <see cref="T:System.Collections.CaseInsensitiveHashCodeProvider" />.</para>
|
|
<para>The comparer determines whether two keys are equal. The default comparer is the <see cref="T:System.Collections.CaseInsensitiveComparer" />.</para>
|
|
<para>This constructor is an O(1) operation.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Initializes a new instance of the <see cref="T:System.Collections.Specialized.NameValueCollection" /> class that is empty, has the default initial capacity and uses the default case-insensitive hash code provider and the default case-insensitive comparer.</para>
|
|
</summary>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="C#" Value="public NameValueCollection (System.Collections.IEqualityComparer equalityComparer);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Collections.IEqualityComparer equalityComparer) cil managed" />
|
|
<MemberType>Constructor</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<Parameters>
|
|
<Parameter Name="equalityComparer" Type="System.Collections.IEqualityComparer" />
|
|
</Parameters>
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The capacity of a <see cref="T:System.Collections.Specialized.NameValueCollection" /> object is the number of elements that the <see cref="T:System.Collections.Specialized.NameValueCollection" /> can hold. As elements are added to a <see cref="T:System.Collections.Specialized.NameValueCollection" />, the capacity is automatically increased as required by reallocating the internal array.</para>
|
|
<para>If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
<para>The <see cref="T:System.Collections.IEqualityComparer" /> object combines the comparer and the hash code provider. The hash code provider dispenses hash codes for keys in the <see cref="T:System.Collections.Specialized.NameValueCollection" />. The comparer determines whether two keys are equal.</para>
|
|
<para>This constructor is an O(1) operation.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Initializes a new instance of the <see cref="T:System.Collections.Specialized.NameValueCollection" /> class that is empty, has the default initial capacity, and uses the specified <see cref="T:System.Collections.IEqualityComparer" /> object.</para>
|
|
</summary>
|
|
<param name="equalityComparer">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.IEqualityComparer" /> object to use to determine whether two keys are equal and to generate hash codes for the keys in the collection.</param>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(class System.Collections.Specialized.NameValueCollection col)" />
|
|
<MemberSignature Language="C#" Value="public NameValueCollection (System.Collections.Specialized.NameValueCollection col);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Collections.Specialized.NameValueCollection col) cil managed" />
|
|
<MemberType>Constructor</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue />
|
|
<Parameters>
|
|
<Parameter Name="col" Type="System.Collections.Specialized.NameValueCollection" />
|
|
</Parameters>
|
|
<Docs>
|
|
<exception cref="T:System.ArgumentNullException">
|
|
<paramref name="col" /> is <see langword="null" />.</exception>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The capacity of a <see cref="T:System.Collections.Specialized.NameValueCollection" /> is the number of elements that the <see cref="T:System.Collections.Specialized.NameValueCollection" /> can hold. As elements are added to a <see cref="T:System.Collections.Specialized.NameValueCollection" />, the capacity is automatically increased as required by reallocating the internal array.</para>
|
|
<para>If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
<para>The hash code provider dispenses hash codes for keys in the <see cref="T:System.Collections.Specialized.NameValueCollection" />. The default hash code provider is the <see cref="T:System.Collections.CaseInsensitiveHashCodeProvider" />.</para>
|
|
<para>The comparer determines whether two keys are equal. The default comparer is the <see cref="T:System.Collections.CaseInsensitiveComparer" />.</para>
|
|
<para>The elements of the new <see cref="T:System.Collections.Specialized.NameValueCollection" /> are sorted in the same order as the source <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
<para>This constructor is an O(<paramref name="n" />) operation, where <paramref name="n" /> is the number of elements in <paramref name="col" />.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Copies the entries from the specified <see cref="T:System.Collections.Specialized.NameValueCollection" /> to a new <see cref="T:System.Collections.Specialized.NameValueCollection" /> with the same initial capacity as the number of entries copied and using the same hash code provider and the same comparer as the source collection.</para>
|
|
</summary>
|
|
<param name="col">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.Specialized.NameValueCollection" /> to copy to the new <see cref="T:System.Collections.Specialized.NameValueCollection" /> instance.</param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(int32 capacity)" />
|
|
<MemberSignature Language="C#" Value="public NameValueCollection (int capacity);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(int32 capacity) cil managed" />
|
|
<MemberType>Constructor</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue />
|
|
<Parameters>
|
|
<Parameter Name="capacity" Type="System.Int32" />
|
|
</Parameters>
|
|
<Docs>
|
|
<exception cref="T:System.ArgumentOutOfRangeException">
|
|
<paramref name="capacity" /> < 0. </exception>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The capacity of a <see cref="T:System.Collections.Specialized.NameValueCollection" /> is the number of elements that the <see cref="T:System.Collections.Specialized.NameValueCollection" /> can hold. As elements are added to a <see cref="T:System.Collections.Specialized.NameValueCollection" />, the capacity is automatically increased as required by reallocating the internal array.</para>
|
|
<para>If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
<para>The hash code provider dispenses hash codes for keys in the <see cref="T:System.Collections.Specialized.NameValueCollection" />. The default hash code provider is the <see cref="T:System.Collections.CaseInsensitiveHashCodeProvider" />.</para>
|
|
<para>The comparer determines whether two keys are equal. The default comparer is the <see cref="T:System.Collections.CaseInsensitiveComparer" />.</para>
|
|
<para>This constructor is an O(<paramref name="n" />) operation, where <paramref name="n" /> is <paramref name="capacity" />.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Initializes a new instance of the <see cref="T:System.Collections.Specialized.NameValueCollection" /> class that is empty, has the specified initial capacity and uses the default case-insensitive hash code provider and the default case-insensitive comparer.</para>
|
|
</summary>
|
|
<param name="capacity">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The initial number of entries that the <see cref="T:System.Collections.Specialized.NameValueCollection" /> can contain.</param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(class System.Collections.IHashCodeProvider hashProvider, class System.Collections.IComparer comparer)" />
|
|
<MemberSignature Language="C#" Value="public NameValueCollection (System.Collections.IHashCodeProvider hashProvider, System.Collections.IComparer comparer);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Collections.IHashCodeProvider hashProvider, class System.Collections.IComparer comparer) cil managed" />
|
|
<MemberType>Constructor</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<Attributes>
|
|
<Attribute>
|
|
<AttributeName>System.Obsolete("Use NameValueCollection (IEqualityComparer)")</AttributeName>
|
|
</Attribute>
|
|
</Attributes>
|
|
<ReturnValue />
|
|
<Parameters>
|
|
<Parameter Name="hashProvider" Type="System.Collections.IHashCodeProvider" />
|
|
<Parameter Name="comparer" Type="System.Collections.IComparer" />
|
|
</Parameters>
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The capacity of a <see cref="T:System.Collections.Specialized.NameValueCollection" /> is the number of elements that the <see cref="T:System.Collections.Specialized.NameValueCollection" /> can hold. As elements are added to a <see cref="T:System.Collections.Specialized.NameValueCollection" />, the capacity is automatically increased as required by reallocating the internal array.</para>
|
|
<para>If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
<para>The hash code provider dispenses hash codes for keys in the <see cref="T:System.Collections.Specialized.NameValueCollection" />. The default hash code provider is the <see cref="T:System.Collections.CaseInsensitiveHashCodeProvider" />.</para>
|
|
<para>The comparer determines whether two keys are equal. The default comparer is the <see cref="T:System.Collections.CaseInsensitiveComparer" />.</para>
|
|
<para>This constructor is an O(1) operation.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Initializes a new instance of the <see cref="T:System.Collections.Specialized.NameValueCollection" /> class that is empty, has the default initial capacity and uses the specified hash code provider and the specified comparer.</para>
|
|
</summary>
|
|
<param name="hashProvider">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.IHashCodeProvider" /> that will supply the hash codes for all keys in the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</param>
|
|
<param name="comparer">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.IComparer" /> to use to determine whether two keys are equal.</param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="C#" Value="public NameValueCollection (int capacity, System.Collections.IEqualityComparer equalityComparer);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(int32 capacity, class System.Collections.IEqualityComparer equalityComparer) cil managed" />
|
|
<MemberType>Constructor</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<Parameters>
|
|
<Parameter Name="capacity" Type="System.Int32" />
|
|
<Parameter Name="equalityComparer" Type="System.Collections.IEqualityComparer" />
|
|
</Parameters>
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The capacity of a <see cref="T:System.Collections.Specialized.NameValueCollection" /> object is the number of elements that the <see cref="T:System.Collections.Specialized.NameValueCollection" /> can hold. As elements are added to a <see cref="T:System.Collections.Specialized.NameValueCollection" />, the capacity is automatically increased as required by reallocating the internal array.</para>
|
|
<para>If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
<para>The <see cref="T:System.Collections.IEqualityComparer" /> object combines the comparer and the hash code provider. The hash code provider dispenses hash codes for keys in the <see cref="T:System.Collections.Specialized.NameValueCollection" />. The comparer determines whether two keys are equal.</para>
|
|
<para>This constructor is an O(<paramref name="n" />) operation, where <paramref name="n" /> is the <paramref name="capacity" /> parameter.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Initializes a new instance of the <see cref="T:System.Collections.Specialized.NameValueCollection" /> class that is empty, has the specified initial capacity, and uses the specified <see cref="T:System.Collections.IEqualityComparer" /> object.</para>
|
|
</summary>
|
|
<param name="capacity">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The initial number of entries that the <see cref="T:System.Collections.Specialized.NameValueCollection" /> object can contain.</param>
|
|
<param name="equalityComparer">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.IEqualityComparer" /> object to use to determine whether two keys are equal and to generate hash codes for the keys in the collection.</param>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(int32 capacity, class System.Collections.Specialized.NameValueCollection col)" />
|
|
<MemberSignature Language="C#" Value="public NameValueCollection (int capacity, System.Collections.Specialized.NameValueCollection col);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(int32 capacity, class System.Collections.Specialized.NameValueCollection col) cil managed" />
|
|
<MemberType>Constructor</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue />
|
|
<Parameters>
|
|
<Parameter Name="capacity" Type="System.Int32" />
|
|
<Parameter Name="col" Type="System.Collections.Specialized.NameValueCollection" />
|
|
</Parameters>
|
|
<Docs>
|
|
<exception cref="T:System.ArgumentNullException">
|
|
<paramref name="col" /> is <see langword="null" />.</exception>
|
|
<exception cref="T:System.ArgumentOutOfRangeException">
|
|
<paramref name="capacity" /> is < 0.</exception>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The capacity of a <see cref="T:System.Collections.Specialized.NameValueCollection" /> is the number of elements that the <see cref="T:System.Collections.Specialized.NameValueCollection" /> can hold. As elements are added to a <see cref="T:System.Collections.Specialized.NameValueCollection" />, the capacity is automatically increased as required by reallocating the internal array.</para>
|
|
<para>If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
<para>The hash code provider dispenses hash codes for keys in the <see cref="T:System.Collections.Specialized.NameValueCollection" />. The default hash code provider is the <see cref="T:System.Collections.CaseInsensitiveHashCodeProvider" />.</para>
|
|
<para>The comparer determines whether two keys are equal. The default comparer is the <see cref="T:System.Collections.CaseInsensitiveComparer" />.</para>
|
|
<para>This constructor is an O(<paramref name="n" />) operation, where <paramref name="n" /> is <paramref name="capacity" />. If the number of elements in <paramref name="col" /> is greater than <paramref name="capacity" />, this constructor becomes an O(<paramref name="n" /> + <paramref name="m" />) operation, where <paramref name="n" /> is <paramref name="capacity" /> and <paramref name="m" /> is the number of elements in <paramref name="col" />.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Copies the entries from the specified <see cref="T:System.Collections.Specialized.NameValueCollection" /> to a new <see cref="T:System.Collections.Specialized.NameValueCollection" /> with the specified initial capacity or the same initial capacity as the number of entries copied, whichever is greater, and using the default case-insensitive hash code provider and the default case-insensitive comparer.</para>
|
|
</summary>
|
|
<param name="capacity">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The initial number of entries that the <see cref="T:System.Collections.Specialized.NameValueCollection" /> can contain.</param>
|
|
<param name="col">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.Specialized.NameValueCollection" /> to copy to the new <see cref="T:System.Collections.Specialized.NameValueCollection" /> instance.</param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="C#" Value="protected NameValueCollection (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);" />
|
|
<MemberSignature Language="ILAsm" Value=".method familyhidebysig specialname rtspecialname instance void .ctor(class System.Runtime.Serialization.SerializationInfo info, valuetype System.Runtime.Serialization.StreamingContext context) cil managed" />
|
|
<MemberType>Constructor</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<Parameters>
|
|
<Parameter Name="info" Type="System.Runtime.Serialization.SerializationInfo" />
|
|
<Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" />
|
|
</Parameters>
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>This constructor is an O(1) operation.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Initializes a new instance of the <see cref="T:System.Collections.Specialized.NameValueCollection" /> class that is serializable and uses the specified <see cref="T:System.Runtime.Serialization.SerializationInfo" /> and <see cref="T:System.Runtime.Serialization.StreamingContext" />.</para>
|
|
</summary>
|
|
<param name="info">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.Serialization.SerializationInfo" /> object that contains the information required to serialize the new <see cref="T:System.Collections.Specialized.NameValueCollection" /> instance.</param>
|
|
<param name="context">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.Serialization.StreamingContext" /> object that contains the source and destination of the serialized stream associated with the new <see cref="T:System.Collections.Specialized.NameValueCollection" /> instance.</param>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(int32 capacity, class System.Collections.IHashCodeProvider hashProvider, class System.Collections.IComparer comparer)" />
|
|
<MemberSignature Language="C#" Value="public NameValueCollection (int capacity, System.Collections.IHashCodeProvider hashProvider, System.Collections.IComparer comparer);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(int32 capacity, class System.Collections.IHashCodeProvider hashProvider, class System.Collections.IComparer comparer) cil managed" />
|
|
<MemberType>Constructor</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<Attributes>
|
|
<Attribute>
|
|
<AttributeName>System.Obsolete("Use NameValueCollection (IEqualityComparer)")</AttributeName>
|
|
</Attribute>
|
|
</Attributes>
|
|
<ReturnValue />
|
|
<Parameters>
|
|
<Parameter Name="capacity" Type="System.Int32" />
|
|
<Parameter Name="hashProvider" Type="System.Collections.IHashCodeProvider" />
|
|
<Parameter Name="comparer" Type="System.Collections.IComparer" />
|
|
</Parameters>
|
|
<Docs>
|
|
<exception cref="T:System.ArgumentOutOfRangeException">
|
|
<paramref name="capacity" /> < 0. </exception>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The capacity of a <see cref="T:System.Collections.Specialized.NameValueCollection" /> is the number of elements that the <see cref="T:System.Collections.Specialized.NameValueCollection" /> can hold. As elements are added to a <see cref="T:System.Collections.Specialized.NameValueCollection" />, the capacity is automatically increased as required by reallocating the internal array.</para>
|
|
<para>If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
<para>The hash code provider dispenses hash codes for keys in the <see cref="T:System.Collections.Specialized.NameValueCollection" />. The default hash code provider is the <see cref="T:System.Collections.CaseInsensitiveHashCodeProvider" />.</para>
|
|
<para>The comparer determines whether two keys are equal. The default comparer is the <see cref="T:System.Collections.CaseInsensitiveComparer" />.</para>
|
|
<para>This constructor is an O(<paramref name="n" />) operation, where <paramref name="n" /> is <paramref name="capacity" />.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Initializes a new instance of the <see cref="T:System.Collections.Specialized.NameValueCollection" /> class that is empty, has the specified initial capacity and uses the specified hash code provider and the specified comparer.</para>
|
|
</summary>
|
|
<param name="capacity">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The initial number of entries that the <see cref="T:System.Collections.Specialized.NameValueCollection" /> can contain.</param>
|
|
<param name="hashProvider">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.IHashCodeProvider" /> that will supply the hash codes for all keys in the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</param>
|
|
<param name="comparer">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.IComparer" /> to use to determine whether two keys are equal.</param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="Add">
|
|
<MemberSignature Language="ILASM" Value=".method public hidebysig instance void Add(class System.Collections.Specialized.NameValueCollection c)" />
|
|
<MemberSignature Language="C#" Value="public void Add (System.Collections.Specialized.NameValueCollection c);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Add(class System.Collections.Specialized.NameValueCollection c) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="c" Type="System.Collections.Specialized.NameValueCollection" />
|
|
</Parameters>
|
|
<Docs>
|
|
<exception cref="T:System.NotSupportedException">The current instance is read-only.</exception>
|
|
<exception cref="T:System.ArgumentNullException">
|
|
<paramref name="c" /> is <see langword="null" />.</exception>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>If a key in <paramref name="c" /> already exists in the target <see cref="T:System.Collections.Specialized.NameValueCollection" /> instance, the associated value in <paramref name="c" /> is added to the existing comma-separated list of values associated with the same key in the target <see cref="T:System.Collections.Specialized.NameValueCollection" /> instance.</para>
|
|
<para>If <see cref="P:System.Collections.Specialized.NameObjectCollectionBase.Count" /> already equals the capacity, the capacity of the <see cref="T:System.Collections.Specialized.NameValueCollection" /> is increased by automatically reallocating the internal array, and the existing elements are copied to the new array before the new element is added.</para>
|
|
<para>If <see cref="P:System.Collections.Specialized.NameObjectCollectionBase.Count" /> is less than the capacity, this method is an O(1) operation. If the capacity needs to be increased to accommodate the new element, this method becomes an O(<paramref name="n" />) operation, where <paramref name="n" /> is <see cref="P:System.Collections.Specialized.NameObjectCollectionBase.Count" />.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Copies the entries in the specified <see cref="T:System.Collections.Specialized.NameValueCollection" /> to the current <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
</summary>
|
|
<param name="c">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.Specialized.NameValueCollection" /> to copy to the current <see cref="T:System.Collections.Specialized.NameValueCollection" />.</param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="Add">
|
|
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual void Add(string name, string value)" />
|
|
<MemberSignature Language="C#" Value="public virtual void Add (string name, string value);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void Add(string name, string value) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="name" Type="System.String" />
|
|
<Parameter Name="value" Type="System.String" />
|
|
</Parameters>
|
|
<Docs>
|
|
<exception cref="T:System.NotSupportedException">The current instance is read-only.</exception>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>If the specified key already exists in the target <see cref="T:System.Collections.Specialized.NameValueCollection" /> instance, the specified value is added to the existing comma-separated list of values in the form "value1,value2,value3". The values are associated with the same key in the target <see cref="T:System.Collections.Specialized.NameValueCollection" /> instance.</para>
|
|
<para>If <see cref="P:System.Collections.Specialized.NameObjectCollectionBase.Count" /> already equals the capacity, the capacity of the <see cref="T:System.Collections.Specialized.NameValueCollection" /> is increased by automatically reallocating the internal array, and the existing elements are copied to the new array before the new element is added.</para>
|
|
<para>If <see cref="P:System.Collections.Specialized.NameObjectCollectionBase.Count" /> is less than the capacity, this method is an O(1) operation. If the capacity needs to be increased to accommodate the new element, this method becomes an O(<paramref name="n" />) operation, where <paramref name="n" /> is <see cref="P:System.Collections.Specialized.NameObjectCollectionBase.Count" />.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Adds an entry with the specified name and value to the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
</summary>
|
|
<param name="name">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> key of the entry to add. The key can be null.</param>
|
|
<param name="value">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> value of the entry to add. The value can be null.</param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="AllKeys">
|
|
<MemberSignature Language="ILASM" Value=".property class System.String[] AllKeys { public hidebysig virtual specialname class System.String[] get_AllKeys() }" />
|
|
<MemberSignature Language="C#" Value="public virtual string[] AllKeys { get; }" />
|
|
<MemberSignature Language="ILAsm" Value=".property instance string[] AllKeys" />
|
|
<MemberType>Property</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.String[]</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<value>
|
|
<para> A <see cref="T:System.String" /> array containing all the keys of the current instance.
|
|
If the current instance is empty, the value of this property is an empty array.</para>
|
|
</value>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>If the collection is empty, this method returns an empty <see cref="T:System.String" /> array, not null.</para>
|
|
<para>The arrays returned by <see cref="P:System.Collections.Specialized.NameValueCollection.AllKeys" /> are cached for better performance and are automatically refreshed when the collection changes. A derived class can invalidate the cached version by calling <see cref="M:System.Collections.Specialized.NameValueCollection.InvalidateCachedArrays" />, thereby forcing the arrays to be recreated.</para>
|
|
<para>This method is an O(<paramref name="n" />) operation, where <paramref name="n" /> is <see cref="P:System.Collections.Specialized.NameObjectCollectionBase.Count" />.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets all the keys in the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
</summary>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="Clear">
|
|
<MemberSignature Language="ILASM" Value=".method public hidebysig instance void Clear()" />
|
|
<MemberSignature Language="C#" Value="public virtual void Clear ();" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void Clear() cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<exception cref="T:System.NotSupportedException">The current instance is read-only.</exception>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>This method is an O(1) operation.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Invalidates the cached arrays and removes all entries from the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
</summary>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="CopyTo">
|
|
<MemberSignature Language="ILASM" Value=".method public hidebysig instance void CopyTo(class System.Array dest, int32 index)" />
|
|
<MemberSignature Language="C#" Value="public void CopyTo (Array dest, int index);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void CopyTo(class System.Array dest, int32 index) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="dest" Type="System.Array" />
|
|
<Parameter Name="index" Type="System.Int32" />
|
|
</Parameters>
|
|
<Docs>
|
|
<exception cref="T:System.ArgumentNullException">
|
|
<paramref name="dest" /> is <see langword="null" />.</exception>
|
|
<exception cref="T:System.ArgumentOutOfRangeException">
|
|
<paramref name="index" /> < 0.</exception>
|
|
<exception cref="T:System.ArgumentException">
|
|
<para>
|
|
<paramref name="dest" /> has more than one dimension.</para>
|
|
<para>-or-</para>
|
|
<para>
|
|
<paramref name="index" /> >= <paramref name="dest" />.Length.</para>
|
|
<para>-or-</para>
|
|
<para>The number of elements in the current instance is greater than the available space from <paramref name="index" /> to the end of the destination <paramref name="dest" />.</para>
|
|
</exception>
|
|
<exception cref="T:System.InvalidCastException">At least one element in the current instance is not assignment-compatible with the type of <paramref name="dest" />.</exception>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The specified array must be of a compatible type.</para>
|
|
<para>This method uses <see cref="M:System.Array.Copy(System.Array,System.Array,System.Int32)" /> to copy the elements.</para>
|
|
<para>This method is an O(<paramref name="n" />) operation, where <paramref name="n" /> is <see cref="P:System.Collections.Specialized.NameObjectCollectionBase.Count" />.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Copies the entire <see cref="T:System.Collections.Specialized.NameValueCollection" /> to a compatible one-dimensional <see cref="T:System.Array" />, starting at the specified index of the target array.</para>
|
|
</summary>
|
|
<param name="dest">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional <see cref="T:System.Array" /> that is the destination of the elements copied from <see cref="T:System.Collections.Specialized.NameValueCollection" />. The <see cref="T:System.Array" /> must have zero-based indexing.</param>
|
|
<param name="index">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The zero-based index in <paramref name="dest" /> at which copying begins.</param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="Count">
|
|
<MemberSignature Language="C#" Value="public virtual int Count { get; }" />
|
|
<MemberSignature Language="ILAsm" Value=".property int32 Count { public hidebysig virtual specialname int32 get_Count() }" />
|
|
<MemberType>Property</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Int32</ReturnType>
|
|
</ReturnValue>
|
|
<Docs>
|
|
<summary>
|
|
<para> Gets the number of elements contained in the current
|
|
instance.</para>
|
|
</summary>
|
|
<value>
|
|
<para>A <see cref="T:System.Int32" /> that indicates the number of elements contained in the current
|
|
instance.</para>
|
|
</value>
|
|
<remarks>
|
|
<para>This property is read-only.</para>
|
|
<block subset="none" type="note">
|
|
<para>This property is implemented to support the <see cref="T:System.Collections.ICollection" /> interface.</para>
|
|
</block>
|
|
</remarks>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="Get">
|
|
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual string Get(int32 index)" />
|
|
<MemberSignature Language="C#" Value="public virtual string Get (int index);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance string Get(int32 index) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.String</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="index" Type="System.Int32" />
|
|
</Parameters>
|
|
<Docs>
|
|
<exception cref="T:System.ArgumentOutOfRangeException">
|
|
<paramref name="index" /> is outside the valid range of indices for the current instance.</exception>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>This method is an O(<paramref name="n" />) operation, where <paramref name="n" /> is the number of values at the specified index.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets the values at the specified index of the <see cref="T:System.Collections.Specialized.NameValueCollection" /> combined into one comma-separated list.</para>
|
|
</summary>
|
|
<returns>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>A <see cref="T:System.String" /> that contains a comma-separated list of the values at the specified index of the <see cref="T:System.Collections.Specialized.NameValueCollection" />, if found; otherwise, null.</para>
|
|
</returns>
|
|
<param name="index">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the entry that contains the values to get from the collection.</param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="Get">
|
|
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual string Get(string name)" />
|
|
<MemberSignature Language="C#" Value="public virtual string Get (string name);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance string Get(string name) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.String</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="name" Type="System.String" />
|
|
</Parameters>
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<block subset="none" type="note">
|
|
<para>This method returns null in the following cases: 1) if the specified key is not found; and 2) if the specified key is found and its associated value is null. This method does not distinguish between the two cases.</para>
|
|
</block>
|
|
<para>This method is an O(<paramref name="n" />) operation, where <paramref name="n" /> is the number of values associated with the specified key.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets the values associated with the specified key from the <see cref="T:System.Collections.Specialized.NameValueCollection" /> combined into one comma-separated list.</para>
|
|
</summary>
|
|
<returns>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>A <see cref="T:System.String" /> that contains a comma-separated list of the values associated with the specified key from the <see cref="T:System.Collections.Specialized.NameValueCollection" />, if found; otherwise, null.</para>
|
|
</returns>
|
|
<param name="name">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> key of the entry that contains the values to get. The key can be null.</param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="GetKey">
|
|
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual string GetKey(int32 index)" />
|
|
<MemberSignature Language="C#" Value="public virtual string GetKey (int index);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance string GetKey(int32 index) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.String</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="index" Type="System.Int32" />
|
|
</Parameters>
|
|
<Docs>
|
|
<exception cref="T:System.ArgumentOutOfRangeException">
|
|
<paramref name="index" /> is outside the valid range of indices for the current instance.</exception>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>This method is an O(1) operation.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets the key at the specified index of the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
</summary>
|
|
<returns>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>A <see cref="T:System.String" /> that contains the key at the specified index of the <see cref="T:System.Collections.Specialized.NameValueCollection" />, if found; otherwise, null.</para>
|
|
</returns>
|
|
<param name="index">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the key to get from the collection.</param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="GetValues">
|
|
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual class System.String[] GetValues(int32 index)" />
|
|
<MemberSignature Language="C#" Value="public virtual string[] GetValues (int index);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance string[] GetValues(int32 index) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.String[]</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="index" Type="System.Int32" />
|
|
</Parameters>
|
|
<Docs>
|
|
<exception cref="T:System.ArgumentOutOfRangeException">
|
|
<paramref name="index" /> is outside the valid range of indices for the current instance.</exception>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>This method is an O(<paramref name="n" />) operation, where <paramref name="n" /> is the number of values at the specified index.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets the values at the specified index of the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
</summary>
|
|
<returns>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>A <see cref="T:System.String" /> array that contains the values at the specified index of the <see cref="T:System.Collections.Specialized.NameValueCollection" />, if found; otherwise, null.</para>
|
|
</returns>
|
|
<param name="index">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the entry that contains the values to get from the collection.</param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="GetValues">
|
|
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual class System.String[] GetValues(string name)" />
|
|
<MemberSignature Language="C#" Value="public virtual string[] GetValues (string name);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance string[] GetValues(string name) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.String[]</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="name" Type="System.String" />
|
|
</Parameters>
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<block subset="none" type="note">
|
|
<para>This method returns null in the following cases: 1) if the specified key is not found; and 2) if the specified key is found and its associated value is null. This method does not distinguish between the two cases.</para>
|
|
</block>
|
|
<para>This method is an O(<paramref name="n" />) operation, where <paramref name="n" /> is the number of values associated with the specified key.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets the values associated with the specified key from the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
</summary>
|
|
<returns>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>A <see cref="T:System.String" /> array that contains the values associated with the specified key from the <see cref="T:System.Collections.Specialized.NameValueCollection" />, if found; otherwise, null.</para>
|
|
</returns>
|
|
<param name="name">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> key of the entry that contains the values to get. The key can be null.</param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="HasKeys">
|
|
<MemberSignature Language="ILASM" Value=".method public hidebysig instance bool HasKeys()" />
|
|
<MemberSignature Language="C#" Value="public bool HasKeys ();" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance bool HasKeys() cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Boolean</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>This method is an O(1) operation.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets a value indicating whether the <see cref="T:System.Collections.Specialized.NameValueCollection" /> contains keys that are not null.</para>
|
|
</summary>
|
|
<returns>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>true if the <see cref="T:System.Collections.Specialized.NameValueCollection" /> contains keys that are not null; otherwise, false.</para>
|
|
</returns>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="InvalidateCachedArrays">
|
|
<MemberSignature Language="ILASM" Value=".method family hidebysig instance void InvalidateCachedArrays()" />
|
|
<MemberSignature Language="C#" Value="protected void InvalidateCachedArrays ();" />
|
|
<MemberSignature Language="ILAsm" Value=".method familyhidebysig instance void InvalidateCachedArrays() cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The arrays returned by <see cref="P:System.Collections.Specialized.NameValueCollection.AllKeys" /> are cached for better performance and are automatically refreshed when the collection changes. A derived class can invalidate the cached version by calling <see cref="M:System.Collections.Specialized.NameValueCollection.InvalidateCachedArrays" />, thereby forcing the arrays to be recreated.</para>
|
|
<para>This method is an O(1) operation.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Resets the cached arrays of the collection to null.</para>
|
|
</summary>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="IsReadOnly">
|
|
<MemberSignature Language="C#" Value="protected bool IsReadOnly { set; get; }" />
|
|
<MemberSignature Language="ILAsm" Value=".property bool IsReadOnly { family hidebysig specialname bool get_IsReadOnly() family hidebysig specialname void set_IsReadOnly(bool value) }" />
|
|
<MemberType>Property</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Boolean</ReturnType>
|
|
</ReturnValue>
|
|
<Docs>
|
|
<summary>Gets or sets a value indicating whether the current instance is read-only.</summary>
|
|
<value>
|
|
<see langword="true" /> if the current instance is read-only; otherwise, <see langword="false" />.</value>
|
|
<remarks>
|
|
<para>This property is read-write.</para>
|
|
</remarks>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="Item">
|
|
<MemberSignature Language="ILASM" Value=".property string Item[int32 index] { public hidebysig specialname instance string get_Item(int32 index) }" />
|
|
<MemberSignature Language="C#" Value="public string this[int index] { get; }" />
|
|
<MemberSignature Language="ILAsm" Value=".property instance string Item(int32)" />
|
|
<MemberType>Property</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.String</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="index" Type="System.Int32" />
|
|
</Parameters>
|
|
<Docs>
|
|
<param name="index">
|
|
<para> A <see cref="T:System.Int32" /> that specifies the zero-based index of the entry to locate in the current instance.</para>
|
|
</param>
|
|
<summary>
|
|
<para> Gets the value in the current instance that is associated with the
|
|
specified index.</para>
|
|
</summary>
|
|
<value>
|
|
<para>A <see cref="T:System.String" /> that contains the comma-separated list of values at the specified
|
|
index of the current instance.</para>
|
|
</value>
|
|
<remarks>
|
|
<para>This property is read-only.</para>
|
|
<block subset="none" type="note">
|
|
<para>This property provides the ability to access a specific element in the
|
|
collection by using the following syntax: <c>myCollection[index]</c>.</para>
|
|
<para>This property cannot be set. To set the value at a specified index,
|
|
use <c>Item[GetKey(index)]</c>.</para>
|
|
</block>
|
|
</remarks>
|
|
<exception cref="T:System.ArgumentOutOfRangeException">
|
|
<paramref name="index" /> is outside the valid range of indices for the current instance.</exception>
|
|
<exception cref="T:System.NotSupportedException">The property is being set and the current instance is read-only.</exception>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="Item">
|
|
<MemberSignature Language="ILASM" Value=".property string Item[string name] { public hidebysig specialname instance string get_Item(string name) public hidebysig specialname instance void set_Item(string name, string value) }" />
|
|
<MemberSignature Language="C#" Value="public string this[string name] { get; set; }" />
|
|
<MemberSignature Language="ILAsm" Value=".property instance string Item(string)" />
|
|
<MemberType>Property</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.String</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="name" Type="System.String" />
|
|
</Parameters>
|
|
<Docs>
|
|
<param name="name">
|
|
<para>A <see cref="T:System.String" /> containing the key of the entry to locate. </para>
|
|
</param>
|
|
<summary>
|
|
<para>Gets or sets the value in the current instance that is associated with the
|
|
specified key.</para>
|
|
</summary>
|
|
<value>
|
|
<para>A <see cref="T:System.String" /> that contains the
|
|
comma-separated list of values associated with the specified key. If
|
|
<paramref name="name" /> is not contained in the current instance, attempting to get it
|
|
returns <see langword="null" />, and attempting to set it creates a new entry
|
|
using <paramref name="name" />
|
|
.</para>
|
|
</value>
|
|
<remarks>
|
|
<para>If the specified key already exists in the collection,
|
|
setting this property overwrites the existing values with the specified
|
|
value. (If the existing value contains a string of multiple comma-delimited values, the complete string is replaced with a single instance of the specified value.) If the specified key does not exist in the collection, setting this
|
|
property creates a new entry using the specified key and the specified
|
|
value.</para>
|
|
<block subset="none" type="note">
|
|
<para>This property provides the ability to access a specific element in the
|
|
current instance using the following notation: myCollection[key] .</para>
|
|
<para> To add the new value to
|
|
the existing list of values, use the <see cref="M:System.Collections.Specialized.NameValueCollection.Add(System.Collections.Specialized.NameValueCollection)" /> method.</para>
|
|
</block>
|
|
</remarks>
|
|
<exception cref="T:System.ArgumentOutOfRangeException">
|
|
<paramref name="index" /> is outside the valid range of indexes for the collection.</exception>
|
|
<exception cref="T:System.NotSupportedException">The property is being set and the current instance is read-only. </exception>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="Remove">
|
|
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual void Remove(string name)" />
|
|
<MemberSignature Language="C#" Value="public virtual void Remove (string name);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void Remove(string name) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="name" Type="System.String" />
|
|
</Parameters>
|
|
<Docs>
|
|
<exception cref="T:System.NotSupportedException">
|
|
<para>The current instance is read-only.</para>
|
|
</exception>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>If the <see cref="T:System.Collections.Specialized.NameValueCollection" /> does not contain an element with the specified key, the <see cref="T:System.Collections.Specialized.NameValueCollection" /> remains unchanged. No exception is thrown.</para>
|
|
<para>In collections of contiguous elements, such as lists, the elements that follow the removed element move up to occupy the vacated spot. If the collection is indexed, the indexes of the elements that are moved are also updated. This behavior does not apply to collections where elements are conceptually grouped into buckets, such as a hash table.</para>
|
|
<para>This method is an O(<paramref name="n" />) operation, where <paramref name="n" /> is <see cref="P:System.Collections.Specialized.NameObjectCollectionBase.Count" />.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Removes the entries with the specified key from the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" /> instance.</para>
|
|
</summary>
|
|
<param name="name">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> key of the entry to remove. The key can be null.</param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="Set">
|
|
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual void Set(string name, string value)" />
|
|
<MemberSignature Language="C#" Value="public virtual void Set (string name, string value);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void Set(string name, string value) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="name" Type="System.String" />
|
|
<Parameter Name="value" Type="System.String" />
|
|
</Parameters>
|
|
<Docs>
|
|
<exception cref="T:System.NotSupportedException">The current instance is read-only.</exception>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>If the specified key already exists in the collection, this method overwrites the existing list of values with the specified value. To append the new value to the existing list of values, use the <see cref="M:System.Collections.Specialized.NameValueCollection.Add(System.Collections.Specialized.NameValueCollection)" /> method.</para>
|
|
<para>If the specified key does not exist in the collection, this method creates a new entry using the specified key and the specified value.</para>
|
|
<para>This method is an O(1) operation. </para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Sets the value of an entry in the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
|
|
</summary>
|
|
<param name="name">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> key of the entry to add the new value to. The key can be null.</param>
|
|
<param name="value">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> that represents the new value to add to the specified entry. The value can be null.</param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
</Members>
|
|
<TypeExcluded>0</TypeExcluded>
|
|
</Type> |