Condividi tramite


IDataObject.GetData Metodo

Definizione

Recupera i dati associati al formato dati specificato.

Overload

GetData(String)

Recupera i dati associati al formato dati specificato.

GetData(Type)

Recupera i dati associati al formato del tipo di classe specificato.

GetData(String, Boolean)

Recupera i dati associati al formato dati specificato, utilizzando un valore Boolean per determinare se convertire i dati in tale formato.

GetData(String)

Recupera i dati associati al formato dati specificato.

public:
 System::Object ^ GetData(System::String ^ format);
public object GetData (string format);
public object? GetData (string format);
abstract member GetData : string -> obj
Public Function GetData (format As String) As Object

Parametri

format
String

Formato dei dati da recuperare. Per i formati predefiniti, vedere DataFormats.

Restituisce

Dati associati al formato specificato, oppure null.

Esempio

In questo esempio viene utilizzata la DataObject classe , che implementa IDataObject, per illustrare l'uso del GetData metodo . Il metodo viene usato per recuperare i dati archiviati in myDataObject, associato al Text formato . Nell'esempio si presuppone che sia già stato creato un Form denominato Form1 e un TextBox denominato textBox1.

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

Commenti

Se questo metodo non riesce a trovare dati nel formato specificato, tenta di convertire i dati nel formato . Se i dati non possono essere convertiti nel formato specificato, questo metodo restituisce null.

Per determinare se i dati sono associati o possono essere convertiti in un formato, chiamare prima di chiamare GetDataPresentGetData. Chiamare GetFormats per un elenco di formati validi per i dati archiviati in questa istanza.

Nota

I dati possono essere convertiti in un altro formato se sono stati archiviati specificando che la conversione è consentita e se il formato richiesto è compatibile con il formato archiviato. Ad esempio, i dati archiviati come Unicode possono essere convertiti in testo.

Per un'implementazione di questo metodo, vedere DataObject.GetData.

Vedi anche

Si applica a

GetData(Type)

Recupera i dati associati al formato del tipo di classe specificato.

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

Parametri

format
Type

Oggetto Type che rappresenta il formato dei dati da recuperare. Per i formati predefiniti, vedere DataFormats.

Restituisce

Dati associati al formato specificato, oppure null.

Esempio

In questo esempio viene utilizzata la DataObject classe , che implementa IDataObject, per illustrare l'uso del GetData metodo . Il metodo viene usato per recuperare i dati archiviati in myObject, che è associato a un tipo specifico, myType. Il tipo di dati recuperati viene visualizzato in una finestra di messaggio. Nell'esempio si presuppone che sia già stato creato un Form oggetto denominato Form1.

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

Commenti

Se questo metodo non riesce a trovare dati nel formato specificato, tenta di convertire i dati nel formato . Se i dati non possono essere convertiti nel formato specificato, questo metodo restituisce null.

Per determinare se i dati sono associati o possono essere convertiti in un formato, chiamare prima di chiamare GetDataPresentGetData. Chiamare GetFormats per un elenco di formati validi per i dati archiviati in questa istanza.

Nota

I dati possono essere convertiti in un altro formato se sono stati archiviati specificando che la conversione è consentita e se il formato richiesto è compatibile con il formato archiviato. Ad esempio, i dati archiviati come Unicode possono essere convertiti in testo.

Per un'implementazione di questo metodo, vedere DataObject.GetData.

Vedi anche

Si applica a

GetData(String, Boolean)

Recupera i dati associati al formato dati specificato, utilizzando un valore Boolean per determinare se convertire i dati in tale formato.

public:
 System::Object ^ GetData(System::String ^ format, bool autoConvert);
public object GetData (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

Parametri

format
String

Formato dei dati da recuperare. Per i formati predefiniti, vedere DataFormats.

autoConvert
Boolean

true per convertire i dati nel formato specificato; in caso contrario, false.

Restituisce

Dati associati al formato specificato, oppure null.

Esempio

In questo esempio viene utilizzata la DataObject classe , che implementa IDataObject, per illustrare l'uso del GetData metodo . Nell'esempio vengono recuperati i dati archiviati in un DataObjectoggetto utilizzando il autoConvert parametro per specificare se convertire o meno il formato di dati. Prima di tutto, myDataObject viene creato con i dati di testo. L'esempio tenta quindi due volte di recuperare i dati. Nella prima versione di valutazione, specifica il formato come stringa e imposta il autoConvert parametro su false. Questa versione di valutazione ha esito negativo e il risultato viene visualizzato in una finestra di messaggio con l'etichetta "Messaggio n. 1". Nella seconda versione di valutazione l'esempio recupera gli stessi dati con il autoConvert parametro impostato su true. La versione di valutazione ha esito positivo e il risultato viene visualizzato in una finestra di messaggio con l'etichetta "Messaggio n. 2". Nell'esempio si presuppone che sia stato creato un Form oggetto denominato Form1.

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

Commenti

Se il autoConvert parametro è true e questo metodo non riesce a trovare dati nel formato specificato, tenta di convertire i dati nel formato. Se i dati non possono essere convertiti nel formato specificato o se i dati sono stati archiviati con il autoConvert parametro impostato su false, questo metodo restituisce null.

Se il autoConvert parametro è false, questo metodo restituisce dati nel formato specificato o null se non è possibile trovare dati in questo formato.

Per determinare se i dati sono associati o possono essere convertiti in un formato, chiamare prima di chiamare GetDataPresentGetData. Chiamare GetFormats per un elenco di formati validi per i dati archiviati in questa istanza.

Nota

I dati possono essere convertiti in un altro formato se sono stati archiviati specificando che la conversione è consentita e se il formato richiesto è compatibile con il formato archiviato. Ad esempio, i dati archiviati come Unicode possono essere convertiti in testo.

Per un'implementazione di questo metodo, vedere DataObject.GetData.

Vedi anche

Si applica a