ReturnValueNameAttribute Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Runtime.InteropServices.WindowsRuntime
Assembly:
System.Runtime.InteropServices.WindowsRuntime.dll
Assembly:
mscorlib.dll

Specifica il nome del valore restituito di un metodo in un componente Windows Runtime.

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
Ereditarietà
Object
Attribute
ReturnValueNameAttribute
Attributi
AttributeUsageAttribute

Commenti

In un Windows runtime, tutti i parametri di un metodo e il valore restituito devono avere nomi. Per impostazione predefinita, Winmdexp.exe (Windows Runtime Metadata Export Tool) assegna al valore restituito il nome "value". Quando si usa un componente in un'app Windows 8.x Store scritta in JavaScript, è possibile usare questo nome per recuperare il valore restituito. Si supponga, ad esempio, che un componente defini un metodo con un valore restituito e due parametri ( parametri con out ByRef l'attributo in OutAttribute 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

Quando si chiama la funzione da JavaScript, è possibile accedere al valore restituito in base al nome predefinito ( value ):

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

È necessario assegnare al valore restituito un nome diverso se è già presente un parametro denominato "value". Oppure si potrebbe semplicemente usare un nome più significativo, ad esempio "average" in questo esempio. Applicare ReturnValueNameAttribute l'attributo al metodo e specificare un nuovo nome.

[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

Costruttori

ReturnValueNameAttribute(String)

Inizializza una nuova istanza della classe ReturnValueNameAttribute e specifica il nome del valore restituito.

Proprietà

Name

Ottiene il nome specificato per il valore restituito di un metodo in un Windows Runtime.
TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.

(Ereditato da Attribute)

Metodi

Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.

(Ereditato da Attribute)
GetHashCode()

Restituisce il codice hash per l'istanza.

(Ereditato da Attribute)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.

(Ereditato da Attribute)
Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

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

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.

(Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).

(Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.

(Ereditato da Attribute)

Si applica a

Vedi anche