ReturnValueNameAttribute Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Egy metódus visszatérési értékének nevét adja meg egy Windows-futtatókörnyezet összetevőben.
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
- Öröklődés
- Attribútumok
Megjegyzések
Egy Windows-futtatókörnyezet összetevőben egy metódus összes paraméterének és a visszatérési értéknek neveket kell tartalmaznia. Alapértelmezés szerint Winmdexp.exe (Windows-futtatókörnyezet Metaadat-exportálási eszköz) a visszatérési értéket "value" néven adja meg. Ha egy JavaScriptben írt Windows 8.x Áruházbeli alkalmazásban használ összetevőt, ezzel a névvel lekérheti a visszatérési értéket. Tegyük fel például, hogy egy összetevő olyan metódust határoz meg, amely visszatérési értékkel és két out paraméterrel rendelkezik (ByRef paraméterek a OutAttribute attribútummal a 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
Amikor meghívja a függvényt a JavaScriptből, a visszatérési értéket az alapértelmezett nevével érheti el (value):
var data = [5, 13, 23, 37];
var results = SampleComponent.TestStuff.computeAverage(data);
var formattedResults = "Min=" + results.minValue + ", Avg=" +
results.value + ", Max=" + results.maxValue;
Ha már rendelkezik "value" nevű paraméterrel, a visszatérési értéket más néven kell megadnia. Vagy egyszerűen csak egy értelmesebb nevet szeretne használni (például az "átlagot" ebben a példában). Alkalmazza az ReturnValueNameAttribute attribútumot a metódusra, és adjon meg egy új nevet.
[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
Konstruktorok
| Name | Description |
|---|---|
| ReturnValueNameAttribute(String) |
Inicializálja az ReturnValueNameAttribute osztály új példányát, és megadja a visszatérési érték nevét. |
Tulajdonságok
| Name | Description |
|---|---|
| Name |
Lekéri a metódus visszatérési értékéhez megadott nevet egy Windows-futtatókörnyezet összetevőben. |
| TypeId |
Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute) |
Metódusok
| Name | Description |
|---|---|
| Equals(Object) |
Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal. (Öröklődés forrása Attribute) |
| GetHashCode() |
A példány kivonatkódját adja vissza. (Öröklődés forrása Attribute) |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| IsDefaultAttribute() |
Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute) |
| Match(Object) |
Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute) |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |
Explicit interfész-implementációk
| Name | Description |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Névkészletet képez le a küldési azonosítók megfelelő készletére. (Öröklődés forrása Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Lekéri egy objektum típusadatait, amelyek a felület típusadatainak lekérésére használhatók. (Öröklődés forrása Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Lekéri az objektumok által biztosított típusinformációs felületek számát (0 vagy 1). (Öröklődés forrása Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Hozzáférést biztosít az objektumok által közzétett tulajdonságokhoz és metódusokhoz. (Öröklődés forrása Attribute) |
A következőre érvényes:
Lásd még
Összetevők létrehozása Windows-futtatókörnyezet c# és Visual Basic