DataObject.GetDataPresent Metode

Definisi

Ruang nama:: System.Windows

Rakitan:: PresentationCore.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menentukan apakah data tersedia di, atau dapat dikonversi ke, format tertentu.

Overload

Nama	Deskripsi
GetDataPresent(String)	Menentukan apakah data tersedia di, atau dapat dikonversi ke, format yang ditentukan oleh string.
GetDataPresent(Type)	Menentukan apakah data tersedia di, atau dapat dikonversi ke, format yang ditentukan oleh Type objek.
GetDataPresent(String, Boolean)	Menentukan apakah data tersedia di, atau dapat dikonversi ke, format tertentu. Bendera `Boolean` menunjukkan apakah akan memeriksa apakah data dapat dikonversi ke format yang ditentukan jika tidak tersedia dalam format tersebut.

Keterangan

Panggil GetDataPresent untuk menentukan apakah format tersedia dalam objek data ini sebelum memanggil GetData. Panggil GetFormats untuk mendapatkan daftar semua format yang tersedia di objek data ini.

GetDataPresent(String)

Menentukan apakah data tersedia di, atau dapat dikonversi ke, format yang ditentukan oleh string.

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

Parameter

format: String

String yang menentukan format untuk data. Untuk sekumpulan format data yang telah ditentukan sebelumnya, lihat DataFormats kelas .

Mengembalikan

Boolean

true jika data berada, atau dapat dikonversi ke, format yang ditentukan; jika tidak, false.

Penerapan

GetDataPresent(String)

Pengecualian

ArgumentNullException

format adalah null.

Contoh

Contoh berikut menggunakan metode ini untuk mengkueri keberadaan format data tertentu menurut string deskriptor.

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

Keterangan

Lihat juga

Memuat Sampel File yang Dihilangkan

Berlaku untuk

GetDataPresent(Type)

Menentukan apakah data tersedia di, atau dapat dikonversi ke, format yang ditentukan oleh Type objek.

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

Parameter

format: Type

Type Yang menentukan format data untuk diperiksa. F atau sekumpulan format data yang telah ditentukan sebelumnya, lihat DataFormats kelas .

Mengembalikan

Boolean

true jika data berada, atau dapat dikonversi ke, format yang ditentukan; jika tidak, false.

Penerapan

GetDataPresent(Type)

Pengecualian

ArgumentNullException

format adalah null.

Contoh

Contoh berikut menggunakan metode ini untuk mengkueri keberadaan format data tertentu menurut jenis.

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

Keterangan

Lihat juga

Memuat Sampel File yang Dihilangkan

Berlaku untuk

GetDataPresent(String, Boolean)

Menentukan apakah data tersedia di, atau dapat dikonversi ke, format tertentu. Bendera Boolean menunjukkan apakah akan memeriksa apakah data dapat dikonversi ke format yang ditentukan jika tidak tersedia dalam format tersebut.

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

Parameter

format: String

String yang menentukan format data untuk diperiksa. Untuk sekumpulan format data yang telah ditentukan sebelumnya, lihat DataFormats kelas .

autoConvert: Boolean

false untuk memeriksa hanya format yang ditentukan; true untuk juga memeriksa apakah data yang disimpan dalam objek data ini dapat dikonversi ke format yang ditentukan.

Mengembalikan

Boolean

true jika data berada, atau dapat dikonversi ke, format yang ditentukan; jika tidak, false.

Penerapan

GetDataPresent(String, Boolean)

Pengecualian

ArgumentNullException

format adalah null.

Contoh

Contoh berikut menggunakan metode ini untuk mengkueri data menurut string deskriptor, dan menentukan cara memperlakukan format data yang dapat dikonversi otomatis.

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

Keterangan

Lihat juga

Memuat Sampel File yang Dihilangkan

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?