IDataObject.GetData Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Belirtilen veri biçimiyle ilişkili verileri alır.

Aşırı Yüklemeler

Name	Description
GetData(String)	Belirtilen veri biçimiyle ilişkili verileri alır.
GetData(Type)	Belirtilen sınıf türü biçimiyle ilişkili verileri alır.
GetData(String, Boolean)	Verilerin biçime dönüştürülip dönüştürülmeyeceğini belirlemek için boole kullanarak belirtilen veri biçimiyle ilişkili verileri alır.

GetData(String)

Kaynak:

IDataObject.cs

Belirtilen veri biçimiyle ilişkili verileri alır.

public:
 System::Object ^ GetData(System::String ^ format);

public object? GetData(string format);

abstract member GetData : string -> obj

Public Function GetData (format As String) As Object

Parametreler

format

String

Alınacak verilerin biçimi. Önceden tanımlanmış biçimler için bkz DataFormats .

Döndürülenler

Object

Belirtilen biçim nullveya ile ilişkili veriler.

Örnekler

Bu örnek, yönteminin DataObject kullanımını göstermek için uygulayan IDataObject, sınıfını GetData kullanır. yöntemi, biçiminde depolanan myDataObjectText verileri almak için kullanılır. Örnekte zaten adlandırılmış ve adlandırılmış FormForm1 bir TextBoxtextBox1 oluşturduğunuz varsayılır.

private:
   void GetData1()
   {
      // Creates a new data object using a string and the text format.
      String^ myString = "My text string";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );

      // Displays the string in a text box.
      textBox1->Text = myDataObject->GetData( DataFormats::Text )->ToString();
   }

private void GetData1() 
{
    // Creates a new data object using a string and the text format.
    string myString = "My text string";
    DataObject myDataObject = new DataObject(DataFormats.Text, myString);

    // Displays the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString();
}

Private Sub GetData1()
    ' Creates a new data object using a string and the text format.
    Dim myString As String = "My text string"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Displays the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString()
End Sub

Açıklamalar

Bu yöntem verileri belirtilen biçimde bulamazsa, verileri biçime dönüştürmeye çalışır. Veriler belirtilen biçime dönüştürülemiyorsa, bu yöntem döndürür null.

Verilerin ile ilişkilendirilip ilişkilendirilmediğini veya biçime dönüştürülebileceğini belirlemek için çağrısı yapılmadan önce öğesini arayın GetDataPresentGetData. Bu örnekte depolanan veriler için geçerli biçimlerin listesini çağırın GetFormats .

Note

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.GetData. .

Ayrıca bkz.

• SetData(String, Boolean, Object)
• GetDataPresent(String, Boolean)
• DataFormats
• GetFormats(Boolean)
• SetData(String, Boolean, Object)
• GetDataPresent(Type)
• GetFormats(Boolean)

GetData(Type)

Kaynak:

IDataObject.cs

Belirtilen sınıf türü biçimiyle ilişkili verileri alır.

public:
 System::Object ^ GetData(Type ^ format);

public object? GetData(Type format);

abstract member GetData : Type -> obj

Public Function GetData (format As Type) As Object

Parametreler

format

Type

Type Alınacak verilerin biçimini temsil eden bir. Önceden tanımlanmış biçimler için bkz DataFormats .

Döndürülenler

Object

Belirtilen biçim nullveya ile ilişkili veriler.

Örnekler

Bu örnekte yönteminin DataObject kullanımını göstermek için öğesini uygulayan IDataObjectsınıfı kullanılır GetData . yöntemi, içinde depolanan myObjectve belirli bir tür myTypeolan ile ilişkili verileri almak için kullanılır. Alınan verilerin türü bir ileti kutusunda görüntülenir. Örnekte zaten adlı Formbir Form1 oluşturduğunuz varsayılır.

