DataObject Classe

Definição

Espaço de Nomes:: System.Windows

Assemblagem:: PresentationCore.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Fornece uma implementação básica da IDataObject interface, que define um mecanismo independente do formato para transferir 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: Object
DataObject

Implementações: IDataObject IDataObject

Exemplos

O exemplo seguinte mostra como usar esta 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)

Observações

Importante

Chamar métodos dessa classe com dados não confiáveis é um risco de segurança. Chame os métodos dessa classe somente com dados confiáveis. Para obter mais informações, consulte Validar todas as informações inseridas.

Construtores

Name	Description
DataObject()	Inicializa uma nova instância da DataObject classe.
DataObject(Object)	Inicializa uma nova instância da DataObject classe que contém os dados especificados.
DataObject(String, Object, Boolean)	Inicializa uma nova instância da DataObject classe que contém os dados especificados e o seu formato associado; o formato é especificado por uma string. Esta sobrecarga inclui um `Boolean` sinalizador para indicar se os dados podem ser convertidos para outro formato na recuperação.
DataObject(String, Object)	Inicializa uma nova instância da DataObject classe que contém os dados especificados e o seu formato associado; o formato é especificado por uma string.
DataObject(Type, Object)	Inicializa uma nova instância da DataObject classe que contém os dados especificados e o seu formato associado; o formato dos dados é especificado por um Type objeto.

Campos

Name	Description
CopyingEvent	Identifica o Copying evento anexado.
PastingEvent	Identifica o Pasting evento anexado.
SettingDataEvent	Identifica o SettingData evento anexado.

Métodos

Name	Description
AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Adiciona um Copying gestor de eventos a um objeto de dependência especificado.
AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)	Adiciona um Pasting gestor de eventos a um objeto de dependência especificado.
AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Adiciona um SettingData gestor de eventos a um objeto de dependência especificado.
ContainsAudio()	Consulta a um objeto de dados para a presença de dados no WaveAudio formato de dados.
ContainsFileDropList()	Consulta a um objeto de dados para a presença de dados no FileDrop formato de dados.
ContainsImage()	Consulta a um objeto de dados para a presença de dados no Bitmap formato de dados.
ContainsText()	Consulta a um objeto de dados para a presença de dados no UnicodeText formato.
ContainsText(TextDataFormat)	Consulta a um objeto de dados para a presença de dados num formato de dados de texto.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetAudioStream()	Devolve um fluxo que contém dados no WaveAudio formato de dados.
GetData(String, Boolean)	Devolve um objeto de dados num formato especificado, convertendo opcionalmente os dados para o formato especificado.
GetData(String)	Devolve dados num formato especificado por uma cadeia.
GetData(Type)	Devolve um objeto de dados num formato especificado por um Type objeto.
GetDataPresent(String, Boolean)	Determina se os dados estão disponíveis ou podem ser convertidos para, um formato especificado. Uma `Boolean` bandeira indica se deve verificar se os dados podem ser convertidos para o formato especificado caso não estejam disponíveis nesse formato.
GetDataPresent(String)	Determina se os dados estão disponíveis ou podem ser convertidos para, um formato especificado por uma cadeia.
GetDataPresent(Type)	Determina se os dados estão disponíveis ou podem ser convertidos para, um formato especificado por um Type objeto.
GetFileDropList()	Devolve uma coleção de cadeias que contém uma lista de ficheiros descartados.
GetFormats()	Devolve uma lista de formatos em que os dados deste objeto de dados estão armazenados, ou podem ser convertidos para.
GetFormats(Boolean)	Devolve uma lista de formatos em que os dados deste objeto de dados estão armazenados. Um `Boolean` indicador indica se também deve incluir formatos para os quais os dados podem ser convertidos automaticamente.
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetImage()	Devolve um BitmapSource objeto que contém dados no Bitmap formato.
GetText()	Devolve uma cadeia que contém os UnicodeText dados deste objeto de dados.
GetText(TextDataFormat)	Devolve uma cadeia 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 atual Object. (Herdado de Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Remove um Copying gestor de eventos de um objeto de dependência especificado.
RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)	Remove um Pasting gestor de eventos de um objeto de dependência especificado.
RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Remove um SettingData gestor de eventos de um objeto de dependência especificado.
SetAudio(Byte[])	Armazena dados de áudio (WaveAudio formato de dados) neste objeto de dados. Os dados de áudio são especificados como um array de bytes.
SetAudio(Stream)	Armazena dados de áudio (WaveAudio formato de dados) 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 dos dados a partir do tipo de objeto de origem.
SetData(String, Object, Boolean)	Armazena os dados especificados neste objeto de dados, juntamente com um ou mais formatos de dados especificados. Esta sobrecarga inclui um `Boolean` sinalizador para indicar se os dados podem ser convertidos para outro formato na recuperação.
SetData(String, Object)	Armazena os dados especificados neste objeto de dados, juntamente com um ou mais formatos de dados especificados; O formato dos dados é especificado por uma cadeia.
SetData(Type, Object)	Armazena os dados especificados neste objeto de dados, juntamente com um ou mais formatos de dados especificados; O formato dos dados é especificado por um Type objeto.
SetFileDropList(StringCollection)	Armazena FileDrop dados neste objeto de dados. A lista de ficheiros descartada é especificada como uma coleção de strings.
SetImage(BitmapSource)	Armazena Bitmap dados neste objeto de dados. Os dados da imagem são especificados como um BitmapSource.
SetText(String, TextDataFormat)	Armazena dados de texto neste objeto de dados. O formato dos dados de texto a armazenar é especificado com um elemento de TextDataFormat.
SetText(String)	Armazena UnicodeText dados, especificados como uma cadeia, neste objeto de dados.
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)

