DataObject Classe

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 il trasferimento dei dati.

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

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

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

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

type DataObject = class
    interface IDataObject
    interface IDataObject

type DataObject = class
    interface IDataObject
    interface IDataObject
    interface ITypedDataObject

Public NotInheritable Class DataObject
Implements IDataObject, IDataObject

Public NotInheritable Class DataObject
Implements IDataObject, ITypedDataObject

Ereditarietà: Object
DataObject

Implementazioni: IDataObject IDataObject ITypedDataObject

Esempio

Nell'esempio seguente viene illustrato come usare 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 di metodi da questa classe con dati non attendibili è un rischio per la sicurezza. Chiamare i metodi da questa classe solo con dati attendibili. Per altre informazioni, vedere Convalidare tutti gli input.

Costruttori

Nome	Descrizione
DataObject()	Inizializza una nuova istanza della classe DataObject.
DataObject(Object)	Inizializza una nuova istanza della DataObject classe che contiene i dati specificati.
DataObject(String, Object, Boolean)	Inizializza una nuova istanza della DataObject classe che contiene i dati specificati e il relativo formato associato. Il formato viene specificato da una stringa. Questo overload include un `Boolean` flag per indicare se i dati possono essere convertiti in un altro formato al recupero.
DataObject(String, Object)	Inizializza una nuova istanza della DataObject classe che contiene i dati specificati e il relativo formato associato. Il formato viene specificato da una stringa.
DataObject(Type, Object)	Inizializza una nuova istanza della DataObject classe che contiene i dati specificati e il relativo formato associato. Il formato dei dati viene specificato da un Type oggetto .

Campi

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

Metodi

Nome	Descrizione
AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Aggiunge un Copying gestore eventi a un oggetto di dipendenza specificato.
AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)	Aggiunge un Pasting gestore eventi a un oggetto di dipendenza specificato.
AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Aggiunge un SettingData gestore eventi a un oggetto di dipendenza specificato.
ContainsAudio()	Esegue una query su un oggetto dati per la presenza di dati nel WaveAudio formato dati.
ContainsFileDropList()	Esegue una query su un oggetto dati per la presenza di dati nel FileDrop formato dati.
ContainsImage()	Esegue una query su un oggetto dati per la presenza di dati nel Bitmap formato dati.
ContainsText()	Esegue una query su un oggetto dati per la presenza di dati nel UnicodeText formato .
ContainsText(TextDataFormat)	Esegue una query su un oggetto dati per la presenza di dati in un formato di 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 WaveAudio formato dati.
GetData(String, Boolean)	Restituisce un oggetto dati in un formato specificato, convertendo facoltativamente i dati nel formato specificato.
GetData(String)	Restituisce i dati in un formato specificato da una stringa.
GetData(Type)	Restituisce un oggetto dati in un formato specificato da un Type oggetto .
GetDataPresent(String, Boolean)	Determina se i dati sono disponibili in o possono essere convertiti in un formato specificato. Un `Boolean` flag indica se verificare se i dati possono essere convertiti nel formato specificato se non sono disponibili in tale formato.
GetDataPresent(String)	Determina se i dati sono disponibili in o possono essere convertiti in un formato specificato da una stringa.
GetDataPresent(Type)	Determina se i dati sono disponibili in o possono essere convertiti in un formato specificato da un Type oggetto .
GetFileDropList()	Restituisce un insieme di stringhe contenente un elenco di file eliminati.
GetFormats()	Restituisce un elenco di formati in cui vengono archiviati i dati in questo oggetto dati o in cui possono essere convertiti.
GetFormats(Boolean)	Restituisce un elenco di formati in cui vengono archiviati i dati in questo oggetto dati. Un `Boolean` flag indica se includere anche formati in cui i dati possono essere convertiti automaticamente.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetImage()	Restituisce un BitmapSource oggetto che contiene dati nel Bitmap formato .
GetText()	Restituisce una stringa che contiene i UnicodeText dati in questo oggetto dati.
GetText(TextDataFormat)	Restituisce una stringa che contiene dati di testo del formato specificato in questo oggetto dati.
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Rimuove un Copying gestore eventi da un oggetto dipendenza specificato.
RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)	Rimuove un Pasting gestore eventi da un oggetto dipendenza specificato.
RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Rimuove un SettingData gestore eventi da un oggetto dipendenza specificato.
SetAudio(Byte[])	Archivia i dati audio (WaveAudio formato dati) in questo oggetto dati. I dati audio sono specificati come matrice di byte.
SetAudio(Stream)	Archivia i dati audio (WaveAudio formato dati) in questo oggetto dati. I dati audio sono specificati come flusso.
SetData(Object)	Archivia i dati specificati in questo oggetto dati, determinando automaticamente il formato dei dati dal tipo di oggetto di origine.
SetData(String, Object, Boolean)	Archivia i dati specificati in questo oggetto dati, insieme a uno o più formati di dati specificati. Questo overload include un `Boolean` flag per indicare se i dati possono essere convertiti in un altro formato al recupero.
SetData(String, Object)	Archivia i dati specificati in questo oggetto dati, insieme a uno o più formati di dati specificati; il formato dei dati viene specificato da una stringa.
SetData(Type, Object)	Archivia i dati specificati in questo oggetto dati, insieme a uno o più formati di dati specificati; il formato dei dati viene specificato da un Type oggetto .
SetDataAsJson<T>(String, T)	Fornisce un'implementazione di base dell'interfaccia IDataObject , che definisce un meccanismo indipendente dal formato per il trasferimento dei dati.
SetDataAsJson<T>(T)	Fornisce un'implementazione di base dell'interfaccia IDataObject , che definisce un meccanismo indipendente dal formato per il trasferimento dei dati.
SetFileDropList(StringCollection)	Archivia i FileDrop dati in questo oggetto dati. L'elenco di file eliminati viene specificato come raccolta di stringhe.
SetImage(BitmapSource)	Archivia i Bitmap dati in questo oggetto dati. I dati dell'immagine vengono specificati come .BitmapSource
SetText(String, TextDataFormat)	Archivia i dati di testo in questo oggetto dati. Il formato dei dati di testo da archiviare viene specificato con un membro di TextDataFormat.
SetText(String)	Archivia UnicodeText i dati, specificati come stringa, in questo oggetto dati.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TryGetData<T>(String, Boolean, T)	Fornisce un'implementazione di base dell'interfaccia IDataObject , che definisce un meccanismo indipendente dal formato per il trasferimento dei dati.
TryGetData<T>(String, Func<TypeName,Type>, Boolean, T)	Fornisce un'implementazione di base dell'interfaccia IDataObject , che definisce un meccanismo indipendente dal formato per il trasferimento dei dati.
TryGetData<T>(String, T)	Fornisce un'implementazione di base dell'interfaccia IDataObject , che definisce un meccanismo indipendente dal formato per il trasferimento dei dati.
TryGetData<T>(T)	Fornisce un'implementazione di base dell'interfaccia IDataObject , che definisce un meccanismo indipendente dal formato per il trasferimento dei dati.

