DataObject Costruttori

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationCore.dll

Inizializza una nuova istanza della classe DataObject.

Overload

DataObject()	Inizializza una nuova istanza della classe DataObject.
DataObject(Object)	Inizializza una nuova istanza della classe DataObject contenente i dati specificati.
DataObject(String, Object)	Inizializza una nuova istanza della classe DataObject che contiene i dati specificati e il relativo formato associato; il formato è specificato da una stringa.
DataObject(Type, Object)	Inizializza una nuova istanza della classe DataObject che contiene i dati specificati e il relativo formato associato; il formato dati è specificato da un oggetto Type.
DataObject(String, Object, Boolean)	Inizializza una nuova istanza della classe DataObject che contiene i dati specificati e il relativo formato associato; il formato è specificato da una stringa. Questo overload include un flag Boolean che indica se i dati possono essere convertiti in un altro formato al momento del recupero.

DataObject()

Inizializza una nuova istanza della classe DataObject.

public:
 DataObject();

public DataObject ();

Public Sub New ()

DataObject(Object)

Inizializza una nuova istanza della classe DataObject contenente i dati specificati.

public:
 DataObject(System::Object ^ data);

public DataObject (object data);

new System.Windows.DataObject : obj -> System.Windows.DataObject

Public Sub New (data As Object)

Parametri

data

Object

Oggetto che rappresenta i dati da archiviare nell'oggetto dati.

Eccezioni

ArgumentNullException

data è null.

ArgumentOutOfRangeException

data fa riferimento all'oggetto DataObject.

Esempio

Nell'esempio seguente viene creato un nuovo oggetto dati e viene utilizzato questo costruttore per inizializzare l'oggetto dati con una stringa. In questo caso, un formato di dati appropriato viene determinato automaticamente in base al tipo di dati archiviati e la conversione automatica dei dati archiviati è consentita per impostazione predefinita.

string stringData = "Some string data to store...";
DataObject dataObject = new DataObject(stringData);

Dim stringData As String = "Some string data to store..."
Dim dataObject As New DataObject(stringData)

L'esempio seguente è una versione ridotta dell'esempio precedente.

DataObject dataObject = new DataObject("Some string data to store...");

Dim dataObject As New DataObject("Some string data to store...")

DataObject(String, Object)

Inizializza una nuova istanza della classe DataObject che contiene i dati specificati e il relativo formato associato; il formato è specificato da una stringa.

public:
 DataObject(System::String ^ format, System::Object ^ data);

public DataObject (string format, object data);

new System.Windows.DataObject : string * obj -> System.Windows.DataObject

Public Sub New (format As String, data As Object)

Parametri

format

String

Stringa che specifica il formato dei dati. Per un set di formati dati predefiniti, vedere la classe DataFormats.

data

Object

Oggetto che rappresenta i dati da archiviare nell'oggetto dati.

Eccezioni

ArgumentNullException

data o format è null.

Esempio

Nell'esempio seguente viene creato un nuovo oggetto dati e viene utilizzato questo costruttore per inizializzare l'oggetto dati con una stringa e un formato di dati specificato. In questo caso, il formato dei dati viene specificato da una stringa; la DataFormats classe fornisce un set di stringhe di tipi predefinite. La conversione automatica dei dati archiviati è consentita per impostazione predefinita.

string stringData = "Some string data to store...";
string dataFormat = DataFormats.UnicodeText;
DataObject dataObject = new DataObject(dataFormat, stringData);

Dim stringData As String = "Some string data to store..."
Dim dataFormat As String = DataFormats.UnicodeText
Dim dataObject As New DataObject(dataFormat, stringData)

L'esempio seguente è una versione ridotta dell'esempio precedente.

DataObject dataObject = new DataObject(DataFormats.UnicodeText, "Some string data to store...");

Dim dataObject As New DataObject(DataFormats.UnicodeText, "Some string data to store...")

DataObject(Type, Object)

Inizializza una nuova istanza della classe DataObject che contiene i dati specificati e il relativo formato associato; il formato dati è specificato da un oggetto Type.

public:
 DataObject(Type ^ format, System::Object ^ data);

public DataObject (Type format, object data);

new System.Windows.DataObject : Type * obj -> System.Windows.DataObject

Public Sub New (format As Type, data As Object)

Parametri

format

Type

Una Type che specifica il formato per i dati. Per un set di formati dati predefiniti, vedere la classe DataFormats.

data

Object

Dati da archiviare in questo oggetto dati.

Eccezioni

ArgumentNullException

data o format è null.

Esempio

Nell'esempio seguente viene creato un nuovo oggetto dati e viene utilizzato questo costruttore per inizializzare l'oggetto dati con una stringa e un formato di dati specificato. In questo caso, il formato dei dati viene specificato da un Type parametro . La conversione automatica dei dati archiviati è consentita per impostazione predefinita.

string stringData = "Some string data to store...";
Type dataFormat = stringData.GetType();
DataObject dataObject = new DataObject(dataFormat, stringData);

Dim stringData As String = "Some string data to store..."
Dim dataFormat As Type = stringData.GetType()
Dim dataObject As New DataObject(dataFormat, stringData)

L'esempio seguente è una versione ridotta dell'esempio precedente.

DataObject dataObject = new DataObject("".GetType(), "Some string data to store...");

Dim dataObject As New DataObject("".GetType(), "Some string data to store...")

DataObject(String, Object, Boolean)

Inizializza una nuova istanza della classe DataObject che contiene i dati specificati e il relativo formato associato; il formato è specificato da una stringa. Questo overload include un flag Boolean che indica se i dati possono essere convertiti in un altro formato al momento del recupero.

public:
 DataObject(System::String ^ format, System::Object ^ data, bool autoConvert);

public DataObject (string format, object data, bool autoConvert);

new System.Windows.DataObject : string * obj * bool -> System.Windows.DataObject

Public Sub New (format As String, data As Object, autoConvert As Boolean)

Parametri

format

String

Stringa che specifica il formato dei dati. Per un set di formati dati predefiniti, vedere la classe DataFormats.

data

Object

Dati da archiviare in questo oggetto dati.

autoConvert

Boolean

true per consentire la conversione dei dati in un altro formato al momento del recupero; false per impedire la conversione dei dati in un altro formato al momento del recupero.

Eccezioni

ArgumentNullException

data o format è null.

Esempio

Nell'esempio seguente viene creato un nuovo oggetto dati e viene utilizzato questo costruttore per inizializzare l'oggetto dati con una stringa e un formato di dati specificato. In questo caso, il formato dei dati viene specificato da una stringa; la DataFormats classe fornisce un set di stringhe di tipi predefinite.

string stringData = "Some string data to store...";
string dataFormat = DataFormats.Text;
bool autoConvert = false;
DataObject dataObject = new DataObject(dataFormat, stringData, autoConvert);

Dim stringData As String = "Some string data to store..."
Dim dataFormat As String = DataFormats.Text
Dim autoConvert As Boolean = False
Dim dataObject As New DataObject(dataFormat, stringData, autoConvert)

L'esempio seguente è una versione ridotta dell'esempio precedente.

DataObject dataObject = new DataObject(DataFormats.Text, "Some string data to store...", false);

Dim dataObject As New DataObject(DataFormats.Text, "Some string data to store...", False)