AttributeCollection Klasa

Definicja

Reprezentuje kolekcję atrybutów.Represents a collection of attributes.

public ref class AttributeCollection : System::Collections::ICollection
[System.Runtime.InteropServices.ComVisible(true)]
public class AttributeCollection : System.Collections.ICollection
type AttributeCollection = class
    interface ICollection
    interface IEnumerable
Public Class AttributeCollection
Implements ICollection
Dziedziczenie
AttributeCollection
Atrybuty
Implementuje

Przykłady

Pierwszy przykład kodu sprawdza, czy BrowsableAttribute został ustawiony w tej kolekcji.The first code example checks to see whether the BrowsableAttribute has been set in this collection. Drugi przykład kodu pobiera rzeczywistą wartość DescriptionAttribute dla przycisku.The second code example gets the actual value of the DescriptionAttribute for a button. Oba przykłady wymagają, button1 aby textBox1 i zostały utworzone w formularzu.Both examples require that button1 and textBox1 have been created on a form. W przypadku używania atrybutów Sprawdź, czy atrybut został ustawiony, lub uzyskaj dostęp do jego wartości.When using attributes, verify that an attribute has been set, or access its value.

private:
   void ContainsAttribute()
   {
      // Creates a new collection and assigns it the attributes for button1.
      AttributeCollection^ attributes;
      attributes = TypeDescriptor::GetAttributes( button1 );
      
      // Sets an Attribute to the specific attribute.
      BrowsableAttribute^ myAttribute = BrowsableAttribute::Yes;

      if ( attributes->Contains( myAttribute ) )
      {
         textBox1->Text = "button1 has a browsable attribute.";
      }
      else
      {
         textBox1->Text = "button1 does not have a browsable attribute.";
      }
   }
private void ContainsAttribute() {
    // Creates a new collection and assigns it the attributes for button1.
    AttributeCollection attributes;
    attributes = TypeDescriptor.GetAttributes(button1);
 
    // Sets an Attribute to the specific attribute.
    BrowsableAttribute myAttribute = BrowsableAttribute.Yes;
 
    if (attributes.Contains(myAttribute))
       textBox1.Text = "button1 has a browsable attribute.";
    else
       textBox1.Text = "button1 does not have a browsable attribute.";
 }
Private Sub ContainsAttribute()
    ' Creates a new collection and assigns it the attributes for button1.
    Dim attributes As AttributeCollection
    attributes = TypeDescriptor.GetAttributes(button1)
    
    ' Sets an Attribute to the specific attribute.
    Dim myAttribute As BrowsableAttribute = BrowsableAttribute.Yes
    
    If attributes.Contains(myAttribute) Then
        textBox1.Text = "button1 has a browsable attribute."
    Else
        textBox1.Text = "button1 does not have a browsable attribute."
    End If
End Sub
private:
   void GetAttributeValue()
   {
      // Creates a new collection and assigns it the attributes for button1.
      AttributeCollection^ attributes;
      attributes = TypeDescriptor::GetAttributes( button1 );
      
      // Gets the designer attribute from the collection.
      DesignerAttribute^ myDesigner;
      myDesigner = (DesignerAttribute^)(attributes[DesignerAttribute::typeid]);
      
      // Prints the value of the attribute in a text box.
      textBox1->Text = myDesigner->DesignerTypeName;
   }
private void GetAttributeValue() {
    // Creates a new collection and assigns it the attributes for button1.
    AttributeCollection attributes;
    attributes = TypeDescriptor.GetAttributes(button1);
 
    // Gets the designer attribute from the collection.
    DesignerAttribute myDesigner; 
    myDesigner = (DesignerAttribute)attributes[typeof(DesignerAttribute)];
 
    // Prints the value of the attribute in a text box.
    textBox1.Text = myDesigner.DesignerTypeName;
 }
Private Sub GetAttributeValue()
    ' Creates a new collection and assigns it the attributes for button1.
    Dim attributes As AttributeCollection
    attributes = TypeDescriptor.GetAttributes(button1)
    
    ' Gets the designer attribute from the collection.
    Dim myDesigner As DesignerAttribute
    myDesigner = CType(attributes(GetType(DesignerAttribute)), DesignerAttribute)
    
    ' Prints the value of the attribute in a text box.
    textBox1.Text = myDesigner.DesignerTypeName
End Sub

Uwagi

AttributeCollection Klasa jest tylko do odczytu; nie implementuje metod w celu dodawania lub usuwania atrybutów.The AttributeCollection class is read-only; it does not implement methods to add or remove attributes. Aby zaimplementować te metody, należy najpierw dziedziczyć z tej klasy.You must inherit from this class to implement these methods.