Eventi associati

Nome	Descrizione
Copying	Si verifica quando l'oggetto dipendenza associato ha preparato formati di dati appropriati che rappresentano la selezione della copia, ha aggiunto i formati di selezione della copia a un DataObjectoggetto ed è pronto per posizionare l'oggetto sull'oggetto DataObject Clipboard o 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 di dati a un oggetto DataObject.

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)	Crea una connessione tra un oggetto dati e un sink di avviso. Questo metodo viene chiamato da un oggetto che supporta un sink di consulenza e consente al sink di consulenza di 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 utilizzato per enumerare le connessioni consultive correnti.
IDataObject.EnumFormatEtc(DATADIR)	Crea un oggetto per enumerare le FORMATETC strutture per un oggetto dati. Queste strutture vengono usate nelle chiamate a GetData(FORMATETC, STGMEDIUM) o SetData(FORMATETC, STGMEDIUM, Boolean).
IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)	Fornisce una struttura standard FORMATETC equivalente logicamente a una struttura più complessa. Utilizzare questo metodo per determinare se due strutture diverse FORMATETC restituiscono gli stessi dati, rimuovendo la necessità di eseguire il rendering duplicato.
IDataObject.GetData(FORMATETC, STGMEDIUM)	Ottiene i dati da un oggetto dati di origine. Il GetData(FORMATETC, STGMEDIUM) metodo , chiamato da un consumer di dati, esegue il rendering dei dati descritti nella struttura specificata FORMATETC e lo trasferisce tramite la struttura specificata STGMEDIUM . Il chiamante assume quindi la responsabilità di rilasciare la STGMEDIUM struttura.
IDataObject.GetDataHere(FORMATETC, STGMEDIUM)	Ottiene i dati da un oggetto dati di origine. Questo metodo, chiamato da un consumer di dati, differisce dal GetData(FORMATETC, STGMEDIUM) metodo 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 FORMATETC struttura. Gli oggetti che tentano un'operazione incolla o rilascia possono chiamare questo metodo prima di chiamare GetData(FORMATETC, STGMEDIUM) per ottenere un'indicazione dell'esito positivo dell'operazione.
IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)	Trasferisce i dati all'oggetto che implementa questo metodo. Questo metodo viene chiamato da un oggetto che contiene un'origine dati.

Metodi di estensione

Nome	Descrizione
TryGetData<T>(IDataObject, String, Boolean, T)	Fornisce un'implementazione di base dell'interfaccia IDataObject , che definisce un meccanismo indipendente dal formato per il trasferimento dei dati.
TryGetData<T>(IDataObject, String, Func<TypeName,Type>, Boolean, T)	Fornisce un'implementazione di base dell'interfaccia IDataObject , che definisce un meccanismo indipendente dal formato per il trasferimento dei dati.
TryGetData<T>(IDataObject, String, T)	Fornisce un'implementazione di base dell'interfaccia IDataObject , che definisce un meccanismo indipendente dal formato per il trasferimento dei dati.
TryGetData<T>(IDataObject, T)	Fornisce un'implementazione di base dell'interfaccia IDataObject , che definisce un meccanismo indipendente dal formato per il trasferimento dei dati.

Si applica a

Vedi anche

Caricare un esempio di file eliminato

Commenti e suggerimenti

Questa pagina è stata utile?