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

Параметры

name
String

Ключ String записи для получения. Ключ может быть null.

Возвращаемое значение

Значение Object первой записи с указанным ключом, если оно найдено; в противном случае null.

Комментарии

Если коллекция содержит несколько записей с указанным ключом, этот метод возвращает только первую запись. Чтобы получить значения последующих записей с тем же ключом, используйте перечислитель для итерации по коллекции и сравнения ключей.

Предостережение

Этот метод возвращается null в следующих случаях: 1) если указанный ключ не найден; и 2) если указанный ключ найден и его связанное значение.null Этот метод не отличается от двух вариантов.

Этот метод является операцией O(1).

См. также раздел

Применяется к