DataObject Classe

Definizione

Fornisce un'implementazione di base dell'interfaccia IDataObject che definisce un meccanismo indipendente dal formato per trasferire dati.Provides a basic implementation of the IDataObject interface, which defines a format-independent mechanism for transferring data.

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à
DataObject
Implementazioni

Esempi

Nell'esempio seguente viene illustrato come utilizzare questa classe.The following example shows how to use this class.

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.Calling methods from this class with untrusted data is a security risk. Chiamare i metodi da questa classe solo con dati attendibili.Call the methods from this class only with trusted data. Per altre informazioni, vedere Data Validation (Convalida dei dati).For more information, see Data Validation.

Costruttori

DataObject()

Inizializza una nuova istanza della classe DataObject.Initializes a new instance of the DataObject class.

DataObject(Object)

Inizializza una nuova istanza della classe DataObject contenente i dati specificati.Initializes a new instance of the DataObject class that contains the specified data.

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.Initializes a new instance of the DataObject class that contains the specified data and its associated format; the format is specified by a string.

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.Initializes a new instance of the DataObject class that contains the specified data and its associated format; the format is specified by a string. Questo overload include un flag Boolean che indica se i dati possono essere convertiti in un altro formato al momento del recupero.This overload includes a Boolean flag to indicate whether the data may be converted to another format on retrieval.

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.Initializes a new instance of the DataObject class that contains the specified data and its associated format; the data format is specified by a Type object.

Campi

CopyingEvent

Identifica l'evento associato Copying.Identifies the Copying attached event.

PastingEvent

Identifica l'evento associato Pasting.Identifies the Pasting attached event.

SettingDataEvent

Identifica l'evento associato SettingData.Identifies the SettingData attached event.

Metodi

AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Aggiunge un gestore dell'evento Copying a un oggetto dipendenza specificato.Adds a Copying event handler to a specified dependency object.

AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)

Aggiunge un gestore dell'evento Pasting a un oggetto dipendenza specificato.Adds a Pasting event handler to a specified dependency object.

AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Aggiunge un gestore dell'evento SettingData a un oggetto dipendenza specificato.Adds a SettingData event handler to a specified dependency object.

ContainsAudio()

Esegue una query su un oggetto dati per la presenza di dati nel formato dati WaveAudio.Queries a data object for the presence of data in the WaveAudio data format.

ContainsFileDropList()

Esegue una query su un oggetto dati per la presenza di dati nel formato dati FileDrop.Queries a data object for the presence of data in the FileDrop data format.

ContainsImage()

Esegue una query su un oggetto dati per la presenza di dati nel formato dati Bitmap.Queries a data object for the presence of data in the Bitmap data format.

ContainsText()

Esegue una query su un oggetto dati per la presenza di dati nel formato UnicodeText.Queries a data object for the presence of data in the UnicodeText format.

ContainsText(TextDataFormat)

Esegue una query su un oggetto dati per la presenza di dati in un formato dati di testo.Queries a data object for the presence of data in a text data format.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetAudioStream()

Restituisce un flusso che contiene dati nel formato dati WaveAudio.Returns a stream that contains data in the WaveAudio data format.

GetData(String)

Restituisce dati in un formato specificato da una stringa.Returns data in a format specified by a string.

GetData(String, Boolean)

Restituisce un oggetto dati in un formato specificato, con conversione opzionale dei dati nel formato specificato.Returns a data object in a specified format, optionally converting the data to the specified format.

GetData(Type)

Restituisce un oggetto dati in un formato specificato dall'oggetto Type.Returns a data object in a format specified by a Type object.

GetDataPresent(String)

Determina se i dati sono disponibili, o possono essere convertiti, in un formato specificato da una stringa.Determines whether the data is available in, or can be converted to, a format specified by a string.

GetDataPresent(String, Boolean)

