DataObject.GetDataPresent Yöntem

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.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.

Bu DataObject depolanan verilerin belirtilen biçimle ilişkili olup olmadığını belirler.

Aşırı Yüklemeler

GetDataPresent(String)	Bu DataObject depolanan verilerin belirtilen biçimle ilişkili olup olmadığını veya bu biçime dönüştürülebileceğini belirler.
GetDataPresent(Type)	Bu DataObject 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 DataObject belirtilen biçimde veri içerip içermediğini veya isteğe bağlı olarak, belirtilen biçime dönüştürülebilecek veriler içerip içermediğini belirler.

GetDataPresent(String)

Bu DataObject depolanan verilerin belirtilen biçimle ilişkili olup olmadığını veya bu biçime dönüştürülebileceğini belirler.

public:
 virtual bool GetDataPresent(System::String ^ format);

public virtual bool GetDataPresent (string format);

abstract member GetDataPresent : string -> bool
override this.GetDataPresent : string -> bool

Public Overridable 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

Boolean

Bu DataObject depolanan verilerin belirtilen biçimle ilişkilendirilip ilişkilendirilmediğini veya dönüştürülebileceğini true; aksi takdirde, false.

Uygulamalar

GetDataPresent(String)

Örnekler

Aşağıdaki kod örneği, şu anda bu DataObject depolanan verilerin belirtilen biçimle ilişkilendirilip ilişkilendirilmediğini veya bu biçime dönüştürülebileceğini belirler. Yeni bir DataObject bir dize ve metin olarak belirtilen ilişkili biçimiyle başlatılır.

Ardından örnekler, metin verilerinin DataObjectvar olup olmadığını yazdırır. Bu kod, textBox1 oluşturulmasını gerektirir.

Açıklamalar

GetDataçağırmadan önce bir biçimin mevcut olup olmadığını belirlemek için bu yöntemi çağır. Bu DataObjectkullanılabilen biçimler için GetFormats çağırın.

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.

Not

Hiçbir veri alınamıyorsa, hiçbir özel durum oluşturulmayacak. Bunun yerine false döndürülür.

Ayrıca bkz.

Şunlara uygulanır

GetDataPresent(Type)

Bu DataObject depolanan verilerin belirtilen biçimle ilişkili olup olmadığını veya bu biçime dönüştürülebileceğini belirler.

public:
 virtual bool GetDataPresent(Type ^ format);

public virtual bool GetDataPresent (Type format);

abstract member GetDataPresent : Type -> bool
override this.GetDataPresent : Type -> bool

Public Overridable Function GetDataPresent (format As Type) As Boolean

Parametreler

format: Type

Denetlenecek biçimi temsil eden bir Type.

Döndürülenler

Boolean

Bu DataObject depolanan verilerin belirtilen biçimle ilişkilendirilip ilişkilendirilmediğini veya dönüştürülebileceğini true; aksi takdirde, false.

Uygulamalar

GetDataPresent(Type)

Örnekler

Aşağıdaki kod örneği, belirtilen türdeki verilerin bir DataObjectiçinde var olup olmadığını veya verilerin belirtilen türe dönüştürülip dönüştürülemeyeceğini belirler. Sonuç bir metin kutusunda görüntülenir. Kod, textBox1 oluşturulmasını gerektirir.

private:
   void GetIfPresent2()
   {
      // 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();
      
      // Determines if the DataObject has data of the Type format.
      textBox1->Text = String::Concat( "Is the specified data type available ",
         "in the DataObject? ", myDataObject->GetDataPresent( myType ), "\n" );
      
      // Retrieves the data using its type format, and displays the type.
      Object^ myObject = myDataObject->GetData( myType );
      textBox1->Text = String::Concat( textBox1->Text, "The data type stored ",
         "in the DataObject is: ", myObject->GetType()->Name );
   }

private void GetIfPresent2() {
    // 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();
 
    // Determines if the DataObject has data of the Type format.
    textBox1.Text = "Is the specified data type available in the " +
       "DataObject? " + myDataObject.GetDataPresent(myType).ToString() + '\n';
 
    // Retrieves the data using its type format, and displays the type.
    Object myObject = myDataObject.GetData(myType);
    textBox1.Text += "The data type stored in the DataObject is: " +
       myObject.GetType().Name;
 }

Private Sub GetIfPresent2()
    ' Creates a component to store in the data object.
    Dim myComponent As New 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()
    
    ' Determines if the DataObject has data of the Type format.
    textBox1.Text = "Is the specified data type available in the " & "DataObject? " & _
        myDataObject.GetDataPresent(myType).ToString() & ControlChars.Cr
    
    ' Retrieves the data using its type format, and displays the type.
    Dim myObject As Object = myDataObject.GetData(myType)
    textBox1.Text += "The data type stored in the DataObject is: " + myObject.GetType().Name
End Sub

Açıklamalar

GetDataçağırmadan önce bir biçimin mevcut olup olmadığını belirlemek için bu yöntemi çağır. Bu DataObjectkullanılabilen biçimler için GetFormats çağırın.

Not

Hiçbir veri alınamıyorsa, hiçbir özel durum oluşturulmayacak. Bunun yerine false döndürülür.

