DataObject.GetDataPresent Método

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.

Determina se os dados estão disponíveis ou podem ser convertidos para, um formato especificado.

Sobrecargas

Name	Description
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.
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.

Observações

Chame GetDataPresent para determinar se existe um formato disponível neste objeto de dados antes de chamar GetData. Ligue GetFormats para obter uma lista de todos os formatos disponíveis neste objeto de dados.

GetDataPresent(String)

Determina se os dados estão disponíveis ou podem ser convertidos para, um formato especificado por uma cadeia.

public:
 virtual bool GetDataPresent(System::String ^ format);

public bool GetDataPresent(string format);

abstract member GetDataPresent : string -> bool
override this.GetDataPresent : string -> bool

Public Function GetDataPresent (format As String) As Boolean

Parâmetros

format: String

Uma cadeia que especifica o formato dos dados. Para um conjunto de formatos de dados pré-definidos, veja a DataFormats classe.

Devoluções

Boolean

true se os dados estiverem no formato especificado ou puderem ser convertidos; caso contrário, false.

Implementações

GetDataPresent(String)

Exceções

ArgumentNullException

format é null.

Exemplos

O exemplo seguinte utiliza este método para consultar a presença de um determinado formato de dados por cadeia de descritores.

DataObject dataObject = new DataObject("Some string data to store...");

// Query for the presence of Text data in the data object, by a data format descriptor string.
// In this overload of GetDataPresent, the method will return true both for native data formats
// and when the data can automatically be converted to the specifed format.

// In this case, string data is present natively, so GetDataPresent returns "true".
string textData = null;
if (dataObject.GetDataPresent(DataFormats.StringFormat))
{
    textData = dataObject.GetData(DataFormats.StringFormat) as string;
}

// In this case, the Text data in the data object can be autoconverted to 
// Unicode text, so GetDataPresent returns "true".
byte[] unicodeData = null;
if (dataObject.GetDataPresent(DataFormats.UnicodeText))
{
    unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}

Dim dataObject As New DataObject("Some string data to store...")

' Query for the presence of Text data in the data object, by a data format descriptor string.
' In this overload of GetDataPresent, the method will return true both for native data formats
' and when the data can automatically be converted to the specifed format.

' In this case, string data is present natively, so GetDataPresent returns "true".
Dim textData As String = Nothing
If dataObject.GetDataPresent(DataFormats.StringFormat) Then
    textData = TryCast(dataObject.GetData(DataFormats.StringFormat), String)
End If

' In this case, the Text data in the data object can be autoconverted to 
' Unicode text, so GetDataPresent returns "true".
Dim unicodeData() As Byte = Nothing
If dataObject.GetDataPresent(DataFormats.UnicodeText) Then
    unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If

Observações

Ver também

Carregar uma Amostra de Ficheiro Perdida

Aplica-se a

GetDataPresent(Type)

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

public:
 virtual bool GetDataPresent(Type ^ format);

public bool GetDataPresent(Type format);

abstract member GetDataPresent : Type -> bool
override this.GetDataPresent : Type -> bool

Public Function GetDataPresent (format As Type) As Boolean

Parâmetros

format: Type

A Type que especifica o formato de dados a verificar. F ou um conjunto de formatos de dados pré-definidos, veja a DataFormats classe.

Devoluções

Boolean

true se os dados estiverem no formato especificado ou puderem ser convertidos; caso contrário, false.

Implementações

GetDataPresent(Type)

Exceções

ArgumentNullException

format é null.

Exemplos

O exemplo seguinte utiliza este método para consultar a presença de um determinado formato de dados por tipo.

DataObject dataObject = new DataObject("Some string data to store...");

// Query for the presence of String data in the data object, by type.  In this overload 
// of GetDataPresent, the method will return true both for native data formats
// and when the data can automatically be converted to the specifed format.

