System.Collections.Specialized.NameObjectCollectionBase.BaseGet 方法 (String)
上一篇：System.Configuration.ConfigurationSectionCollection.BaseGet(Int32) 方法
下一篇：System.Configuration.ConfigurationSectionCollection.BaseGetAllKeys 方法
方法描述
获取 NameObjectCollectionBase 实例中第一个具有指定键的项值。
语法定义(C# System.Collections.Specialized.NameObjectCollectionBase.BaseGet 方法 (String) 的用法)
protected Object BaseGet( string name )
参数/返回值
| 参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
|---|---|---|
| name | System-String | 要获取的项的 String 键。键可以是 null。 |
| 返回值 | System.Object | 如果找到了表示第一个具有指定键的项值的 Object，则为该对象；否则为 null。 |
提示和注释
如果集合包含多个具有指定键的项，则此方法只返回第一项。 若要获取后面具有同一键的项值，请使用枚举数循环访问集合并比较键。
警告
在下列情况中，此方法返回 null：1) 如果未找到指定键；2) 如果找到了指定键，且其关联值为 null。 此方法在这两种情况中没有区别。
此方法的运算复杂度是 O(1)。
System.Collections.Specialized.NameObjectCollectionBase.BaseGet 方法 (String)例子
下面的代码示例使用 BaseGetKey 和 BaseGet 获取特定的键和值。
using System;
using System.Collections;
using System.Collections.Specialized;
public class MyCollection : NameObjectCollectionBase {
private DictionaryEntry _de = new DictionaryEntry();
// Gets a key-and-value pair (DictionaryEntry) using an index.
public DictionaryEntry this[ int index ] {
get {
_de.Key = this.BaseGetKey( index );
_de.Value = this.BaseGet( index );
return( _de );
}
}
// Gets or sets the value associated with the specified key.
public Object this[ String key ] {
get {
return( this.BaseGet( key ) );
}
set {
this.BaseSet( key, value );
}
}
// Adds elements from an IDictionary into the new collection.
public MyCollection( IDictionary d ) {
foreach ( DictionaryEntry de in d ) {
this.BaseAdd( (String) de.Key, de.Value );
}
}
}
public class SamplesNameObjectCollectionBase {
public static void Main() {
// Creates and initializes a new MyCollection instance.
IDictionary d = new ListDictionary();
d.Add( "red", "apple" );
d.Add( "yellow", "banana" );
d.Add( "green", "pear" );
MyCollection myCol = new MyCollection( d );
Console.WriteLine( "Initial state of the collection (Count = {0}):", myCol.Count );
PrintKeysAndValues( myCol );
// Gets specific keys and values.
Console.WriteLine( "The key at index 0 is {0}.", myCol[0].Key );
Console.WriteLine( "The value at index 0 is {0}.", myCol[0].Value );
Console.WriteLine( "The value associated with the key \"green\" is {0}.", myCol["green"] );
}
public static void PrintKeysAndValues( MyCollection myCol ) {
for ( int i = 0; i < myCol.Count; i++ ) {
Console.WriteLine( "[{0}] : {1}, {2}", i, myCol[i].Key, myCol[i].Value );
}
}
}
/*
This code produces the following output.
Initial state of the collection (Count = 3):
[0] : red, apple
[1] : yellow, banana
[2] : green, pear
The key at index 0 is red.
The value at index 0 is apple.
The value associated with the key "green" is pear.
*/
版本信息
.NET Framework 受以下版本支持：4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。
上一篇：System.Configuration.ConfigurationSectionCollection.BaseGet(Int32) 方法
下一篇：System.Configuration.ConfigurationSectionCollection.BaseGetAllKeys 方法