ReturnValueNameAttribute Kelas

Definisi

Ruang nama:

System.Runtime.InteropServices.WindowsRuntime

Rakitan:

System.Runtime.InteropServices.WindowsRuntime.dll

Menentukan nama nilai pengembalian metode dalam komponen 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

Warisan

Object

Attribute

ReturnValueNameAttribute

Atribut

AttributeUsageAttribute

Keterangan

Dalam komponen Windows Runtime, semua parameter metode dan nilai yang dikembalikan harus memiliki nama. Secara default, Winmdexp.exe (Alat Ekspor Metadata Runtime Windows) memberikan nilai pengembalian nama "nilai". Saat Anda menggunakan komponen di aplikasi Windows 8.x Store yang ditulis dalam JavaScript, Anda dapat menggunakan nama ini untuk mengambil nilai pengembalian. Misalnya, komponen mendefinisikan metode yang memiliki nilai pengembalian dan dua out parameter (ByRef parameter dengan OutAttribute atribut di 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  

Saat Anda memanggil fungsi dari JavaScript, Anda dapat mengakses nilai pengembalian dengan nama defaultnya (value):

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

Anda harus memberi nilai pengembalian nama yang berbeda jika Anda sudah memiliki parameter bernama "value". Atau Anda mungkin hanya ingin menggunakan nama yang lebih bermakna (seperti "rata-rata" dalam contoh ini). Terapkan atribut ke ReturnValueNameAttribute metode Anda dan tentukan nama baru.

[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  

Konstruktor

ReturnValueNameAttribute(String)

Menginisialisasi instans ReturnValueNameAttribute baru kelas, dan menentukan nama nilai yang dikembalikan.

Properti

Name	Mendapatkan nama yang ditentukan untuk nilai pengembalian metode dalam komponen Windows Runtime.
TypeId	Ketika diimplementasikan di kelas turunan, mendapatkan pengidentifikasi unik untuk ini Attribute. (Diperoleh dari Attribute)

Metode

Equals(Object)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari Attribute)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
IsDefaultAttribute()	Ketika ditimpa di kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan. (Diperoleh dari Attribute)
Match(Object)	Saat ditimpa di kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Membuat Komponen Windows Runtime di C# dan Visual Basic