NameObjectCollectionBase.BaseGet Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение указанной записи из экземпляра NameObjectCollectionBase .
Перегрузки
| Имя | Описание |
|---|---|
| BaseGet(Int32) |
Возвращает значение записи по указанному индексу экземпляра NameObjectCollectionBase . |
| BaseGet(String) |
Возвращает значение первой записи с указанным ключом из экземпляра NameObjectCollectionBase . |
Примеры
В следующем примере кода используются и 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.
*/
Imports System.Collections
Imports System.Collections.Specialized
Public Class MyCollection
Inherits NameObjectCollectionBase
Private _de As New DictionaryEntry()
' Gets a key-and-value pair (DictionaryEntry) using an index.
Default Public ReadOnly Property Item(index As Integer) As DictionaryEntry
Get
_de.Key = Me.BaseGetKey(index)
_de.Value = Me.BaseGet(index)
Return _de
End Get
End Property
' Gets or sets the value associated with the specified key.
Default Public Property Item(key As [String]) As [Object]
Get
Return Me.BaseGet(key)
End Get
Set
Me.BaseSet(key, value)
End Set
End Property
' Adds elements from an IDictionary into the new collection.
Public Sub New(d As IDictionary)
Dim de As DictionaryEntry
For Each de In d
Me.BaseAdd(CType(de.Key, [String]), de.Value)
Next de
End Sub
End Class
Public Class SamplesNameObjectCollectionBase
Public Shared Sub Main()
' Creates and initializes a new MyCollection instance.
Dim d = New ListDictionary()
d.Add("red", "apple")
d.Add("yellow", "banana")
d.Add("green", "pear")
Dim myCol As 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"))
End Sub
Public Shared Sub PrintKeysAndValues(myCol As MyCollection)
Dim i As Integer
For i = 0 To myCol.Count - 1
Console.WriteLine("[{0}] : {1}, {2}", i, myCol(i).Key, myCol(i).Value)
Next i
End Sub
End Class
'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.
BaseGet(Int32)
- Исходный код:
- NameObjectCollectionBase.cs
- Исходный код:
- NameObjectCollectionBase.cs
- Исходный код:
- NameObjectCollectionBase.cs
- Исходный код:
- NameObjectCollectionBase.cs
- Исходный код:
- NameObjectCollectionBase.cs
Возвращает значение записи по указанному индексу экземпляра NameObjectCollectionBase .
protected:
System::Object ^ BaseGet(int index);
protected object BaseGet(int index);
protected object? BaseGet(int index);
member this.BaseGet : int -> obj
Protected Function BaseGet (index As Integer) As Object
Параметры
- index
- Int32
Отсчитываемый от нуля индекс значения.
Возвращаемое значение
Объект, Object представляющий значение записи по указанному индексу.
Исключения
index находится вне допустимого диапазона индексов для коллекции.
Комментарии
Этот метод является операцией O(1).
Применяется к
BaseGet(String)
- Исходный код:
- NameObjectCollectionBase.cs
- Исходный код:
- NameObjectCollectionBase.cs
- Исходный код:
- NameObjectCollectionBase.cs
- Исходный код:
- NameObjectCollectionBase.cs
- Исходный код:
- NameObjectCollectionBase.cs
Возвращает значение первой записи с указанным ключом из экземпляра NameObjectCollectionBase .
protected:
System::Object ^ BaseGet(System::String ^ name);
protected object BaseGet(string name);
protected object? BaseGet(string? name);
member this.BaseGet : string -> obj
Protected Function BaseGet (name As String) As Object
Параметры
Возвращаемое значение
Значение Object первой записи с указанным ключом, если оно найдено; в противном случае null.
Комментарии
Если коллекция содержит несколько записей с указанным ключом, этот метод возвращает только первую запись. Чтобы получить значения последующих записей с тем же ключом, используйте перечислитель для итерации по коллекции и сравнения ключей.
Предостережение
Этот метод возвращается null в следующих случаях: 1) если указанный ключ не найден; и 2) если указанный ключ найден и его связанное значение.null Этот метод не отличается от двух вариантов.
Этот метод является операцией O(1).