DataObject Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows

Assembly:: PresentationCore.dll

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.

Fornisce un'implementazione di base dell'interfaccia IDataObject che definisce un meccanismo indipendente dal formato per trasferire dati.

public ref class DataObject sealed : System::Runtime::InteropServices::ComTypes::IDataObject, System::Windows::IDataObject

public sealed class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.IDataObject

type DataObject = class
    interface IDataObject
    interface IDataObject

Public NotInheritable Class DataObject
Implements IDataObject, IDataObject

Ereditarietà: Object
DataObject

Implementazioni: IDataObject IDataObject

Esempio

Nell'esempio seguente viene illustrato come utilizzare questa classe.

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)

Commenti

Importante

La chiamata a metodi da questa classe con dati non attendibili costituisce un rischio per la sicurezza. Chiamare i metodi da questa classe solo con dati attendibili. Per altre informazioni, vedere Convalidare tutti gli input.

Costruttori

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(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(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.

Campi

CopyingEvent	Identifica l'evento associato Copying.
PastingEvent	Identifica l'evento associato Pasting.
SettingDataEvent	Identifica l'evento associato SettingData.

Metodi

AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Aggiunge un gestore dell'evento Copying a un oggetto dipendenza specificato.
AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)	Aggiunge un gestore dell'evento Pasting a un oggetto dipendenza specificato.
AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Aggiunge un gestore dell'evento SettingData a un oggetto dipendenza specificato.
ContainsAudio()	Esegue una query su un oggetto dati per la presenza di dati nel formato dati WaveAudio.
ContainsFileDropList()	Esegue una query su un oggetto dati per la presenza di dati nel formato dati FileDrop.
ContainsImage()	Esegue una query su un oggetto dati per la presenza di dati nel formato dati Bitmap.
ContainsText()	Esegue una query su un oggetto dati per la presenza di dati nel formato UnicodeText.
ContainsText(TextDataFormat)	Esegue una query su un oggetto dati per la presenza di dati in un formato dati di testo.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetAudioStream()	Restituisce un flusso che contiene dati nel formato dati WaveAudio.
GetData(String)	Restituisce dati in un formato specificato da una stringa.
GetData(String, Boolean)	Restituisce un oggetto dati in un formato specificato, con conversione opzionale dei dati nel formato specificato.
GetData(Type)	Restituisce un oggetto dati in un formato specificato dall'oggetto Type.
GetDataPresent(String)	Determina se i dati sono disponibili, o possono essere convertiti, in un formato specificato da una stringa.
GetDataPresent(String, Boolean)	Determina se i dati sono disponibili, o possono essere convertiti, in un formato specificato. Un flag `Boolean` indica se è necessario controllare se i dati possono essere convertiti nel formato specificato qualora non siano disponibili in tale formato.
GetDataPresent(Type)	Determina se i dati sono disponibili, o possono essere convertiti, in un formato specificato da un oggetto Type.
GetFileDropList()	Restituisce un insieme di stringhe che contiene un elenco di file rilasciati.
GetFormats()	Restituisce un elenco di formati nel quale i dati in questo oggetto dati sono archiviati, o possono essere convertiti.
GetFormats(Boolean)	Restituisce un elenco di formati nel quale i dati in questo oggetto dati sono archiviati. Un flag `Boolean` indica se includere anche formati nei quali i dati possono essere convertiti automaticamente.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetImage()	Restituisce l'oggetto BitmapSource che contiene dati nel formato Bitmap.
GetText()	Restituisce una stringa che contiene i dati in questo oggetto dati UnicodeText.
GetText(TextDataFormat)	Restituisce una stringa che contiene dati di testo del formato specificato in questo oggetto dati.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Rimuove un gestore dell'evento Copying da un oggetto dipendenza specificato.
RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)	Rimuove un gestore dell'evento Pasting da un oggetto dipendenza specificato.
RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Rimuove un gestore dell'evento SettingData da un oggetto dipendenza specificato.
SetAudio(Byte[])	Archivia dati audio (il formato dati WaveAudio) in questo oggetto dati. I dati audio sono specificati come una matrice di byte.
SetAudio(Stream)	Archivia dati audio (il formato dati WaveAudio) in questo oggetto dati. I dati audio sono specificati come un flusso.
SetData(Object)	Archivia i dati specificati in questo oggetto dati, determinando automaticamente il formato dati dal tipo di oggetto di origine.
SetData(String, Object)	Archivia i dati specificati nell'oggetto dati assieme a uno o più formati dati specificati. Il formato dati è specificato da una stringa.
SetData(String, Object, Boolean)	Archivia i dati specificati in questo oggetto dati, insieme ad uno o più formati dati specificati. Questo overload include un flag `Boolean` che indica se i dati possono essere convertiti in un altro formato al momento del recupero.
SetData(Type, Object)	Archivia i dati specificati in questo oggetto dati, insieme ad uno o più formati dati specificati; il formato dati è specificato da un oggetto Type.
SetFileDropList(StringCollection)	Archivia i dati FileDrop in questo oggetto dati. L'elenco dei file rilasciati è specificato come un insieme di stringhe.
SetImage(BitmapSource)	Archivia i dati Bitmap in questo oggetto dati. I dati immagine sono specificati come un BitmapSource.
SetText(String)	Archivia i dati, specificati come una stringa, in questo oggetto dati UnicodeText.
SetText(String, TextDataFormat)	Archivia dati di testo in questo oggetto dati. Il formato dei dati di testo da archiviare è specificato con un membro di TextDataFormat.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi associati

