DataObject.GetDataPresent Yöntem

Tanım

Ad Alanı:: System.Windows

Bütünleştirilmiş Kod:: PresentationCore.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Verilerin belirtilen biçimde kullanılabilir veya dönüştürülebilir olup olmadığını belirler.

Aşırı Yüklemeler

Name	Description
GetDataPresent(String)	Verilerin bir dize tarafından belirtilen biçimde kullanılabilir veya dönüştürülebilir olup olmadığını belirler.
GetDataPresent(Type)	Verilerin bir nesne tarafından Type belirtilen biçimde kullanılabilir veya dönüştürülebilir olup olmadığını belirler.
GetDataPresent(String, Boolean)	Verilerin belirtilen biçimde kullanılabilir veya dönüştürülebilir olup olmadığını belirler. Bayrak `Boolean` , verilerin belirtilen biçimde kullanılabilir değilse, belirtilen biçime dönüştürülebilir olup olmadığının denetlenip denetlenmeyeceğini belirtir.

Açıklamalar

çağrısı yapılmadan önce bu veri nesnesinde bir biçimin kullanılabilir olup olmadığını belirlemek için çağrısı GetDataPresent yapın GetData. Bu veri nesnesinde kullanılabilen tüm biçimlerin listesini almak için çağrısı GetFormats yapın.

GetDataPresent(String)

Verilerin bir dize tarafından belirtilen biçimde kullanılabilir veya dönüştürülebilir olup olmadığını belirler.

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

Parametreler

format: String

Verilerin biçimini belirten bir dize. Önceden tanımlanmış veri biçimleri kümesi için sınıfına DataFormats bakın.

Döndürülenler

Boolean

true veriler belirtilen biçimdeyse veya dönüştürülebilirse; aksi takdirde , false.

Uygulamalar

GetDataPresent(String)

Özel durumlar

ArgumentNullException

format, null'e eşittir.

Örnekler

Aşağıdaki örnek, tanımlayıcı dizeye göre belirli bir veri biçiminin varlığını sorgulamak için bu yöntemi kullanır.

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

Açıklamalar

Ayrıca bkz.

Bırakılan Dosya Örneğini Yükleme

Şunlara uygulanır

GetDataPresent(Type)

Verilerin bir nesne tarafından Type belirtilen biçimde kullanılabilir veya dönüştürülebilir olup olmadığını belirler.

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

Parametreler

format: Type

Type Denetlenecek veri biçimini belirten bir. F veya önceden tanımlanmış veri biçimleri kümesine bakın DataFormats .

Döndürülenler

Boolean

true veriler belirtilen biçimdeyse veya dönüştürülebilirse; aksi takdirde , false.

Uygulamalar

GetDataPresent(Type)

Özel durumlar

ArgumentNullException

format, null'e eşittir.

Örnekler

Aşağıdaki örnek, türe göre belirli bir veri biçiminin varlığını sorgulamak için bu yöntemi kullanır.

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

Açıklamalar

Ayrıca bkz.

Bırakılan Dosya Örneğini Yükleme

Şunlara uygulanır

GetDataPresent(String, Boolean)

Verilerin belirtilen biçimde kullanılabilir veya dönüştürülebilir olup olmadığını belirler. Bayrak Boolean , verilerin belirtilen biçimde kullanılabilir değilse, belirtilen biçime dönüştürülebilir olup olmadığının denetlenip denetlenmeyeceğini belirtir.

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

Parametreler

format: String

Denetlenecek veri biçimini belirten bir dize. Önceden tanımlanmış veri biçimleri kümesi için sınıfına DataFormats bakın.

autoConvert: Boolean

false yalnızca belirtilen biçimi denetlemek için; true ayrıca bu veri nesnesinde depolanan verilerin belirtilen biçime dönüştürülip dönüştürülemeyeceğini denetlemek için.

Döndürülenler

Boolean

true veriler belirtilen biçimdeyse veya dönüştürülebilirse; aksi takdirde , false.

Uygulamalar

GetDataPresent(String, Boolean)

Özel durumlar

ArgumentNullException

format, null'e eşittir.

Örnekler

Aşağıdaki örnek, tanımlayıcı dizeye göre verileri sorgulamak için bu yöntemi kullanır ve otomatik dönüştürülebilir veri biçimlerinin nasıl ele alınıp alın gitemini belirtir.

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

Açıklamalar

Ayrıca bkz.

Bırakılan Dosya Örneğini Yükleme

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?