Partilhar via


DataObject Classe

Definição

Fornece uma implementação básica da interface IDataObject, que define um mecanismo independente de formato para a transferência de dados.

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
Herança
DataObject
Implementações

Exemplos

O exemplo a seguir mostra como usar essa 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)

Comentários

Importante

Chamar métodos desta classe quando você tiver dados não confiáveis é um risco à segurança. Chame os métodos dessa classe somente quando você tiver dados confiáveis. Para obter mais informações, consulte Validar todas as entradas.

Construtores

DataObject()

Inicializa uma nova instância da classe DataObject.

DataObject(Object)

Inicializa uma nova instância da classe DataObject que contém os dados especificados.

DataObject(String, Object)

Inicializa uma nova instância da classe DataObject que contém os dados especificados e o formato associado; o formato é especificado por uma cadeia de caracteres.

DataObject(String, Object, Boolean)

Inicializa uma nova instância da classe DataObject que contém os dados especificados e o formato associado; o formato é especificado por uma cadeia de caracteres. Essa sobrecarga inclui um sinalizador Boolean para indicar se os dados podem ou não ser convertidos para outro formato ao serem recuperados.

DataObject(Type, Object)

Inicializa uma nova instância da classe DataObject que contém os dados especificados e seu formato associado; o formato de dados é especificado por um objeto Type.

Campos

CopyingEvent

Identifica o evento Copying anexado.

PastingEvent

Identifica o evento Pasting anexado.

SettingDataEvent

Identifica o evento SettingData anexado.

Métodos

AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Adiciona um manipulador de eventos Copying a um objeto de dependência especificado.

AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)

Adiciona um manipulador de eventos Pasting a um objeto de dependência especificado.

AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Adiciona um manipulador de eventos SettingData a um objeto de dependência especificado.

ContainsAudio()

Consulta a presença de dados no formato de dados WaveAudio em um objeto de dados.

ContainsFileDropList()

Consulta a presença de dados no formato de dados FileDrop em um objeto de dados.

ContainsImage()

Consulta a presença de dados no formato de dados Bitmap em um objeto de dados.

ContainsText()

Consulta a presença de dados no formato UnicodeText em um objeto de dados.

ContainsText(TextDataFormat)

Consulta a presença de dados em um formato de dados de texto em um objeto de dados.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetAudioStream()

Retorna um fluxo que contém dados no formato de dados WaveAudio.

GetData(String)

Retorna dados em um formato especificado por uma cadeia de caracteres.

GetData(String, Boolean)

Retorna um objeto de dados em um formato especificado, convertendo opcionalmente os dados no formato especificado.

GetData(Type)

Retorna um objeto de dados em um formato especificado por um objeto Type.

GetDataPresent(String)

Determina se os dados estão disponíveis em um formato especificado por uma cadeia de caracteres ou se eles podem ser convertidos nesse formato.

GetDataPresent(String, Boolean)

Determina se os dados estão disponíveis em um formato especificado ou se podem ser convertidos nele. Um sinalizador Boolean indica se é necessário verificar se os dados podem ser convertidos no formato especificado, se ele não estiver disponível nesse formato.

GetDataPresent(Type)

Determina se os dados estão disponíveis em um formato especificado por um objeto Type ou se eles podem ser convertidos nesse formato.

GetFileDropList()

Retorna uma coleção de cadeia de caracteres que contém uma lista de arquivos ignorados.

GetFormats()

Retorna uma lista de formatos em que os dados neste objeto de dados estão armazenados ou nos quais eles podem ser convertidos.

GetFormats(Boolean)

Retorna uma lista de formatos em que os dados neste objeto de dados estão armazenados. Um sinalizador Boolean indica se os formatos nos quais os dados podem ser automaticamente convertidos devem ser incluídos.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetImage()

Retorna um objeto BitmapSource que contém dados no formato Bitmap.

GetText()

Retorna uma cadeia de caracteres que contém os dados UnicodeText neste objeto de dados.

GetText(TextDataFormat)

Retorna uma cadeia de caracteres que contém dados de texto do formato especificado neste objeto de dados.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Remove um manipulador de eventos Copying de um objeto de dependência especificado.

RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)

Remove um manipulador de eventos Pasting de um objeto de dependência especificado.

RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Remove um manipulador de eventos SettingData de um objeto de dependência especificado.

SetAudio(Byte[])

