DataObject.GetDataPresent Yöntem
Tanım
Ö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ı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 |
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 -> boolPublic Function GetDataPresent (format As String) As BooleanParametreler
- 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
true veriler belirtilen biçimdeyse veya bu biçime dönüştürülebiliyorsa; aksi takdirde , false.
Uygulamalar
Özel durumlar
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.
Şunlara uygulanır
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 -> boolPublic Function GetDataPresent (format As Type) As BooleanParametreler
- 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
true veriler belirtilen biçimdeyse veya bu biçime dönüştürülebiliyorsa; aksi takdirde , false.
Uygulamalar
Özel durumlar
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.
Şunlara uygulanır
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 -> boolPublic Function GetDataPresent (format As String, autoConvert As Boolean) As BooleanParametreler
- 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
true veriler belirtilen biçimdeyse veya bu biçime dönüştürülebiliyorsa; aksi takdirde , false.
Uygulamalar
Özel durumlar
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.