Eventos Anexados

Name	Description
Copying	Ocorre quando o objeto de dependência associado preparou formatos de dados apropriados que representam a seleção de cópia, adicionou os formatos de seleção de cópia a um DataObject, e está pronto para colocar o DataObject no Clipboard ou iniciar uma operação de arrastar e largar.
Pasting	Ocorre quando o objeto de dependência associado está pronto para colar dados.
SettingData	Ocorre quando o objeto de dependência associado tenta adicionar um novo formato de dados a um DataObject.

Implementações de Interface Explícita

Name	Description
IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)	Cria uma ligação entre um objeto de dados e um sumidouro de aviso. Este método é chamado por um objeto que suporta um sumidouro de aviso e permite que o sumidouro de aviso seja notificado de alterações nos dados do objeto.
IDataObject.DUnadvise(Int32)	Destrói uma ligação de notificação que tinha sido estabelecida anteriormente.
IDataObject.EnumDAdvise(IEnumSTATDATA)	Cria um objeto que pode ser usado para enumerar as ligações de aconselhamento atuais.
IDataObject.EnumFormatEtc(DATADIR)	Cria um objeto para enumerar as FORMATETC estruturas de um objeto de dados. Estas estruturas são usadas em chamadas para GetData(FORMATETC, STGMEDIUM) ou SetData(FORMATETC, STGMEDIUM, Boolean).
IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)	Fornece uma estrutura padrão FORMATETC logicamente equivalente a uma estrutura mais complexa. Use este método para determinar se duas estruturas diferentes FORMATETC devolveriam os mesmos dados, eliminando a necessidade de renderização duplicada.
IDataObject.GetData(FORMATETC, STGMEDIUM)	Obtém dados a partir de um objeto de origem de dados. O GetData(FORMATETC, STGMEDIUM) método, chamado por um consumidor de dados, apresenta os dados descritos na estrutura especificada FORMATETC e transfere-os através da estrutura especificada STGMEDIUM . O chamador assume então a responsabilidade de libertar a STGMEDIUM estrutura.
IDataObject.GetDataHere(FORMATETC, STGMEDIUM)	Obtém dados a partir de um objeto de origem de dados. Este método, chamado por um consumidor de dados, difere do GetData(FORMATETC, STGMEDIUM) método em que o chamador deve alocar e libertar o meio de armazenamento especificado.
IDataObject.QueryGetData(FORMATETC)	Determina se o objeto de dados é capaz de renderizar os dados descritos na FORMATETC estrutura. Objetos que tentam uma operação de colar ou drop podem chamar este método antes de chamar GetData(FORMATETC, STGMEDIUM) para obter uma indicação de se a operação pode ser bem-sucedida.
IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)	Transfere dados para o objeto que implementa este método. Este método é chamado por um objeto que contém uma fonte de dados.

Aplica-se a

Ver também

Carregar uma Amostra de Ficheiro Perdida

Comentários

Esta página foi útil?