DataObject.GetDataPresent Yöntem

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

PresentationCore.dll

Verilerin belirtilen biçimde kullanılıp kullanılamayacağını veya dönüştürülebileceğini belirler.

Aşırı Yüklemeler

GetDataPresent(String)	Verilerin bir dize tarafından belirtilen biçimde kullanılıp kullanılamayacağını veya dönüştürülebileceğini belirler.
GetDataPresent(Type)	Verilerin bir nesne tarafından Type belirtilen biçimde kullanılıp kullanılamayacağını veya dönüştürülebileceğini belirler.
GetDataPresent(String, Boolean)	Verilerin belirtilen biçimde kullanılıp kullanılamayacağını veya dönüştürülebileceğini belirler. Bayrak Boolean , verilerin belirtilen biçimde yoksa belirtilen biçime dönüştürülip dönüştürülemeyeceğinin denetlenip denetlenmeyeceğini gösterir.

Açıklamalar

çağrısı GetDataPresent yapmadan önce bu veri nesnesinde bir biçimin kullanılabilir olup olmadığını belirlemek için çağrısı 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ılıp kullanılamayacağını veya dönüştürülebileceğini 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 bu biçime dönüştürülebiliyorsa; aksi takdirde , false.

Uygulamalar

GetDataPresent(String)

Özel durumlar

ArgumentNullException

format, null değeridir.

Örnekler

Aşağıdaki örnek, tanımlayıcı dizesine 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

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

Ayrıca bkz.

• Bırakılan Dosya Örneği Yükleme

GetDataPresent(Type)

Verilerin bir nesne tarafından Type belirtilen biçimde kullanılıp kullanılamayacağını veya dönüştürülebileceğini 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ümesi, sınıfına DataFormats bakın.

Döndürülenler

Boolean

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

Uygulamalar

GetDataPresent(Type)

Özel durumlar

ArgumentNullException

format, null değeridir.

Ö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

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

Ayrıca bkz.

• Bırakılan Dosya Örneği Yükleme

GetDataPresent(String, Boolean)

Verilerin belirtilen biçimde kullanılıp kullanılamayacağını veya dönüştürülebileceğini belirler. Bayrak Boolean , verilerin belirtilen biçimde yoksa belirtilen biçime dönüştürülip dönüştürülemeyeceğinin denetlenip denetlenmeyeceğini gösterir.

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 bu biçime dönüştürülebiliyorsa; aksi takdirde , false.

Uygulamalar

GetDataPresent(String, Boolean)

Özel durumlar

ArgumentNullException

format, null değeridir.

Ö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 işlendiği 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

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

Ayrıca bkz.

• Bırakılan Dosya Örneği Yükleme