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 języka JavaScript możesz uzyskać dostęp do zwracanej wartości przy użyciu jego 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;  

Należy podać wartość zwracaną inną nazwę, jeśli masz już parametr o nazwie "value". 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 wartości zwracanej metody w składniku środowisko wykonawcze systemu Windows.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego elementu Attribute. (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 bieżące wystąpienie. (Odziedziczone po Object)
IsDefaultAttribute()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	W przypadku zastąpienia 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ęzyku C# i Visual Basic