IDataObject.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.
Bu örnekte depolanan verilerin belirtilen biçimle ilişkili olup olmadığını belirler.
Aşırı Yüklemeler
GetDataPresent(String) |
Bu örnekte depolanan verilerin belirtilen biçimle ilişkili olup olmadığını veya bu biçime dönüştürülebileceğini belirler. |
GetDataPresent(Type) |
Bu örnekte depolanan verilerin belirtilen biçimle ilişkili olup olmadığını veya bu biçime dönüştürülebileceğini belirler. |
GetDataPresent(String, Boolean) |
Bu örnekte depolanan verilerin belirtilen biçimle ilişkili olup olmadığını belirler ve verilerin biçime dönüştürülip dönüştürülmeyeceğini belirlemek için boole değeri kullanılır. |
GetDataPresent(String)
Bu örnekte depolanan verilerin belirtilen biçimle ilişkili olup olmadığını veya bu biçime dönüştürülebileceğini belirler.
public:
bool GetDataPresent(System::String ^ format);
public bool GetDataPresent (string format);
abstract member GetDataPresent : string -> bool
Public Function GetDataPresent (format As String) As Boolean
Parametreler
- format
- String
Denetlenecek biçim. Önceden tanımlanmış biçimler için bkz DataFormats .
Döndürülenler
true
Bu örnekte depolanan veriler belirtilen biçimle ilişkiliyse veya bu biçime dönüştürülebiliyorsa; aksi takdirde false
.
Örnekler
Bu örnekte yönteminin DataObject kullanımını GetDataPresent
göstermek için uygulayan IDataObject
sınıfı kullanılır. İlk olarak, bir dize ve Text
biçim kullanarak bir veri nesnesi oluşturur. Ardından verilerin biçiminde olduğunu Text
doğrular ve sonuçları bir ileti kutusunda görüntüler. Örnekte adlı Form1
bir Form oluşturduğunuz varsayılır.
private:
void TestDataObject()
{
// Creates a new data object using a string and the Text format.
String^ myString = "Hello World!";
DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );
// Checks whether the data is present in the Text format and displays the result.
if ( myDataObject->GetDataPresent( DataFormats::Text ) )
MessageBox::Show( "The stored data is in the Text format.", "Test Result" );
else
MessageBox::Show( "The stored data is not in the Text format.", "Test Result" );
}
private void TestDataObject()
{
// Creates a new data object using a string and the Text format.
string myString = "Hello World!";
DataObject myDataObject = new DataObject(DataFormats.Text, myString);
// Checks whether the data is present in the Text format and displays the result.
if (myDataObject.GetDataPresent(DataFormats.Text))
MessageBox.Show("The stored data is in the Text format." , "Test Result");
else
MessageBox.Show("The stored data is not in the Text format.", "Test Result");
}
Private Sub TestDataObject()
' Creates a new data object using a string and the Text format.
Dim myString As New String("Hello World!")
Dim myDataObject As New DataObject(DataFormats.Text, myString)
' Checks whether the data is present in the Text format and displays the result.
If (myDataObject.GetDataPresent(DataFormats.Text)) Then
MessageBox.Show("The stored data is in the Text format.", "Test Result")
Else
MessageBox.Show("The stored data is not in the Text format.", "Test Result")
End If
End Sub
Açıklamalar
çağırmadan önce bu yöntemi çağırarak GetDatabir biçimin var DataObject olup olmadığını belirleyin. Bu örnekte kullanılabilen biçimleri çağırın GetFormats .
Not
Veriler, dönüştürmeye izin verileceğini belirterek depolanmışsa ve istenen biçim depolanmış biçimle uyumluysa başka bir biçime dönüştürülebilir. Örneğin, Unicode olarak depolanan veriler metne dönüştürülebilir.
Bu yöntemin uygulanması için bkz DataObject.GetDataPresent. .
Ayrıca bkz.
Şunlara uygulanır
GetDataPresent(Type)
Bu örnekte depolanan verilerin belirtilen biçimle ilişkili olup olmadığını veya bu biçime dönüştürülebileceğini belirler.
public:
bool GetDataPresent(Type ^ format);
public bool GetDataPresent (Type format);
abstract member GetDataPresent : Type -> bool
Public Function GetDataPresent (format As Type) As Boolean
Parametreler
- format
- Type
Type Denetlenecek biçimi temsil eden. Önceden tanımlanmış biçimler için bkz DataFormats .
Döndürülenler
true
Bu örnekte depolanan veriler belirtilen biçimle ilişkiliyse veya bu biçime dönüştürülebiliyorsa; aksi takdirde , false
.
Örnekler
Bu örnekte yönteminin DataObject kullanımını GetDataPresent
göstermek için uygulayan IDataObject
sınıfı kullanılır. İlk olarak, bir bileşen oluşturur (myComponent
) ve bunu bir veri nesnesinde (myDataObject
) depolar. Ardından belirtilen verilerin içinde myDataObject
depolanıp depolanmadığını denetler. Test sonucunu true
verirse, sonucu bir ileti kutusunda ve veri türünü bir metin kutusunda görüntüler. Bu örnekte, zaten adlandırılmış ve adlandırılmış textBox1
Form1
bir FormTextBox oluşturduğunuz varsayılır.
private:
void GetDataPresent2()
{
// Creates a component to store in the data object.
Component^ myComponent = gcnew Component;
// Creates a new data object and assigns it the component.
DataObject^ myDataObject = gcnew DataObject( myComponent );
// Creates a type to store the type of data.
Type^ myType = myComponent->GetType();
// Checks whether the specified data type exists in the object.
if ( myDataObject->GetDataPresent( myType ) )
{
MessageBox::Show( "The specified data is stored in the data object." );
// Displays the type of data.
textBox1->Text = "The data type is " + myDataObject->GetData( myType )->GetType()->Name + ".";
}
else
MessageBox::Show( "The specified data is not stored in the data object." );
}
private void GetDataPresent2()
{
// Creates a component to store in the data object.
Component myComponent = new Component();
// Creates a new data object and assigns it the component.
DataObject myDataObject = new DataObject(myComponent);
// Creates a type to store the type of data.
Type myType = myComponent.GetType();
// Checks whether the specified data type exists in the object.
if (myDataObject.GetDataPresent(myType))
{
MessageBox.Show("The specified data is stored in the data object.");
// Displays the type of data.
textBox1.Text = "The data type is " + myDataObject.GetData(myType).GetType().Name + ".";
}
else
{
MessageBox.Show("The specified data is not stored in the data object.");
}
}
Private Sub GetDataPresent2()
' Creates a component to store in the data object.
Dim myComponent As New System.ComponentModel.Component()
' Creates a new data object and assigns it the component.
Dim myDataObject As New DataObject(myComponent)
'Creates a type to store the type of data.
Dim myType As Type = myComponent.GetType()
' Checks whether the specified data type exists in the object.
If myDataObject.GetDataPresent(myType) Then
MessageBox.Show("The specified data is stored in the data object.")
' Displays the type of data.
TextBox1.Text = "The data type is " & myDataObject.GetData(myType).GetType().Name & "."
Else
MessageBox.Show("The specified data is not stored in the data object.")
End If
End Sub
Açıklamalar
çağırmadan önce bu yöntemi çağırarak GetDatabir biçimin var DataObject olup olmadığını belirleyin. Bu örnekte kullanılabilen biçimleri çağırın GetFormats .
Not
Veriler, dönüştürmeye izin verileceğini belirterek depolanmışsa ve istenen biçim depolanmış biçimle uyumluysa başka bir biçime dönüştürülebilir. Örneğin, Unicode olarak depolanan veriler metne dönüştürülebilir.
Bu yöntemin uygulanması için bkz DataObject.GetDataPresent. .
Ayrıca bkz.
Şunlara uygulanır
GetDataPresent(String, Boolean)
Bu örnekte depolanan verilerin belirtilen biçimle ilişkili olup olmadığını belirler ve verilerin biçime dönüştürülip dönüştürülmeyeceğini belirlemek için boole değeri kullanılır.
public:
bool GetDataPresent(System::String ^ format, bool autoConvert);
public bool GetDataPresent (string format, bool autoConvert);
abstract member GetDataPresent : string * bool -> bool
Public Function GetDataPresent (format As String, autoConvert As Boolean) As Boolean
Parametreler
- format
- String
Denetlenecek biçim. Önceden tanımlanmış biçimler için bkz DataFormats .
- autoConvert
- Boolean
true
bu örnekte depolanan verilerin belirtilen biçime dönüştürülip dönüştürülemeyeceğini belirlemek için; false
verinin belirtilen biçimde olup olmadığını denetlemek için.
Döndürülenler
true
veriler belirtilen biçimdeyse veya bu biçime dönüştürülebiliyorsa; aksi takdirde , false
.
Örnekler
Bu örnekte yönteminin DataObject kullanımını GetDataPresent
göstermek için uygulayan IDataObject
sınıfı kullanılır. İlk olarak, bir dize ve Text
biçim kullanarak bir veri nesnesi (myDataObject
) oluşturur. Ardından, parametresi olarak ayarlanmış false
şekilde, biçimiyle autoConvert
ilişkili Text
veriler için nesnesini sorgular. Bu deneme başarısız olur ve sonuç "İleti #1" etiketli bir ileti kutusunda görüntülenir. İkinci denemede parametresini autoConvert
olarak true
ayarlar. Bu deneme başarılı olur ve sonuç "İleti #2" etiketli bir ileti kutusunda görüntülenir. Örnekte adlı Form1
bir Form oluşturduğunuz varsayılır.
private:
void GetDataPresent3()
{
// Creates a new data object using a string and the Text format.
DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"My String" );
// Checks whether the string can be displayed with autoConvert equal to false.
if ( myDataObject->GetDataPresent( "System::String", false ) )
MessageBox::Show( myDataObject->GetData( "System::String", false )->ToString(), "Message #1" );
else
MessageBox::Show( "Cannot convert data to the specified format with autoConvert set to false.", "Message #1" );
// Displays the string with autoConvert equal to true.
MessageBox::Show( "Now that autoConvert is true, you can convert " + myDataObject->GetData( "System::String", true ) + " to string format.", "Message #2" );
}
private void GetDataPresent3()
{
// Creates a new data object using a string and the Text format.
DataObject myDataObject = new DataObject(DataFormats.Text, "My String");
// Checks whether the string can be displayed with autoConvert equal to false.
if(myDataObject.GetDataPresent("System.String", false))
MessageBox.Show(myDataObject.GetData("System.String", false).ToString(), "Message #1");
else
MessageBox.Show("Cannot convert data to the specified format with autoConvert set to false.", "Message #1");
// Displays the string with autoConvert equal to true.
MessageBox.Show("Now that autoConvert is true, you can convert " +
myDataObject.GetData("System.String", true).ToString() + " to string format.","Message #2");
}
Private Sub GetDataPresent3()
' Creates a new data object using a string and the Text format.
Dim myDataObject As New DataObject(DataFormats.Text, "My String")
' Checks whether the string can be displayed with autoConvert equal to false.
If myDataObject.GetDataPresent("System.String", False) Then
MessageBox.Show(myDataObject.GetData("System.String", False).ToString() + ".", "Message #1")
Else
MessageBox.Show("Cannot convert data to the specified format with autoConvert set to false.", "Message #1")
End If
' Displays the string with autoConvert equal to true.
MessageBox.Show(("Now that autoConvert is true, you can convert " + myDataObject.GetData("System.String", _
True).ToString() + " to string format."), "Message #2")
End Sub
Açıklamalar
çağırmadan önce bu yöntemi çağırarak GetDatabir biçimin var DataObject olup olmadığını belirleyin. Bu örnekte kullanılabilen biçimleri çağırın GetFormats .
Bu yöntem şu durumlarda döndürür true
:
autoConvert
parametresidirtrue
ve veriler uygun biçime dönüştürülebilecek bir biçimdedir.autoConvert
parametresidirfalse
ve veriler uygun biçimdedir.
Bu yöntem şu durumlarda döndürür false
:
autoConvert
parametresidirtrue
ve bu yöntem belirtilen biçimdeki verileri bulamıyor ve verileri belirtilen biçime dönüştüremiyor veya veri olarak ayarlanmışfalse
olarakautoConvert
depolandı.autoConvert
parametresidirfalse
ve veriler bu örnekte belirtilen biçimde mevcut değildir.
Not
Veriler, dönüştürmeye izin verileceğini belirterek depolanmışsa ve istenen biçim depolanmış biçimle uyumluysa başka bir biçime dönüştürülebilir. Örneğin, Unicode olarak depolanan veriler metne dönüştürülebilir.
Bu yöntemin uygulanması için bkz DataObject.GetDataPresent. .