private:
   void GetData2()
   {
      // Creates a component.
      Component^ myComponent = gcnew Component;

      // Creates a data object, and assigns it the component.
      DataObject^ myDataObject = gcnew DataObject( myComponent );

      // Creates a type, myType, to store the type of data.
      Type^ myType = myComponent->GetType();

      // Retrieves the data using myType to represent its type.
      Object^ myObject = myDataObject->GetData( myType );
      if ( myObject != nullptr )
            MessageBox::Show( "The data type stored in the data object is " +
                  myObject->GetType()->Name + "." );
      else
            MessageBox::Show( "Data of the specified type was not stored in the data object." );
   }

       private void GetData2() 
       {
           // Creates a component.
           Component myComponent = new Component();

           // Creates a data object, and assigns it the component.
           DataObject myDataObject = new DataObject(myComponent);

           // Creates a type, myType, to store the type of data.
           Type myType = myComponent.GetType();

           // Retrieves the data using myType to represent its type.
           Object myObject = myDataObject.GetData(myType);
           if(myObject != null)
               MessageBox.Show("The data type stored in the data object is " +
                   myObject.GetType().Name + ".");
           else
               MessageBox.Show("Data of the specified type was not stored " +
                   "in the data object.");
       }

Private Sub GetData2()
    ' Creates a component.
    Dim myComponent As New System.ComponentModel.Component()

    ' Creates a data object, and assigns it the component.
    Dim myDataObject As New DataObject(myComponent)

    ' Creates a type, myType, to store the type of data.
    Dim myType As Type = myComponent.GetType()

    ' Retrieves the data using myType to represent its type.
    Dim myObject As [Object] = myDataObject.GetData(myType)
    If (myObject IsNot Nothing) Then
        MessageBox.Show("The data type stored in the data object is " + myObject.GetType().Name + ".")
    Else
        MessageBox.Show("Data of the specified type was not stored " + "in the data object.")
    End If
End Sub

Açıklamalar

Bu yöntem verileri belirtilen biçimde bulamazsa, verileri biçime dönüştürmeye çalışır. Veriler belirtilen biçime dönüştürülemiyorsa, bu yöntem döndürür null.

Verilerin ile ilişkilendirilip ilişkilendirilmediğini veya biçime dönüştürülebileceğini belirlemek için çağrısı yapılmadan önce öğesini arayın GetDataPresentGetData. Bu örnekte depolanan veriler için geçerli biçimlerin listesini çağırın GetFormats .

Note

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.GetData. .

Ayrıca bkz.

• SetData(String, Boolean, Object)
• GetDataPresent(String, Boolean)
• DataFormats
• GetFormats(Boolean)
• SetData(String, Boolean, Object)
• GetDataPresent(Type)
• GetFormats(Boolean)

GetData(String, Boolean)

Kaynak:

IDataObject.cs

Verilerin biçime dönüştürülip dönüştürülmeyeceğini belirlemek için boole kullanarak belirtilen veri biçimiyle ilişkili verileri alır.

public:
 System::Object ^ GetData(System::String ^ format, bool autoConvert);

public object? GetData(string format, bool autoConvert);

abstract member GetData : string * bool -> obj

Public Function GetData (format As String, autoConvert As Boolean) As Object

Parametreler

format

String

Alınacak verilerin biçimi. Önceden tanımlanmış biçimler için bkz DataFormats .

autoConvert

Boolean

true verileri belirtilen biçime dönüştürmek için; aksi takdirde , false.

Döndürülenler

Object

Belirtilen biçim nullveya ile ilişkili veriler.

Örnekler

