(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

ReadOnlyArrayAttribute-Klasse

.NET Framework 4.5

Bei Anwendung auf einen Array-Parameter in einem Windows-Runtime Komponente, gibt an, dass der Inhalt des Arrays, die an diesen Parameter übergeben wird nur für die Eingabe verwendet werden. Der Aufrufer erwartet, dass das Array, das durch den Aufruf nicht geändert werden. Finden Sie im Abschnitt Hinweise, wichtige Informationen zum Anrufer, die in verwaltetem Code.

System.Object
  System.Attribute
    System.Runtime.InteropServices.WindowsRuntime.ReadOnlyArrayAttribute

Namespace:  System.Runtime.InteropServices.WindowsRuntime
Assembly:  mscorlib (in mscorlib.dll)
[AttributeUsageAttribute(AttributeTargets.Parameter, Inherited = false, AllowMultiple = false)]
public sealed class ReadOnlyArrayAttribute : Attribute

Der ReadOnlyArrayAttribute-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeReadOnlyArrayAttributeInitialisiert eine neue Instanz der ReadOnlyArrayAttribute-Klasse.
Zum Seitenanfang
  NameBeschreibung
Öffentliche EigenschaftTypeIdBei Implementierung in einer abgeleiteten Klasse wird ein eindeutiger Bezeichner für dieses Attribute abgerufen. (Von Attribute geerbt.)
Zum Seitenanfang
  NameBeschreibung
Öffentliche MethodeEqualsInfrastruktur. Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Von Attribute geerbt.)
Öffentliche MethodeGetHashCodeGibt den Hashcode für diese Instanz zurück. (Von Attribute geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeIsDefaultAttributeBeim Überschreiben in einer abgeleiteten Klasse wird angegeben, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Von Attribute geerbt.)
Öffentliche MethodeMatchBeim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Von Attribute geerbt.)
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang
  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.GetIDsOfNamesOrdnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Von Attribute geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.GetTypeInfoRuft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Von Attribute geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.GetTypeInfoCountRuft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Von Attribute geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.InvokeStellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Von Attribute geerbt.)
Zum Seitenanfang

Wenn ein Arrayparameter in Ihrem Windows-Runtime Komponente wird als Wert übergeben (ByVal in Visual Basic), müssen Sie eines der folgenden Attribute zu:

  • Anwenden der ReadOnlyArrayAttribute Attribut, wenn Sie beabsichtigen, den Inhalt des Arrays, das für die Eingabe nur verwendet werden.

  • Anwenden der WriteOnlyArrayAttribute Attribut, wenn Sie beabsichtigen, den Inhalt des Arrays, das für die Ausgabe nur verwendet werden, (d. h. die Methode den Inhalt des Arrays legt aber nicht lesen).

Beide Attribute anwenden, um einen Parameter verursacht einen Fehler. Weitere Informationen, einschließlich des Standardmusters für in ein Array Änderungen, finden Sie unter übergeben von Arrays an eine Laufzeitkomponente für Windows in der Windows-Entwicklercenter.

Wichtiger HinweisWichtig

Parameter, die die ReadOnlyArrayAttribute Attribut Verhalten sich unterschiedlich, je nachdem, ob der Aufrufer in systemeigenem Code oder verwaltetem Code geschrieben ist. Wenn der Aufrufer systemeigenen Code (JavaScript oder Komponentenerweiterungen für Visual C++), das Array kopiert wird, wenn der Aufruf der Application binary Interface (ABI) übertritt. Elemente werden bei Bedarf konvertiert. Daher etwaige unvorhersehbare Änderungen die Methode ist eine Eingabe nicht Array für den Aufrufer sichtbar sind.

Wenn der Aufrufer verwaltet wird Code, der das Array wird nicht kopiert. Das ursprüngliche Array steht für die aufgerufene Methode, wie es in jedem Methodenaufruf in der.NET Framework. Array-Inhalt sind in änderbar.NET Framework-Code, so dass die Methode in das Array macht Änderungen an den Aufrufer sichtbar sind. Dies ist wichtig, da sie Komponententests für geschrieben wirkt sich eine Windows-Runtime Komponente. Wenn die Tests in verwaltetem Code geschrieben sind, erscheint der Inhalt eines Arrays während des Testens änderbar sein.

Anwenden dieses Attributs auf einen Parameter mit dem InAttribute oder OutAttribute Attribut verursacht einen Fehler, wenn das Modul exportiert wird. Anwenden des Attributs auf ein out Parameter führt auch zu einem Fehler.

.NET Framework

Unterstützt in: 4.5

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Vielen Dank für Ihr Feedback.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft. Alle Rechte vorbehalten.