Armazena dados de áudio (formato de dados WaveAudio) neste objeto de dados. Os dados de áudio são especificados como uma matriz de bytes.

SetAudio(Stream)

Armazena dados de áudio (formato de dados WaveAudio) neste objeto de dados. Os dados de áudio são especificados como um fluxo.

SetData(Object)

Armazena os dados especificados neste objeto de dados, determinando automaticamente o formato de dados do tipo de objeto de origem.

SetData(String, Object)

Armazena os dados especificados neste objeto de dados, juntamente com um ou mais formatos de dados especificados; o formato de dados é especificado por uma cadeia de caracteres.

SetData(String, Object, Boolean)

Armazena os dados especificados neste objeto de dados, juntamente com um ou mais formatos de dados especificados. Essa sobrecarga inclui um sinalizador Boolean para indicar se os dados podem ou não ser convertidos para outro formato ao serem recuperados.

SetData(Type, Object)

Armazena os dados especificados neste objeto de dados, juntamente com um ou mais formatos de dados especificados; o formato de dados é especificado por um objeto Type.

SetFileDropList(StringCollection)

Armazena os dados FileDrop neste objeto de dados. A lista de arquivos ignorados é especificada como uma coleção de cadeia de caracteres.

SetImage(BitmapSource)

Armazena os dados Bitmap neste objeto de dados. Os dados da imagem são especificados como um BitmapSource.

SetText(String)

Armazena os dados UnicodeText, especificados como uma cadeia de caracteres, neste objeto de dados.

SetText(String, TextDataFormat)

Armazena os dados de texto neste objeto de dados. O formato dos dados de texto a serem armazenados é especificado com um membro de TextDataFormat.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Eventos Anexados

Copying

Ocorre quando o objeto de dependência associado preparou os formatos de dados apropriados que representam a seleção de cópia, adicionou os formatos de seleção de cópia para um DataObjecte está pronto para colocar o DataObject no Clipboard ou começar um operação de arrastar e soltar.

Pasting

Ocorre quando o objeto de dependência associado está pronto para colar os dados.

SettingData

Ocorre quando o objeto de dependência associado tenta adicionar um novo formato de dados para um DataObject.

Implantações explícitas de interface

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

Cria uma conexão entre um objeto de dados e um coletor de consultoria. Este método é chamado por um objeto compatível com um coletor de consultoria e o habilita para ser notificado sobre alterações nos dados do objeto.

IDataObject.DUnadvise(Int32)

Destrói um conexão de notificação que tinha sido estabelecida anteriormente.

IDataObject.EnumDAdvise(IEnumSTATDATA)

Cria um objeto que pode ser usado para enumerar as conexões de consultoria atuais.

IDataObject.EnumFormatEtc(DATADIR)

Cria um objeto para enumerar as estruturas FORMATETC de um objeto de dados. Essas estruturas são usadas em chamadas a GetData(FORMATETC, STGMEDIUM) ou SetData(FORMATETC, STGMEDIUM, Boolean).

IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Fornece uma estrutura FORMATETC padrão logicamente equivalente a uma estrutura mais complexa. Use esse método para determinar se duas estruturas FORMATETC diferentes retornariam os mesmos dados, acabando com a necessidade de renderização duplicada.

IDataObject.GetData(FORMATETC, STGMEDIUM)

Obtém dados de um objeto de dados de origem. O método GetData(FORMATETC, STGMEDIUM), chamado por um consumidor de dados, renderiza os dados descritos na estrutura FORMATETC especificada e os transfere por meio da estrutura STGMEDIUM especificada. Em seguida, o chamador assume a responsabilidade por liberar a estrutura STGMEDIUM.

IDataObject.GetDataHere(FORMATETC, STGMEDIUM)

Obtém dados de um objeto de dados de origem. Esse método, chamado por um consumidor de dados, é diferente do método GetData(FORMATETC, STGMEDIUM) em que o chamador deve alocar e liberar o meio de armazenamento especificado.

IDataObject.QueryGetData(FORMATETC)

Determina se o objeto de dados é capaz de renderizar os dados descritos na estrutura FORMATETC. Objetos que tentam uma operação de colar ou de soltar podem chamar este método antes de chamar GetData(FORMATETC, STGMEDIUM) para obter uma indicação se a operação pode ser bem-sucedida.

IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)

Transfere dados ao objeto que implementa este método. Este método é chamado por um objeto que contém uma fonte de dados.

Aplica-se a

Confira também