PropertyValue Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta un valore in un archivio delle proprietà, ad esempio un'istanza di PropertySet .
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- Ereditarietà
- Attributi
Requisiti Windows
| Famiglia di dispositivi |
Windows 10 (è stato introdotto in 10.0.10240.0)
|
| API contract |
Windows.Foundation.FoundationContract (è stato introdotto in v1.0)
|
Commenti
PropertyValue rappresenta la parte del valore di una proprietà che in genere ha un nome stringa e un valore. Esistono più proprietà in un set di proprietà e ogni proprietà ha potenzialmente un tipo di valore diverso, quindi dal punto di vista di una raccolta la raccolta è mista, non fortemente tipizzata. La classe PropertySet e l'interfaccia IPropertySet sono interfacce o implementazioni esistenti che usano questo modello e usano PropertyValue come parte del valore di una coppia chiave-valore. IPropertySet è il tipo di varie proprietà Windows Runtime in cui l'obiettivo è quello di fornire all'app un contenitore di proprietà di proprietà correlate concettualmente nell'origine, ma ogni proprietà potrebbe (e spesso fa) usare un tipo di valore diverso.
Se usato da altre API Windows Runtime e dalle relative firme, i valori vengono spesso passati come interfaccia IPropertyValue anziché come tipo PropertyValue.
Oltre a rappresentare il valore stesso, PropertyValue definisce i metodi di utilità che popolano un'istanza PropertyValue. La chiamata di questi metodi di utilità dal codice dell'app non è comune. I metodi creano un valore boxed e in questo aspetto un'istanza PropertyValue funziona in modo analogo al concetto VARIANT di Component Object Model (COM). Ogni metodo ha un metodo corrispondente che crea una matrice di valori anziché un singolo valore.
Metodi
| CreateBoolean(Boolean) |
Crea un valore di proprietà da un valore booleano. |
| CreateBooleanArray(Boolean[]) |
Crea un valore della proprietà da una matrice di valori booleani. |
| CreateChar16(Char) |
Crea un valore della proprietà da un carattere Unicode. |
| CreateChar16Array(Char[]) |
Crea un valore della proprietà da una matrice di caratteri Unicode. |
| CreateDateTime(DateTime) |
Crea un valore della proprietà da un valore di data e ora. |
| CreateDateTimeArray(DateTime[]) |
Crea un valore della proprietà da una matrice di valori di data e ora. |
| CreateDouble(Double) |
Crea un valore della proprietà da un valore a virgola mobile. |
| CreateDoubleArray(Double[]) |
Crea un valore della proprietà da una matrice di valori a virgola mobile. |
| CreateEmpty() |
Crea un valore di proprietà vuoto. |
| CreateGuid(Guid) |
Crea un valore di proprietà da un GUID. |
| CreateGuidArray(Guid[]) |
Crea un valore della proprietà da una matrice di GUIDs. |
| CreateInspectable(Object) |
Fornisce la rappresentazione del valore della proprietà di un oggetto ispezionabile. Poiché un oggetto è un tipo riferimento, è anche un valore di proprietà valido e non deve essere sottoposto a boxing. Questo metodo restituisce invece l'oggetto fornito senza modifiche. Un oggetto può essere impostato come valore di proprietà senza prima chiamare questo metodo. |
| CreateInspectableArray(Object[]) |
Crea un valore della proprietà da una matrice di oggetti ispezionabili. |
| CreateInt16(Int16) |
Crea un valore della proprietà da un numero intero. |
| CreateInt16Array(Int16[]) |
Crea un valore della proprietà da una matrice di numeri interi. |
| CreateInt32(Int32) |
Crea un valore della proprietà da un numero intero. |
| CreateInt32Array(Int32[]) |
Crea un valore della proprietà da una matrice di numeri interi. |
| CreateInt64(Int64) |
Crea un valore della proprietà da un numero intero. |
| CreateInt64Array(Int64[]) |
Crea un valore della proprietà da una matrice di numeri interi. |
| CreatePoint(Point) |
Crea un valore di proprietà da una struttura punto. |
| CreatePointArray(Point[]) |
Crea un valore della proprietà da una matrice di strutture di punti. |
| CreateRect(Rect) |
Crea un valore della proprietà da una struttura rettangolo. |
| CreateRectArray(Rect[]) |
Crea un valore della proprietà da una matrice di strutture rettangolo. |
| CreateSingle(Single) |
Crea un valore della proprietà da un valore a virgola mobile. |
| CreateSingleArray(Single[]) |
Crea un valore della proprietà da una matrice di valori a virgola mobile. |
| CreateSize(Size) |
Crea un valore della proprietà da una struttura di dimensioni. |
| CreateSizeArray(Size[]) |
Crea un valore della proprietà da una matrice di strutture di dimensioni. |
| CreateString(String) |
Crea un valore di proprietà da una stringa. |
| CreateStringArray(String[]) |
Crea un valore della proprietà da una matrice di stringhe. |
| CreateTimeSpan(TimeSpan) |
Crea un valore della proprietà da un intervallo di tempo. |
| CreateTimeSpanArray(TimeSpan[]) |
Crea un valore della proprietà da una matrice di intervalli di tempo. |
| CreateUInt16(UInt16) |
Crea un valore della proprietà da un intero senza segno. |
| CreateUInt16Array(UInt16[]) |
Crea un valore di proprietà da una matrice di interi senza segno. |
| CreateUInt32(UInt32) |
Crea un valore della proprietà da un intero senza segno. |
| CreateUInt32Array(UInt32[]) |
Crea un valore di proprietà da una matrice di interi senza segno. |
| CreateUInt64(UInt64) |
Crea un valore della proprietà da un intero senza segno. |
| CreateUInt64Array(UInt64[]) |
Crea un valore di proprietà da una matrice di interi senza segno. |
| CreateUInt8(Byte) |
Crea un valore di proprietà da un byte. |
| CreateUInt8Array(Byte[]) |
Crea un valore della proprietà da una matrice di byte. |