OptionalAttribute Klasa

Definicja

Namespace:

System.Runtime.InteropServices

Zestawów:

netstandard.dll, System.Runtime.InteropServices.dll

Źródło:

OptionalAttribute.cs

Wskazuje, że parametr jest opcjonalny.

public ref class OptionalAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Parameter, Inherited=false)]
public sealed class OptionalAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Parameter, Inherited=false)>]
type OptionalAttribute = class
    inherit Attribute

Public NotInheritable Class OptionalAttribute
Inherits Attribute

Dziedziczenie

Object

Attribute

OptionalAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie kodu pokazano, jak zastosować OptionalAttribute atrybut do parametru metody napisanej w języku C#.

using System;
using System.Runtime.InteropServices;

public class Program
{
    public static void MethodWithOptionalAttribute([Optional] string str)
    {
        Console.WriteLine($"str is null: {str == null}");
    }

    public static void Main()
    {
        MethodWithOptionalAttribute(); // str is null: True
        MethodWithOptionalAttribute("abc"); // str is null: False
    }
}

Uwagi

Ten atrybut można zastosować do parametrów.

Parametry opcjonalne nie są obsługiwane przez wszystkie języki.

OptionalAttribute jest czasami używany w połączeniu z DefaultParameterValueAttribute.

Konstruktorów

Nazwa	Opis
OptionalAttribute()	Inicjuje nowe wystąpienie klasy OptionalAttribute z domyślnymi wartościami.

Właściwości

Nazwa	Opis
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu . (Dziedziczone od Attribute)

Metody

Nazwa	Opis
Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Dziedziczone od Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Dziedziczone od Attribute)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Dziedziczone od Object)
IsDefaultAttribute()	Podczas zastępowania w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Dziedziczone od Attribute)
Match(Object)	Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Dziedziczone od Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Dziedziczone od Object)