Count Użyj właściwości, aby znaleźć liczbę atrybutów istniejących w kolekcji.Use the Count property to find the number of attributes that exist in the collection.

Można również użyć metod tej klasy do wysyłania zapytań do kolekcji o jej zawartości.You can also use the methods of this class to query the collection about its contents. Wywołaj Contains metodę, aby upewnić się, że określony atrybut lub tablica atrybutów istnieje w kolekcji.Call the Contains method to verify that a specified attribute or attribute array exists in the collection. Wywołaj Matches metodę, aby sprawdzić, czy określony atrybut lub tablica atrybutów istnieje w kolekcji i czy wartości określonych atrybutów są takie same jak wartości w kolekcji.Call the Matches method to verify that a specified attribute or array of attributes exists in the collection, and that the values of the specified attributes are the same as the values in the collection.

Chociaż większość atrybutów ma wartości domyślne, wartości domyślne nie są wymagane.While most attributes have default values, default values are not required. Jeśli atrybut nie ma wartości domyślnej, null jest zwracana z właściwości indeksowanej, która przyjmuje typ.If an attribute has no default value, null is returned from the indexed property that takes a type. Podczas definiowania własnych atrybutów można zadeklarować wartość domyślną, dostarczając konstruktora, który nie przyjmuje argumentów ani nie definiuje publicznego pola statycznego typu atrybutu o nazwie "default".When defining your own attributes, you can declare a default value by either providing a constructor that takes no arguments, or defining a public static field of your attribute type named "Default".

Konstruktory

AttributeCollection()

Inicjuje nowe wystąpienie klasy AttributeCollection klasy.Initializes a new instance of the AttributeCollection class.

AttributeCollection(Attribute[])

Inicjuje nowe wystąpienie klasy AttributeCollection klasy.Initializes a new instance of the AttributeCollection class.

Pola

Empty

Określa pustą kolekcję, której można użyć zamiast tworzenia nowej.Specifies an empty collection that you can use, rather than creating a new one. To pole jest tylko do odczytu.This field is read-only.

Właściwości

Attributes

Pobiera kolekcję atrybutów.Gets the attribute collection.

Count

Pobiera liczbę atrybutów.Gets the number of attributes.

Item[Int32]

Pobiera atrybut o określonym numerze indeksu.Gets the attribute with the specified index number.

Item[Type]

Pobiera atrybut o określonym typie.Gets the attribute with the specified type.

Metody

Contains(Attribute)

Określa, czy ta kolekcja atrybutów ma określony atrybut.Determines whether this collection of attributes has the specified attribute.

Contains(Attribute[])

Określa, czy ta kolekcja atrybutów zawiera wszystkie określone atrybuty w tablicy atrybutów.Determines whether this attribute collection contains all the specified attributes in the attribute array.

CopyTo(Array, Int32)

Kopiuje kolekcję do tablicy, rozpoczynając od określonego indeksu.Copies the collection to an array, starting at the specified index.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
FromExisting(AttributeCollection, Attribute[])

Tworzy nowy AttributeCollection na podstawie istniejącego AttributeCollection.Creates a new AttributeCollection from an existing AttributeCollection.

GetDefaultAttribute(Type)

Zwraca wartość domyślną Attribute danego Typeelementu.Returns the default Attribute of a given Type.

GetEnumerator()

Pobiera moduł wyliczający dla tej kolekcji.Gets an enumerator for this collection.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
Matches(Attribute)

Określa, czy określony atrybut jest taki sam jak atrybut w kolekcji.Determines whether a specified attribute is the same as an attribute in the collection.

Matches(Attribute[])

Określa, czy atrybuty w określonej tablicy są takie same jak atrybuty w kolekcji.Determines whether the attributes in the specified array are the same as the attributes in the collection.

MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

ICollection.Count

Pobiera liczbę elementów zawartych w kolekcji.Gets the number of elements contained in the collection.

ICollection.IsSynchronized

Pobiera wartość wskazującą, czy dostęp do kolekcji jest synchronizowany (bezpieczny wątkowo).Gets a value indicating whether access to the collection is synchronized (thread-safe).

ICollection.SyncRoot

Pobiera obiekt, który może służyć do synchronizowania dostępu do kolekcji.Gets an object that can be used to synchronize access to the collection.

IEnumerable.GetEnumerator()

IEnumerator Zwraca wartośćIDictionarydla.Returns an IEnumerator for the IDictionary.

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy IEnumerable określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerable KonwertujeIQueryabledo.Converts an IEnumerable to an IQueryable.

Dotyczy

Zobacz też