Determina se i dati sono disponibili, o possono essere convertiti, in un formato specificato.Determines whether the data is available in, or can be converted to, a specified format. Un flag Boolean indica se è necessario controllare se i dati possono essere convertiti nel formato specificato qualora non siano disponibili in tale formato.A Boolean flag indicates whether to check if the data can be converted to the specified format if it is not available in that format.

GetDataPresent(Type)

Determina se i dati sono disponibili, o possono essere convertiti, in un formato specificato da un oggetto Type.Determines whether the data is available in, or can be converted to, a format specified by a Type object.

GetFileDropList()

Restituisce un insieme di stringhe che contiene un elenco di file rilasciati.Returns a string collection that contains a list of dropped files.

GetFormats()

Restituisce un elenco di formati nel quale i dati in questo oggetto dati sono archiviati, o possono essere convertiti.Returns a list of formats in which the data in this data object is stored, or can be converted to.

GetFormats(Boolean)

Restituisce un elenco di formati nel quale i dati in questo oggetto dati sono archiviati.Returns a list of formats in which the data in this data object is stored. Un flag Boolean indica se includere anche formati nei quali i dati possono essere convertiti automaticamente.A Boolean flag indicates whether to also include formats that the data can be automatically converted to.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetImage()

Restituisce l'oggetto BitmapSource che contiene dati nel formato Bitmap.Returns a BitmapSource object that contains data in the Bitmap format.

GetText()

Restituisce una stringa che contiene i dati in questo oggetto dati UnicodeText.Returns a string that contains the UnicodeText data in this data object.

GetText(TextDataFormat)

Restituisce una stringa che contiene dati di testo del formato specificato in questo oggetto dati.Returns a string that contains text data of the specified format in this data object.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Rimuove un gestore dell'evento Copying da un oggetto dipendenza specificato.Removes a Copying event handler from a specified dependency object.

RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)

Rimuove un gestore dell'evento Pasting da un oggetto dipendenza specificato.Removes a Pasting event handler from a specified dependency object.

RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Rimuove un gestore dell'evento SettingData da un oggetto dipendenza specificato.Removes a SettingData event handler from a specified dependency object.

SetAudio(Byte[])

Archivia dati audio (il formato dati WaveAudio) in questo oggetto dati.Stores audio data (WaveAudio data format) in this data object. I dati audio sono specificati come una matrice di byte.The audio data is specified as a byte array.

SetAudio(Stream)

Archivia dati audio (il formato dati WaveAudio) in questo oggetto dati.Stores audio data (WaveAudio data format) in this data object. I dati audio sono specificati come un flusso.The audio data is specified as a stream.

SetData(Object)

Archivia i dati specificati in questo oggetto dati, determinando automaticamente il formato dati dal tipo di oggetto di origine.Stores the specified data in this data object, automatically determining the data format from the source object type.

SetData(String, Object)

Archivia i dati specificati in questo oggetto dati, insieme ad uno o più formati dati specificati; il formato dati è specificato da una stringa.Stores the specified data in this data object, along with one or more specified data formats; the data format is specified by a string.

SetData(String, Object, Boolean)

Archivia i dati specificati in questo oggetto dati, insieme ad uno o più formati dati specificati.Stores the specified data in this data object, along with one or more specified data formats. Questo overload include un flag Boolean che indica se i dati possono essere convertiti in un altro formato al momento del recupero.This overload includes a Boolean flag to indicate whether the data can be converted to another format on retrieval.

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.Stores the specified data in this data object, along with one or more specified data formats; the data format is specified by a Type object.

SetFileDropList(StringCollection)

Archivia i dati FileDrop in questo oggetto dati.Stores FileDrop data in this data object. L'elenco dei file rilasciati è specificato come un insieme di stringhe.The dropped file list is specified as a string collection.

SetImage(BitmapSource)

Archivia i dati Bitmap in questo oggetto dati.Stores Bitmap data in this data object. I dati immagine sono specificati come un BitmapSource.The image data is specified as a BitmapSource.

SetText(String)

Archivia i dati, specificati come una stringa, in questo oggetto dati UnicodeText.Stores UnicodeText data, specified as a string, in this data object.

