PropertyValue Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt einen Wert in einem Eigenschaftenspeicher dar (z. B. ein PropertySet-instance).
public ref class PropertyValue abstract sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class PropertyValue final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class PropertyValuePublic Class PropertyValue- Vererbung
- Attribute
Windows-Anforderungen
| Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
| API contract |
Windows.Foundation.FoundationContract (eingeführt in v1.0)
|
Hinweise
PropertyValue stellt den Wertteil einer Eigenschaft dar, die in der Regel über einen Zeichenfolgennamen und einen Wert verfügt. Es gibt mehrere Eigenschaften in einem Eigenschaftensatz, und jede Eigenschaft verfügt möglicherweise über einen anderen Werttyp, sodass die Auflistung vom Standpunkt der Auflistung aus gemischt und nicht stark typisiert ist. Die PropertySet-Klasse und die IPropertySet-Schnittstelle sind vorhandene Schnittstellen oder Implementierungen, die dieses Modell verwenden und einen PropertyValue als Wertteil eines Schlüssel-Wert-Paares verwenden. IPropertySet ist der Typ verschiedener Windows-Runtime Eigenschaften, bei denen das Ziel darin besteht, Ihrer App einen Eigenschaftenbehälter mit Eigenschaften bereitzustellen, die in ihrem Ursprung konzeptionell miteinander verknüpft sind, aber jede Eigenschaft kann (und wird häufig) einen anderen Werttyp verwenden.
Bei Verwendung von anderen Windows-Runtime-APIs und deren Signaturen werden Werte häufig als IPropertyValue-Schnittstelle und nicht als PropertyValue-Typ übergeben.
Zusätzlich zur Darstellung des Werts selbst definiert PropertyValue Hilfsprogrammmethoden, die ein PropertyValue-instance auffüllen. Das Aufrufen dieser Hilfsprogrammmethoden aus App-Code ist ungewöhnlich. Die Methoden erstellen einen boxed-Wert, und in diesem Aspekt instance Eine PropertyValue-Funktion ähnlich dem VARIANT-Konzept von Component Object Model (COM). Jede Methode verfügt über eine übereinstimmende Methode, die ein Array von Werten im Gegensatz zu einem einzelnen Wert erstellt.
Methoden
| CreateBoolean(Boolean) |
Erstellt einen Eigenschaftswert aus einem booleschen Wert. |
| CreateBooleanArray(Boolean[]) |
Erstellt einen Eigenschaftswert aus einem Array boolescher Werte. |
| CreateChar16(Char) |
Erstellt einen Eigenschaftswert aus einem Unicode-Zeichen. |
| CreateChar16Array(Char[]) |
Erstellt einen Eigenschaftswert aus einem Array von Unicode-Zeichen. |
| CreateDateTime(DateTime) |
Erstellt einen Eigenschaftswert aus einem Datums- und Uhrzeitwert. |
| CreateDateTimeArray(DateTime[]) |
Erstellt einen Eigenschaftswert aus einem Array von Datums- und Uhrzeitwerten. |
| CreateDouble(Double) |
Erstellt einen Eigenschaftswert aus einem Gleitkommawert. |
| CreateDoubleArray(Double[]) |
Erstellt einen Eigenschaftswert aus einem Array von Gleitkommawerten. |
| CreateEmpty() |
Erstellt einen leeren Eigenschaftswert. |
| CreateGuid(Guid) |
Erstellt einen Eigenschaftswert aus einer GUID. |
| CreateGuidArray(Guid[]) |
Erstellt einen Eigenschaftswert aus einem Array von GUIDs. |
| CreateInspectable(Object) |
Stellt die Eigenschaftswertdarstellung eines inspizierbaren Objekts bereit. Da es sich bei einem Objekt um einen Verweistyp handelt, ist es auch ein gültiger Eigenschaftswert und muss nicht boxed werden. Stattdessen gibt diese Methode das ohne Änderungen bereitgestellte Objekt zurück. Ein Objekt kann als Eigenschaftswert festgelegt werden, ohne zuerst diese Methode aufzurufen. |
| CreateInspectableArray(Object[]) |
Erstellt einen Eigenschaftswert aus einem Array von prüfbaren Objekten. |
| CreateInt16(Int16) |
Erstellt einen Eigenschaftswert aus einer ganzzahligen Zahl. |
| CreateInt16Array(Int16[]) |
Erstellt einen Eigenschaftswert aus einem Array ganzzahliger Zahlen. |
| CreateInt32(Int32) |
Erstellt einen Eigenschaftswert aus einer ganzzahligen Zahl. |
| CreateInt32Array(Int32[]) |
Erstellt einen Eigenschaftswert aus einem Array ganzzahliger Zahlen. |
| CreateInt64(Int64) |
Erstellt einen Eigenschaftswert aus einer ganzzahligen Zahl. |
| CreateInt64Array(Int64[]) |
Erstellt einen Eigenschaftswert aus einem Array ganzzahliger Zahlen. |
| CreatePoint(Point) |
Erstellt einen Eigenschaftswert aus einer Punktstruktur. |
| CreatePointArray(Point[]) |
Erstellt einen Eigenschaftswert aus einem Array von Punktstrukturen. |
| CreateRect(Rect) |
Erstellt einen Eigenschaftswert aus einer Rechteckstruktur. |
| CreateRectArray(Rect[]) |
Erstellt einen Eigenschaftswert aus einem Array von Rechteckstrukturen. |
| CreateSingle(Single) |
Erstellt einen Eigenschaftswert aus einem Gleitkommawert. |
| CreateSingleArray(Single[]) |
Erstellt einen Eigenschaftswert aus einem Array von Gleitkommawerten. |
| CreateSize(Size) |
Erstellt einen Eigenschaftswert aus einer Größenstruktur. |
| CreateSizeArray(Size[]) |
Erstellt einen Eigenschaftswert aus einem Array von Größenstrukturen. |
| CreateString(String) |
Erstellt einen Eigenschaftswert aus einer Zeichenfolge. |
| CreateStringArray(String[]) |
Erstellt einen Eigenschaftswert aus einem Array von Zeichenfolgen. |
| CreateTimeSpan(TimeSpan) |
Erstellt einen Eigenschaftswert aus einem Zeitintervall. |
| CreateTimeSpanArray(TimeSpan[]) |
Erstellt einen Eigenschaftswert aus einem Array von Zeitintervallen. |
| CreateUInt16(UInt16) |
Erstellt einen Eigenschaftswert aus einer ganzzahligen Zahl ohne Vorzeichen. |
| CreateUInt16Array(UInt16[]) |
Erstellt einen Eigenschaftswert aus einem Array von ganzen Zahlen ohne Vorzeichen. |
| CreateUInt32(UInt32) |
Erstellt einen Eigenschaftswert aus einer ganzzahligen Zahl ohne Vorzeichen. |
| CreateUInt32Array(UInt32[]) |
Erstellt einen Eigenschaftswert aus einem Array von ganzen Zahlen ohne Vorzeichen. |
| CreateUInt64(UInt64) |
Erstellt einen Eigenschaftswert aus einer ganzzahligen Zahl ohne Vorzeichen. |
| CreateUInt64Array(UInt64[]) |
Erstellt einen Eigenschaftswert aus einem Array von ganzen Zahlen ohne Vorzeichen. |
| CreateUInt8(Byte) |
Erstellt einen Eigenschaftswert aus einem Byte. |
| CreateUInt8Array(Byte[]) |
Erstellt einen Eigenschaftswert aus einem Bytearray. |