Copying	Si verifica quando l'oggetto dipendenza associato ha preparato i formati di dati appropriati che rappresentano la selezione della copia, ha aggiunto i formati di selezione della copia a un oggetto DataObject ed è pronto a sostituire l'oggetto DataObject nell'oggetto Clipboard oppure ad avviare un'operazione di trascinamento della selezione.
Pasting	Si verifica quando l'oggetto dipendenza associato è pronto per incollare i dati.
SettingData	Si verifica quando l'oggetto dipendenza associato tenta di aggiungere un nuovo formato dati a un DataObject.

Implementazioni dell'interfaccia esplicita

IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)	Crea una connessione tra un oggetto dati e un sink consultivo. Questo metodo viene chiamato da un oggetto che supporta un sink consultivo e abilita tale sink per ricevere una notifica delle modifiche nei dati dell'oggetto.
IDataObject.DUnadvise(Int32)	Elimina definitivamente una connessione di notifica stabilita in precedenza.
IDataObject.EnumDAdvise(IEnumSTATDATA)	Crea un oggetto che può essere usato per enumerare le connessioni consultive correnti.
IDataObject.EnumFormatEtc(DATADIR)	Crea un oggetto per l'enumerazione delle strutture FORMATETC per un oggetto dati. Queste strutture sono utilizzate nelle chiamate al metodo GetData(FORMATETC, STGMEDIUM) o SetData(FORMATETC, STGMEDIUM, Boolean).
IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)	Fornisce una struttura FORMATETC standard logicamente equivalente a una struttura più complessa. Utilizzare questo metodo per determinare se due strutture FORMATETC diverse restituiscono gli stessi dati, eliminando la necessità di rendering duplicati.
IDataObject.GetData(FORMATETC, STGMEDIUM)	Ottiene i dati da un oggetto dati di origine. Il metodo GetData(FORMATETC, STGMEDIUM), chiamato da un consumer di dati, esegue il rendering dei dati descritti nella struttura FORMATETC specificata e li trasferisce mediante la struttura STGMEDIUM specificata. Il chiamante si assume la responsabilità del rilascio della struttura STGMEDIUM.
IDataObject.GetDataHere(FORMATETC, STGMEDIUM)	Ottiene i dati da un oggetto dati di origine. Questo metodo, chiamato da un consumer di dati, si differenzia dal metodo GetData(FORMATETC, STGMEDIUM) in quanto il chiamante deve allocare e liberare il supporto di archiviazione specificato.
IDataObject.QueryGetData(FORMATETC)	Determina se l'oggetto dati è in grado di eseguire il rendering dei dati descritti nella struttura FORMATETC. Gli oggetti che tentano un'operazione di inserimento o rilascio possono chiamare questo metodo prima di chiamare GetData(FORMATETC, STGMEDIUM) per ottenere indicazioni relative alla riuscita dell'operazione.
IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)	Trasferisce i dati all'oggetto che implementa il metodo. Questo metodo viene chiamato da un oggetto contenente un'origine dati.

Si applica a

Vedi anche

Caricare un esempio di file eliminato