NameValueCollection.Item[] 属性

定义

命名空间:

System.Collections.Specialized

程序集:

System.Collections.Specialized.dll

获取或设置 NameValueCollection 中的指定项。

重载

Item[Int32]	获取 NameValueCollection 中指定索引处的项。
Item[String]	获取或设置 NameValueCollection 中具有指定键的项。

Item[Int32]

Source:

NameValueCollection.cs

获取 NameValueCollection 中指定索引处的项。

public:
 property System::String ^ default[int] { System::String ^ get(int index); };

public string? this[int index] { get; }

member this.Item(int) : string

Default Public ReadOnly Property Item(index As Integer) As String

参数

index

Int32

要在集合中定位的项的从零开始的索引。

属性值

String

String 包含集合中指定索引处的值的列表（此列表以逗号分隔）。

例外

ArgumentOutOfRangeException

index 超出了集合的有效索引范围。

注解

通过此属性，可以使用以下语法来访问集合中的特定元素：myCollection[index]。

无法设置此属性。 若要在指定索引处设置值，请使用 Item[GetKey(index)]。

C# 语言使用此关键字 (keyword) 来定义索引器，而不是实现 Item[] 属性。 Visual Basic 实现 Item[] 为 默认属性，该属性提供相同的索引功能。

检索指定索引处的值是 O (n) 操作，其中 n 是值的数目。

另请参阅

• Get
• 执行不区分区域性的字符串操作

Item[String]

Source:

NameValueCollection.cs

获取或设置 NameValueCollection 中具有指定键的项。

public:
 property System::String ^ default[System::String ^] { System::String ^ get(System::String ^ name); void set(System::String ^ name, System::String ^ value); };

public string? this[string? name] { get; set; }

member this.Item(string) : string with get, set

Default Public Property Item(name As String) As String

参数

name

String

要定位的项的 String 键。 键可以是 null。

属性值

String

如果找到了，则为一个 String，它包含与指定键关联的值的列表（用逗号分隔）；否则为 null。

例外

NotSupportedException

该集合是只读的，但此操作尝试修改该集合。

注解

通过此属性，可以使用以下语法来访问集合中的特定元素：myCollection[name]。

如果集合中已存在指定的键，则设置此属性将覆盖具有指定值的现有值列表。 若要将新值追加到现有值列表，请使用 Add 方法。

如果集合中不存在指定的键，则设置此属性将使用指定的键和指定值创建一个新条目。

注意

此属性在以下情况下返回 null ：1) 如果未找到指定的键，则返回;如果找到指定的键并且其关联的值为 null，则返回 2) 。 此属性不区分这两种情况。

C# 语言使用此关键字 (keyword) 来定义索引器，而不是实现 Item[] 属性。 Visual Basic 实现 Item[] 为 默认属性，该属性提供相同的索引功能。

检索或设置与指定键关联的值是 O (n) 操作，其中 n 是值的数目。

另请参阅

• Get
• 执行不区分区域性的字符串操作