Bu örnekte yönteminin DataObject kullanımını göstermek için öğesini uygulayan IDataObjectsınıfı kullanılır GetData . Örnek, veri biçiminin dönüştürülip dönüştürülmeyeceğini belirtmek için parametresini DataObject kullanarak içinde autoConvertdepolanan verileri alır. İlk olarak, myDataObject metin verileriyle oluşturulur. Daha sonra örnek, verileri almak için iki kez dener. İlk denemede, biçimini dize olarak belirtir ve parametresini autoConvert olarak falseayarlar. Bu deneme başarısız olur ve sonuç "İleti #1" etiketli bir ileti kutusunda görüntülenir. İkinci denemede örnek, parametresi olarak ayarlanmış autoConvertolan true aynı verileri alır. Bu deneme başarılı olur ve sonuç "İleti #2" etiketli bir ileti kutusunda görüntülenir. Örnekte adlı Formbir Form1 oluşturduğunuz varsayılır.

private:
   void GetData3()
   {
      // Creates a new data object using a text string.
      String^ myString = "Hello World!";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );

      // Displays the string with autoConvert equal to false.
      if ( myDataObject->GetData( "System::String", false ) != nullptr )
      {
         // Displays the string in a message box.
         MessageBox::Show( myDataObject->GetData( "System::String", false ) + ".", "Message #1" );
      }
      else
            MessageBox::Show( "Could not find data of the specified format.", "Message #1" );

      // Displays a not found message in a message box.
      // Displays the string in a text box with autoConvert equal to true.
      String^ myData = "The data is " + myDataObject->GetData( "System::String", true ) + ".";
      MessageBox::Show( myData, "Message #2" );
   }

       private void GetData3() 
       {
           // Creates a new data object using a text string.
           string myString = "Hello World!";
           DataObject myDataObject = new DataObject(DataFormats.Text, myString);

           // Displays the string with autoConvert equal to false.
           if (myDataObject.GetData("System.String", false) != null) 
           {
               // Displays the string in a message box.
               MessageBox.Show(myDataObject.GetData("System.String", false).ToString() + ".", "Message #1");
           } 
           else
           {
               // Displays a not found message in a message box.
               MessageBox.Show("Could not find data of the specified format.", "Message #1");
           }

           // Displays the string in a text box with autoConvert equal to true.
           string myData = "The data is " + myDataObject.GetData("System.String", true).ToString() +".";
           MessageBox.Show(myData,"Message #2");
       }

Private Sub GetData3()
    ' Creates a new data object using a text string.
    Dim myString As String = "Hello World!"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Displays the string with autoConvert equal to false.
    If (myDataObject.GetData("System.String", False) IsNot Nothing) Then
        ' Displays the string in a message box.
        MessageBox.Show(myDataObject.GetData("System.String", False).ToString() + ".", "Message #1")
        ' Displays a not found message in a message box.
    Else
        MessageBox.Show("Could not find data of the specified format.", "Message #1")
    End If

    ' Displays the string in a text box with autoConvert equal to true.
    Dim myData As String = "The data is " + myDataObject.GetData("System.String", True).ToString()
    MessageBox.Show(myData, "Message #2")
End Sub

Açıklamalar

autoConvert parametresi ise true ve bu yöntem verileri belirtilen biçimde bulamazsa, verileri biçime dönüştürmeye çalışır. Veriler belirtilen biçime dönüştürülemiyorsa veya veriler parametresi olarak ayarlanmış olarak depolanmışsaautoConvert, bu yöntem döndürürfalse.null

autoConvert parametresi isefalse, bu yöntem belirtilen biçimde veri döndürür veya null bu biçimde veri bulunamaz.

Verilerin ile ilişkilendirilip ilişkilendirilmediğini veya biçime dönüştürülebileceğini belirlemek için çağrısı yapılmadan önce öğesini arayın GetDataPresentGetData. Bu örnekte depolanan veriler için geçerli biçimlerin listesini çağırın GetFormats .

Note

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.GetData. .

Ayrıca bkz.

• SetData(String, Boolean, Object)
• GetDataPresent(String, Boolean)
• DataFormats
• GetFormats(Boolean)
• SetData(String, Boolean, Object)
• GetDataPresent(Type)
• GetFormats(Boolean)