DataObject.GetData Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Belirtilen veri biçimiyle ilişkili verileri döndürür.

Aşırı Yüklemeler

GetData(String, Boolean)

Verilerin biçime dönüştürülip dönüştürülmeyeceğini belirlemek için otomatik dönüştürme parametresini kullanarak belirtilen veri biçimiyle ilişkili verileri döndürür.
GetData(String)

Belirtilen veri biçimiyle ilişkili verileri döndürür.
GetData(Type)

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

GetData(String, Boolean)

Verilerin biçime dönüştürülip dönüştürülmeyeceğini belirlemek için otomatik dönüştürme parametresini kullanarak belirtilen veri biçimiyle ilişkili verileri döndürür.

public:
 virtual System::Object ^ GetData(System::String ^ format, bool autoConvert);
public virtual object GetData (string format, bool autoConvert);
public virtual object? GetData (string format, bool autoConvert);
abstract member GetData : string * bool -> obj
override this.GetData : string * bool -> obj
Public Overridable 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ürme; aksi takdirde , false.

Döndürülenler

Object

Belirtilen biçimle ilişkili veriler veya null.

Uygulamalar

GetData(String, Boolean)

Örnekler

Aşağıdaki kod örneği, veri biçiminin dönüştürülip dönüştürülmeyeceğini belirtmek için parametresini autoConvert kullanarak içinde DataObjectdepolanan verileri alır.

İlk olarak, metin verileriyle yeni DataObject bir oluşturulur. Daha sonra örnek verileri almaya çalışır ve biçimini dize olarak belirtir ve biçim dönüştürmesi yoktur, autoConvert yani parametresi olur false. içinde dize verisi DataObjectolmadığından bu işlem başarısız oluyor.

Daha sonra örnek, parametresi olarak ayarlanmış trueşekilde autoConvert verileri yeniden almayı dener. Bu işlem başarılı olur ve sonuçlar içinde MessageBoxgörüntülenir.

Bu kod oluşturulmasını gerektirir textBox1 .

private:
   void GetMyData3()
   {
      // Creates a new data object using a string and the text format.
      String^ myString = "My new text string";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );
      
      // Prints the string in a text box with autoconvert = false.
      if ( myDataObject->GetData( "System.String", false ) != 0 )
      {
         // Prints the string in a text box.
         textBox1->Text = String::Concat(
            myDataObject->GetData( "System.String", false )->ToString(), "\n" );
      }
      else
      {
         textBox1->Text = "Could not find data of the specified format\n";
      }
      
      // Prints the string in a text box with autoconvert = true.
      textBox1->Text = String::Concat(
            textBox1->Text, myDataObject->GetData( "System.String", true )->ToString() );
   }

private void GetMyData3() {
    // Creates a new data object using a string and the text format.
    string myString = "My new text string";
    DataObject myDataObject = new DataObject(DataFormats.Text, myString);
 
    // Prints the string in a text box with autoconvert = false.
    if(myDataObject.GetData("System.String", false) != null) {
       // Prints the string in a text box.
       textBox1.Text = myDataObject.GetData("System.String", false).ToString() + '\n';
    } else
        {
            textBox1.Text = "Could not find data of the specified format" + '\n';
        }

        // Prints the string in a text box with autoconvert = true.
        textBox1.Text += myDataObject.GetData("System.String", true).ToString();
 }

Private Sub GetMyData3()
    ' Creates a new data object using a string and the text format.
    Dim myString As String = "My new text string"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)
    
    ' Prints the string in a text box with autoconvert = false.
    If (myDataObject.GetData("System.String", False) IsNot Nothing) Then
        ' Prints the string in a text box.
        textBox1.Text = myDataObject.GetData("System.String", False).ToString() & ControlChars.Cr
    Else
        textBox1.Text = "Could not find data of the specified format" & ControlChars.Cr
    End If 
    ' Prints the string in a text box with autoconvert = true.
    textBox1.Text += myDataObject.GetData("System.String", True).ToString()
End Sub

Açıklamalar

autoConvert parametresi ise true ve bu yöntem verileri belirtilen biçimde bulamazsa, verileri biçime dönüştürmeyi dener. Veriler belirtilen biçime dönüştürülemiyorsa veya veriler otomatik dönüştürme olarak ayarlandıysa false, bu yöntem döndürür null.

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

Verilerin ile ilişkilendirilip ilişkilendirilmediğini veya biçime dönüştürülebileceğini belirlemek için çağrısı GetDatayapmadan önce öğesini arayınGetDataPresent. Bu DataObjectiçinde depolanan veriler için geçerli biçimlerin listesini çağırınGetFormats.

Not

Veriler, bu dönüştürmeye izin verilip verilmediğ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.

olduğunda formatHtml, bu yöntem .NET 4.5 veya üzerini hedefleyen uygulamalarda UTF-8 ile kodlanmış bir dize ve .NET 4.0 veya daha düşük bir sürümü hedefleyen uygulamalarda ANSI kodlanmış bir dize döndürür.

Ayrıca bkz.

Şunlara uygulanır

GetData(String)

Belirtilen veri biçimiyle ilişkili verileri döndürür.

public:
 virtual System::Object ^ GetData(System::String ^ format);
public virtual object GetData (string format);
public virtual object? GetData (string format);
abstract member GetData : string -> obj
override this.GetData : string -> obj
Public Overridable 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çimle ilişkili veriler veya null.

Uygulamalar

GetData(String)

