ReturnValueNameAttribute Klasa

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices.WindowsRuntime

Zestaw:

System.Runtime.InteropServices.WindowsRuntime.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)

Zobacz też

• Tworzenie składników środowisko wykonawcze systemu Windows w językach C# i Visual Basic