// In this case, the Text data present in the data object can be autoconverted
// to type string (also represented by DataFormats.String), so GetDataPresent returns "true".
string stringData = null;
if (dataObject.GetDataPresent(typeof(string)))
{
    stringData = dataObject.GetData(DataFormats.Text) as string;
}

Dim dataObject As New DataObject("Some string data to store...")

' Query for the presence of String data in the data object, by type.  In this overload 
' of GetDataPresent, the method will return true both for native data formats
' and when the data can automatically be converted to the specifed format.

' In this case, the Text data present in the data object can be autoconverted
' to type string (also represented by DataFormats.String), so GetDataPresent returns "true".
Dim stringData As String = Nothing
If dataObject.GetDataPresent(GetType(String)) Then
    stringData = TryCast(dataObject.GetData(DataFormats.Text), String)
End If

Observações

Ver também

Carregar uma Amostra de Ficheiro Perdida

Aplica-se a

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.

public:
 virtual bool GetDataPresent(System::String ^ format, bool autoConvert);

public bool GetDataPresent(string format, bool autoConvert);

abstract member GetDataPresent : string * bool -> bool
override this.GetDataPresent : string * bool -> bool

Public Function GetDataPresent (format As String, autoConvert As Boolean) As Boolean

Parâmetros

format: String

Uma cadeia que especifica o formato de dados a verificar. Para um conjunto de formatos de dados pré-definidos, veja a DataFormats classe.

autoConvert: Boolean

false verificar apenas o formato especificado; true para também verificar se os dados armazenados neste objeto de dados podem ser convertidos para o formato especificado.

Devoluções

Boolean

true se os dados estiverem no formato especificado ou puderem ser convertidos; caso contrário, false.

Implementações

GetDataPresent(String, Boolean)

Exceções

ArgumentNullException

format é null.

Exemplos

O exemplo seguinte utiliza este método para consultar dados por cadeia de descritores, e especifica como tratar formatos de dados auto-convertíveis.

DataObject dataObject = new DataObject("Some string data to store...");

// Query for the presence of Text data in the data object, by data format descriptor string,
// and specifying whether auto-convertible data formats are acceptable.  

// In this case, Text data is present natively, so GetDataPresent returns "true".
string textData = null;
if (dataObject.GetDataPresent(DataFormats.Text, false /* Auto-convert? */))
{
    textData = dataObject.GetData(DataFormats.Text) as string;
}

// In this case, the Text data in the data object can be autoconverted to 
// Unicode text, but it is not available natively, so GetDataPresent returns "false".
byte[] unicodeData = null;
if (dataObject.GetDataPresent(DataFormats.UnicodeText, false /* Auto-convert? */))
{
    unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}

// In this case, the Text data in the data object can be autoconverted to 
// Unicode text, so GetDataPresent returns "true".
if (dataObject.GetDataPresent(DataFormats.UnicodeText, true /* Auto-convert? */))
{
    unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}

Dim dataObject As New DataObject("Some string data to store...")

' Query for the presence of Text data in the data object, by data format descriptor string,
' and specifying whether auto-convertible data formats are acceptable.  

' In this case, Text data is present natively, so GetDataPresent returns "true".
Dim textData As String = Nothing
If dataObject.GetDataPresent(DataFormats.Text, False) Then ' Auto-convert? 
    textData = TryCast(dataObject.GetData(DataFormats.Text), String)
End If

' In this case, the Text data in the data object can be autoconverted to 
' Unicode text, but it is not available natively, so GetDataPresent returns "false".
Dim unicodeData() As Byte = Nothing
If dataObject.GetDataPresent(DataFormats.UnicodeText, False) Then ' Auto-convert? 
    unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If

' In this case, the Text data in the data object can be autoconverted to 
' Unicode text, so GetDataPresent returns "true".
If dataObject.GetDataPresent(DataFormats.UnicodeText, True) Then ' Auto-convert? 
    unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If

Observações

Ver também

Carregar uma Amostra de Ficheiro Perdida

Aplica-se a

Comentários

Esta página foi útil?