NameObjectCollectionBase.BaseGet Metoda

Definicja

Przestrzeń nazw:

System.Collections.Specialized

Zestaw:

System.Collections.Specialized.dll

Pobiera wartość określonego wpisu z NameObjectCollectionBase wystąpienia.

Przeciążenia

BaseGet(Int32)	Pobiera wartość wpisu w określonym indeksie NameObjectCollectionBase wystąpienia.
BaseGet(String)	Pobiera wartość pierwszego wpisu z określonym kluczem NameObjectCollectionBase z wystąpienia.

Przykłady

W poniższym przykładzie kodu użyto instrukcji BaseGetKey i BaseGet , aby uzyskać określone klucze i wartości.

C#

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.

*/

BaseGet(Int32)

Źródło:

NameObjectCollectionBase.cs

Pobiera wartość wpisu w określonym indeksie NameObjectCollectionBase wystąpienia.

C#

protected object? BaseGet (int index);

Parametry

index

Int32

Indeks zerowy wartości do pobrania.

Zwraca

Object

Element Object reprezentujący wartość wpisu w określonym indeksie.

Wyjątki

ArgumentOutOfRangeException

index znajduje się poza prawidłowym zakresem indeksów dla kolekcji.

Uwagi

Ta metoda jest operacją O(1).

BaseGet(String)

Źródło:

NameObjectCollectionBase.cs

Pobiera wartość pierwszego wpisu z określonym kluczem NameObjectCollectionBase z wystąpienia.

C#

protected object? BaseGet (string? name);

Parametry

name

String

Klucz String wpisu do pobrania. Kluczem może być null.

Zwraca

Object

ObiektObject, który reprezentuje wartość pierwszego wpisu z określonym kluczem, jeśli zostanie znaleziony; w przeciwnym razie . null

Uwagi

Jeśli kolekcja zawiera wiele wpisów z określonym kluczem, ta metoda zwraca tylko pierwszy wpis. Aby uzyskać wartości kolejnych wpisów z tym samym kluczem, użyj modułu wyliczającego do iterowania po kolekcji i porównywania kluczy.

Przestroga

Ta metoda zwraca null wartość w następujących przypadkach: 1), jeśli określony klucz nie zostanie znaleziony; i 2) jeśli określony klucz zostanie znaleziony, a jego skojarzona wartość to null. Ta metoda nie rozróżnia dwóch przypadków.

Ta metoda jest operacją O(1).

Zobacz też

• GetEnumerator()