ReturnValueNameAttribute Klasa

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Runtime.InteropServices.WindowsRuntime
Zestaw:
System.Runtime.InteropServices.WindowsRuntime.dll
Zestaw:
mscorlib.dll

Określa nazwę zwracanej wartości metody w składniku środowisko wykonawcze systemu Windows.

public ref class ReturnValueNameAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Delegate | System.AttributeTargets.ReturnValue, AllowMultiple=false, Inherited=false)]
public sealed class ReturnValueNameAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Delegate | System.AttributeTargets.ReturnValue, AllowMultiple=false, Inherited=false)>]
type ReturnValueNameAttribute = class
    inherit Attribute
Public NotInheritable Class ReturnValueNameAttribute
Inherits Attribute
Dziedziczenie
Object
Attribute
ReturnValueNameAttribute
Atrybuty
AttributeUsageAttribute

Uwagi

W składniku środowisko wykonawcze systemu Windows wszystkie parametry metody i zwracanej wartości muszą mieć nazwy. Domyślnie Winmdexp.exe (środowisko wykonawcze systemu Windows Metadata Export Tool) daje wartość zwracaną jako "wartość". Jeśli używasz składnika w aplikacji Windows 8.x Store napisanej w języku JavaScript, możesz użyć tej nazwy, aby pobrać wartość zwracaną. Załóżmy na przykład, że składnik definiuje metodę, która ma wartość zwracaną i dwa out parametry (ByRef parametry z atrybutem OutAttribute w Visual Basic):

public static int ComputeAverage([ReadOnlyArray()] int[] input,  
    out int minValue, out int maxValue)  
{  
    …  
}  

Public Shared Function ComputeAverage( _  
        <ReadOnlyArray()> ByVal input As Integer, _  
        <Out()> ByRef minValue As Integer, _  
        <Out()> ByRef maxValue As Integer) As Integer  
    …  
End Function

Po wywołaniu funkcji z poziomu języka JavaScript możesz uzyskać dostęp do wartości zwracanej przy użyciu jej domyślnej nazwy (value):

var data = [5, 13, 23, 37];  
var results = SampleComponent.TestStuff.computeAverage(data);  
var formattedResults = "Min=" + results.minValue + ", Avg=" +   
    results.value + ", Max=" + results.maxValue;

Jeśli masz już parametr o nazwie "value", musisz nadać wartości zwracanej inną nazwę. Możesz też po prostu chcieć użyć bardziej znaczącej nazwy (takiej jak "średnia" w tym przykładzie). ReturnValueNameAttribute Zastosuj atrybut do metody i określ nową nazwę.

[return: ReturnValueName("average")]  
public static int ComputeAverage([ReadOnlyArray()] int[] input,  
    out int minValue, out int maxValue)  
{  
    …  
}  

Public Shared Function ComputeAverage( _  
        <ReadOnlyArray()> ByVal input As Integer, _  
        <Out()> ByRef minValue As Integer, _  
        <Out()> ByRef maxValue As Integer) _  
            As <ReturnValueName("average")> Integer  
    …  
End Function

Konstruktory

ReturnValueNameAttribute(String)

Inicjuje ReturnValueNameAttribute nowe wystąpienie klasy i określa nazwę zwracanej wartości.

Właściwości

Name

Pobiera nazwę, która została określona dla zwracanej wartości metody w składniku środowisko wykonawcze systemu Windows.
TypeId

Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu .

(Odziedziczone po Attribute)

Metody

Equals(Object)

Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi.

(Odziedziczone po Attribute)
GetHashCode()

Zwraca wartość skrótu dla tego wystąpienia.

(Odziedziczone po Attribute)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
IsDefaultAttribute()

Podczas zastępowania w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej.

(Odziedziczone po Attribute)
Match(Object)

Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi.

(Odziedziczone po Attribute)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Jawne implementacje interfejsu

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Pobiera informacje o typie dla obiektu, który może służyć do pobierania informacji o typie dla interfejsu.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1).

(Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt.

(Odziedziczone po Attribute)

Dotyczy

Zobacz też