Ayrıca bkz.

Şunlara uygulanır

GetDataPresent(String, Boolean)

Bu DataObject belirtilen biçimde veri içerip içermediğini veya isteğe bağlı olarak, belirtilen biçime dönüştürülebilecek veriler içerip içermediğini belirler.

public:
 virtual bool GetDataPresent(System::String ^ format, bool autoConvert);

public virtual bool GetDataPresent (string format, bool autoConvert);

abstract member GetDataPresent : string * bool -> bool
override this.GetDataPresent : string * bool -> bool

Public Overridable 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

Bu DataObject depolanan verilerin belirtilen biçime dönüştürülip dönüştürülemeyeceğini belirlemek için true; Verilerin belirtilen biçimde olup olmadığını denetlemek için false.

Döndürülenler

Boolean

Verilerin belirtilen biçimde olup olmadığını veya dönüştürülebileceğini true; aksi takdirde false.

Uygulamalar

GetDataPresent(String, Boolean)

Örnekler

Aşağıdaki kod örneği, şu anda DataObject depolanan verilerin belirtilen bir biçimle ilişkilendirilip ilişkilendirilmemiş olduğunu belirler. İlk olarak, yeni bir DataObject, biçimini metin olarak belirterek bir dizeyle başlatılır.

Ardından DataObject, metin biçimiyle ilişkili veriler için sorgulanır ve autoConvert parametresi falseolarak belirtilir. Bu sorgunun sonucu bir metin kutusuna yazdırılır.

Ardından DataObject, dize biçimiyle ilişkili veriler için sorgulanır ve autoConvert parametresi trueolarak belirtilir. Sonuçlar metin kutusuna yazdırılır. Bu kod, textBox1 oluşturulmasını gerektirir.

private:
   void GetIfPresent3()
   {
      // Creates a new data object using a string and the text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text, "Another string" );
      
      // Prints the string in a text box with autoconvert = false.
      if ( myDataObject->GetDataPresent( "System.String", false ) )
      {
         // Prints the string in a text box.
         textBox1->Text = String::Concat(
            myDataObject->GetData( "System.String", false )->ToString(), "\n" );
      }
      else
      {
         textBox1->Text = "Could not convert data to specified format\n";
      }
      
      // Prints the string in a text box with autoconvert = true.
      textBox1->Text = String::Concat( textBox1->Text,
         "With autoconvert = true, you can convert text to string format. String is: ",
         myDataObject->GetData( "System.String", true )->ToString() );
   }

private void GetIfPresent3() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "Another string");
 
    // Prints the string in a text box with autoconvert = false.
    if(myDataObject.GetDataPresent("System.String", false)) {
       // Prints the string in a text box.
       textBox1.Text = myDataObject.GetData("System.String", false).ToString() + '\n';
    } else
        {
            textBox1.Text = "Could not convert data to specified format" + '\n';
        }

        // Prints the string in a text box with autoconvert = true.
        textBox1.Text += "With autoconvert = true, you can convert text to string format. " +
       "String is: " + myDataObject.GetData("System.String", true).ToString();
 }

Private Sub GetIfPresent3()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "Another string")
    
    ' Prints the string in a text box with autoconvert = false.
    If myDataObject.GetDataPresent("System.String", False) Then
        ' Prints the string in a text box.
        textBox1.Text = myDataObject.GetData("System.String", False).ToString() & ControlChars.Cr
    Else
        textBox1.Text = "Could not convert data to specified format" & ControlChars.Cr
    End If 
    ' Prints the string in a text box with autoconvert = true.
    textBox1.Text &= "With autoconvert = true, you can convert text to string format. " & _
                    "String is: " & myDataObject.GetData("System.String", True).ToString()
End Sub

Açıklamalar

GetDataçağırmadan önce bir biçimin mevcut olup olmadığını belirlemek için bu yöntemi çağır. Bu DataObjectkullanılabilen biçimler için GetFormats çağırın.

Bu yöntem aşağıdaki durumlarda true döndürür:

autoConvert parametresi true ve veriler uygun biçime dönüştürülebilecek bir biçimdedir.
autoConvert parametresi false ve veriler uygun biçimdedir.

Bu yöntem aşağıdaki durumlarda false döndürür:

autoConvert parametresi true ve bu yöntem verileri belirtilen biçimde bulamıyor ve verileri belirtilen biçime dönüştüremiyor veya otomatik dönüştürme ile falseolarak ayarlandı.
autoConvert parametresi false ve bu DataObject belirtilen biçimde veri yok.

Not

Veriler, dönüştürmeye izin verilip verilmediğini belirterek depolandıysa 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.

Not

Hiçbir veri alınamıyorsa, hiçbir özel durum oluşturulmayacak. Bunun yerine false döndürülür.

Ayrıca bkz.

Şunlara uygulanır

Aracılığıyla paylaş

DataObject.GetDataPresent Yöntem

Tanım

Aşırı Yüklemeler

GetDataPresent(String)

Parametreler

Döndürülenler

Uygulamalar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

GetDataPresent(Type)

Parametreler

Döndürülenler

Uygulamalar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

GetDataPresent(String, Boolean)

Parametreler

Döndürülenler

Uygulamalar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar