WriteOnlyArrayAttribute Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Wanneer deze wordt toegepast op een matrixparameter in een Windows Runtime-onderdeel, geeft u aan dat de inhoud van een matrix die wordt doorgegeven aan die parameter alleen wordt gebruikt voor uitvoer. De aanroeper garandeert niet dat de inhoud wordt geïnitialiseerd en de aangeroepen methode mag de inhoud niet lezen.
public ref class WriteOnlyArrayAttribute sealed : Attribute[System.AttributeUsage(System.AttributeTargets.Parameter, AllowMultiple=false, Inherited=false)]
public sealed class WriteOnlyArrayAttribute : Attribute[<System.AttributeUsage(System.AttributeTargets.Parameter, AllowMultiple=false, Inherited=false)>]
type WriteOnlyArrayAttribute = class
inherit AttributePublic NotInheritable Class WriteOnlyArrayAttribute
Inherits Attribute- Overname
- Kenmerken
Opmerkingen
Als een matrixparameter in uw Windows Runtime-onderdeel wordt doorgegeven door een waarde (ByVal in Visual Basic), moet u er een van de volgende kenmerken op toepassen:
Pas het ReadOnlyArrayAttribute kenmerk toe als u de inhoud van de matrix alleen wilt gebruiken voor invoer.
Pas het WriteOnlyArrayAttribute kenmerk toe als u van plan bent de inhoud van de matrix alleen te gebruiken voor uitvoer (de methode stelt de inhoud van de matrix in, maar leest deze niet).
Het toepassen van beide kenmerken op een parameter veroorzaakt een fout. Zie Passing-matrices naar een Windows Runtime-onderdeel in het Windows Dev Center voor meer informatie, waaronder het standaardpatroon voor het aanbrengen van wijzigingen in een matrix.
Important
Parameters met het WriteOnlyArrayAttribute kenmerk gedragen zich anders, afhankelijk van of de aanroeper is geschreven in systeemeigen code of beheerde code. Als de aanroeper systeemeigen code is (JavaScript- of Visual C++-onderdeelextensies), kan de aangeroepen methode geen veronderstellingen maken over de inhoud van de oorspronkelijke matrix. De matrix die de methode ontvangt, kan bijvoorbeeld niet worden geïnitialiseerd of standaardwaarden bevatten. De methode wordt verwacht de waarden van alle elementen in de matrix in te stellen.
Als de aanroeper beheerde code is, wordt de oorspronkelijke matrix van de aanroeper doorgegeven aan de aangeroepen methode, zoals in een methode-aanroep in het .NET Framework. Matrixinhoud kan worden gedempt in beheerde code, zodat de methode deze waarden selectief kan lezen en wijzigen. Dit is belangrijk om te onthouden omdat dit van invloed is op eenheidstests die zijn geschreven voor een Windows Runtime-onderdeel. Als de tests in beheerde code zijn geschreven, lijkt de inhoud van een matrix tijdens het testen veranderlijk te zijn en zijn de resultaten waarschijnlijk anders als de methode later wordt aangeroepen vanuit systeemeigen code.
Het toepassen van dit kenmerk op een out parameter of op een parameter met het InAttribute kenmerk veroorzaakt een fout wanneer de module wordt geëxporteerd. Het kenmerk toepassen op een parameter met het kenmerk OutAttribute veroorzaakt een fout, tenzij de parameter ook de Visual Basic ByRef modifier heeft. In dat geval is het kenmerk redundant maar toegestaan.
Constructors
| Name | Description |
|---|---|
| WriteOnlyArrayAttribute() |
Initialiseert een nieuw exemplaar van de WriteOnlyArrayAttribute klasse. |
Eigenschappen
| Name | Description |
|---|---|
| TypeId |
Wanneer deze wordt geïmplementeerd in een afgeleide klasse, krijgt u Attributehiervoor een unieke id. (Overgenomen van Attribute) |
Methoden
| Name | Description |
|---|---|
| Equals(Object) |
Retourneert een waarde die aangeeft of dit exemplaar gelijk is aan een opgegeven object. (Overgenomen van Attribute) |
| GetHashCode() |
Retourneert de hash-code voor dit exemplaar. (Overgenomen van Attribute) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| IsDefaultAttribute() |
Wanneer deze wordt overschreven in een afgeleide klasse, geeft u aan of de waarde van dit exemplaar de standaardwaarde is voor de afgeleide klasse. (Overgenomen van Attribute) |
| Match(Object) |
Wanneer deze wordt overschreven in een afgeleide klasse, wordt een waarde geretourneerd die aangeeft of dit exemplaar gelijk is aan een opgegeven object. (Overgenomen van Attribute) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
Expliciete interface-implementaties
| Name | Description |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Hiermee wordt een set namen toegewezen aan een bijbehorende set verzend-id's. (Overgenomen van Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Hiermee haalt u de typegegevens voor een object op, die kan worden gebruikt om de typegegevens voor een interface op te halen. (Overgenomen van Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Hiermee wordt het aantal type-informatieinterfaces opgehaald dat een object biedt (0 of 1). (Overgenomen van Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Biedt toegang tot eigenschappen en methoden die door een object worden weergegeven. (Overgenomen van Attribute) |