Örnekler

Aşağıdaki kod örneği, içinde DataObjectdepolanan verileri alır. İlk olarak, metin verileriyle yeni DataObject bir oluşturulur. Ardından veriler alınır ve biçimi dize olarak belirtilir ve metin kutusunda görüntülenir.

Bu kod oluşturulmasını gerektirir textBox1 .

private:
   void AddMyData3()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;
      
      // Creates a new data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Adds the component to the DataObject.
      myDataObject->SetData( myComponent );
      
      // Prints whether data of the specified type is in the DataObject.
      Type^ myType = myComponent->GetType();
      if ( myDataObject->GetDataPresent( myType ) )
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is present in the DataObject" );
      }
      else
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is not present in the DataObject" );
      }
   }

private void AddMyData3() {
    // Creates a component to store in the data object.
    Component myComponent = new Component();
 
    // Creates a new data object.
    DataObject myDataObject = new DataObject();
 
    // Adds the component to the DataObject.
    myDataObject.SetData(myComponent);
 
    // Prints whether data of the specified type is in the DataObject.
    Type myType = myComponent.GetType();
    if(myDataObject.GetDataPresent(myType))
       textBox1.Text = "Data of type " + myType.ToString() + 
       " is present in the DataObject";
    else
       textBox1.Text = "Data of type " + myType.ToString() +
       " is not present in the DataObject";
 }

Private Sub AddMyData3()
    ' Creates a component to store in the data object.
    Dim myComponent As New Component()
    
    ' Creates a new data object.
    Dim myDataObject As New DataObject()
    
    ' Adds the component to the DataObject.
    myDataObject.SetData(myComponent)
    
    ' Prints whether data of the specified type is in the DataObject.
    Dim myType As Type = myComponent.GetType()
    If myDataObject.GetDataPresent(myType) Then
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is present in the DataObject"
    Else
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is not present in the DataObject"
    End If
End Sub

Açıklamalar

Bu yöntem verileri belirtilen biçimde bulamazsa, verileri biçime dönüştürmeyi dener. Veriler belirtilen biçime dönüştürülemiyorsa veya veriler otomatik dönüştürme olarak ayarlandıysa false, 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ı GetDatayapmadan önce öğesini arayınGetDataPresent. Bu DataObjectiçinde depolanan veriler için geçerli biçimlerin listesini çağırınGetFormats.

Not

Veriler, bu dönüştürmeye izin verilip verilmediğ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.

olduğunda formatHtml, bu yöntem .NET 4.5 veya üzerini hedefleyen uygulamalarda UTF-8 ile kodlanmış bir dize ve .NET 4.0 veya daha düşük bir sürümü hedefleyen uygulamalarda ANSI kodlanmış bir dize döndürür.

Ayrıca bkz.

Şunlara uygulanır

GetData(Type)

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

public:
 virtual System::Object ^ GetData(Type ^ format);
public virtual object GetData (Type format);
public virtual object? GetData (Type format);
abstract member GetData : Type -> obj
override this.GetData : Type -> obj
Public Overridable Function GetData (format As Type) As Object

Parametreler

format
Type

Type Alınacak verilerin biçimini temsil eden bir.

Döndürülenler

Object

Belirtilen biçimle ilişkili veriler veya null.

Uygulamalar

GetData(Type)

Örnekler

Aşağıdaki kod örneği, içinde DataObjectdepolanan verileri alır. İlk olarak, bir bileşenle yeni DataObject bir oluşturulur. Ardından veriler alınır ve türü belirtilir. Alınan verilerin türü bir metin kutusunda görüntülenir.

Bu kod oluşturulmasını gerektirir textBox1 .

private:
   void GetMyData()
   {
      // 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();
      
      // Retrieves the data using myType to represent its type.
      Object^ myObject = myDataObject->GetData( myType );
      if ( myObject != nullptr )
      {
         textBox1->Text = String::Format( "The data type stored in the DataObject is: {0}",
            myObject->GetType()->Name );
      }
      else
      {
         textBox1->Text = "Data of the specified type was not stored in the DataObject.";
      }
   }

private void GetMyData() {
    // 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();
 
    // Retrieves the data using myType to represent its type.
    Object myObject = myDataObject.GetData(myType);
    if(myObject != null)
       textBox1.Text = "The data type stored in the DataObject is: " +
       myObject.GetType().Name;
    else
       textBox1.Text = "Data of the specified type was not stored " +
       "in the DataObject.";
 }

Private Sub GetMyData()
    ' 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()
    
    ' Retrieves the data using myType to represent its type.
    Dim myObject As Object = myDataObject.GetData(myType)
    If (myObject IsNot Nothing) Then
        textBox1.Text = "The data type stored in the DataObject is: " & myObject.GetType().Name
    Else
        textBox1.Text = "Data of the specified type was not stored " & "in the DataObject."
    End If
End Sub

Açıklamalar

Bu yöntem verileri belirtilen biçimde bulamazsa, verileri biçime dönüştürmeyi dener. Veriler belirtilen biçime dönüştürülemiyorsa veya veriler otomatik dönüştürme olarak ayarlandıysa false, 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ı GetDatayapmadan önce öğesini arayınGetDataPresent. Bu DataObjectiçinde depolanan veriler için geçerli biçimlerin listesini çağırınGetFormats.

Not

Veriler, bu dönüştürmeye izin verilip verilmediğ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.

Ayrıca bkz.

Şunlara uygulanır