SetText(String, TextDataFormat)

Archivia dati di testo in questo oggetto dati.Stores text data in this data object. Il formato dei dati di testo da archiviare è specificato con un membro di TextDataFormat.The format of the text data to store is specified with a member of TextDataFormat.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(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.Occurs when the associated dependency object has prepared appropriate data formats that represent the copy selection, added the copy selection formats to a DataObject, and is ready to either place the DataObject on the Clipboard or begin a drag-and-drop operation.

Pasting

Si verifica quando l'oggetto di dipendenza associato è pronto per incollare dati.Occurs when the associated dependency object is ready to paste data.

SettingData

Si verifica quando l'oggetto di dipendenza associato tenta di aggiungere un nuovo formato dati ad un DataObject.Occurs when the associated dependency object attempts to add a new data format to a DataObject.

Implementazioni dell'interfaccia esplicita

IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

Crea una connessione tra un oggetto dati e un sink consultivo.Creates a connection between a data object and an advisory sink. Questo metodo viene chiamato da un oggetto che supporta un sink consultivo e attiva tale sink per ricevere una notifica delle modifiche nei dati dell'oggetto.This method is called by an object that supports an advisory sink and enables the advisory sink to be notified of changes in the object's data.

IDataObject.DUnadvise(Int32)

Elimina definitivamente una connessione di notifica stabilita in precedenza.Destroys a notification connection that had been previously established.

IDataObject.EnumDAdvise(IEnumSTATDATA)

Crea un oggetto che può essere utilizzato per enumerare le connessioni consultive correnti.Creates an object that can be used to enumerate the current advisory connections.

IDataObject.EnumFormatEtc(DATADIR)

Crea un oggetto per l'enumerazione delle strutture FORMATETC per un oggetto dati.Creates an object for enumerating the FORMATETC structures for a data object. Queste strutture sono utilizzate nelle chiamate al metodo GetData(FORMATETC, STGMEDIUM) o SetData(FORMATETC, STGMEDIUM, Boolean).These structures are used in calls to GetData(FORMATETC, STGMEDIUM) or SetData(FORMATETC, STGMEDIUM, Boolean).

IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Fornisce una struttura FORMATETC standard logicamente equivalente a una struttura più complessa.Provides a standard FORMATETC structure that is logically equivalent to a more complex structure. Utilizzare questo metodo per determinare se due strutture FORMATETC diverse restituiscono gli stessi dati, eliminando la necessità di rendering duplicati.Use this method to determine whether two different FORMATETC structures would return the same data, removing the need for duplicate rendering.

IDataObject.GetData(FORMATETC, STGMEDIUM)

Ottiene i dati da un oggetto dati di origine.Obtains data from a source data object. 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.The GetData(FORMATETC, STGMEDIUM) method, which is called by a data consumer, renders the data described in the specified FORMATETC structure and transfers it through the specified STGMEDIUM structure. Il chiamante si assume la responsabilità del rilascio della struttura STGMEDIUM.The caller then assumes responsibility for releasing the STGMEDIUM structure.

IDataObject.GetDataHere(FORMATETC, STGMEDIUM)

Ottiene i dati da un oggetto dati di origine.Obtains data from a source data object. 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.This method, which is called by a data consumer, differs from the GetData(FORMATETC, STGMEDIUM) method in that the caller must allocate and free the specified storage medium.

IDataObject.QueryGetData(FORMATETC)

Determina se l'oggetto dati è in grado di eseguire il rendering dei dati descritti nella struttura FORMATETC.Determines whether the data object is capable of rendering the data described in the FORMATETC structure. 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.Objects attempting a paste or drop operation can call this method before calling GetData(FORMATETC, STGMEDIUM) to get an indication of whether the operation may be successful.

IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)

Trasferisce i dati all'oggetto che implementa il metodo.Transfers data to the object that implements this method. Questo metodo viene chiamato da un oggetto contenente un'origine dati.This method is called by an object that contains a data source.

Si applica a

Vedi anche