IDataObject.GetData Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
- SetData(String, Boolean, Object)
- GetDataPresent(String, Boolean)
- DataFormats
- GetFormats(Boolean)
- SetData(String, Boolean, Object)
- GetDataPresent(Type)
- GetFormats(Boolean)
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
- SetData(String, Boolean, Object)
- GetDataPresent(String, Boolean)
- DataFormats
- GetFormats(Boolean)
- SetData(String, Boolean, Object)
- GetDataPresent(Type)
- GetFormats(Boolean)
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 DataObject
oggetto 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
- SetData(String, Boolean, Object)
- GetDataPresent(String, Boolean)
- DataFormats
- GetFormats(Boolean)
- SetData(String, Boolean, Object)
- GetDataPresent(Type)
- GetFormats(Boolean)