DataObject.GetFormats 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.
Restituisce un elenco di tutti i formati ai quali sono associati i dati memorizzati in questa classe DataObject o nei quali possono essere convertiti.
Overload
GetFormats() |
Restituisce un elenco di tutti i formati ai quali sono associati i dati memorizzati in questa classe DataObject o nei quali possono essere convertiti. |
GetFormats(Boolean) |
Restituisce un elenco di tutti i formati ai quali sono associati i dati memorizzati in questa classe DataObject o nei quali possono essere convertiti, utilizzando un parametro di conversione automatica per determinare se recuperare tutti quelli in cui i dati possono essere convertiti oppure solo i formati nativi. |
GetFormats()
Restituisce un elenco di tutti i formati ai quali sono associati i dati memorizzati in questa classe DataObject o nei quali possono essere convertiti.
public:
virtual cli::array <System::String ^> ^ GetFormats();
public virtual string[] GetFormats ();
abstract member GetFormats : unit -> string[]
override this.GetFormats : unit -> string[]
Public Overridable Function GetFormats () As String()
Restituisce
Matrice di tipo String contenente un elenco di tutti i formati supportati dai dati memorizzati in questo oggetto.
Implementazioni
Esempio
Nell'esempio di codice seguente viene eseguita una query su un DataObject oggetto per i formati associati ai dati e sui formati in cui è possibile convertire i dati. L'elenco risultante viene visualizzato in una casella di testo. Questo codice richiede che textBox1
sia stato creato.
private:
void GetAllFormats()
{
// Creates a new data object using a string and the text format.
DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"Another string" );
// Gets all the data formats and data conversion formats in the DataObject.
array<String^>^ arrayOfFormats = myDataObject->GetFormats();
// Prints the results.
textBox1->Text = "The format(s) associated with the data are: \n";
for ( int i = 0; i < arrayOfFormats->Length; i++ )
{
textBox1->Text = String::Concat( textBox1->Text, arrayOfFormats[ i ], "\n" );
}
}
private void GetAllFormats() {
// Creates a new data object using a string and the text format.
DataObject myDataObject = new DataObject(DataFormats.Text, "Another string");
// Gets all the data formats and data conversion formats in the DataObject.
String[] arrayOfFormats = myDataObject.GetFormats();
// Prints the results.
textBox1.Text = "The format(s) associated with the data are: " + '\n';
for(int i=0; i<arrayOfFormats.Length; i++)
textBox1.Text += arrayOfFormats[i] + '\n';
}
Private Sub GetAllFormats()
' Creates a new data object using a string and the text format.
Dim myDataObject As New DataObject(DataFormats.Text, "Another string")
' Gets all the data formats and data conversion formats in the DataObject.
Dim arrayOfFormats As String() = myDataObject.GetFormats()
' Prints the results.
textBox1.Text = "The format(s) associated with the data are: " & ControlChars.Cr
Dim i As Integer
For i = 0 To arrayOfFormats.Length - 1
textBox1.Text += arrayOfFormats(i) & ControlChars.Cr
Next i
End Sub
Commenti
Chiamare questo metodo per ottenere i formati di dati supportati prima di chiamare GetData. Vedere DataFormats per i formati predefiniti.
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.
Vedi anche
Si applica a
GetFormats(Boolean)
Restituisce un elenco di tutti i formati ai quali sono associati i dati memorizzati in questa classe DataObject o nei quali possono essere convertiti, utilizzando un parametro di conversione automatica per determinare se recuperare tutti quelli in cui i dati possono essere convertiti oppure solo i formati nativi.
public:
virtual cli::array <System::String ^> ^ GetFormats(bool autoConvert);
public virtual string[] GetFormats (bool autoConvert);
abstract member GetFormats : bool -> string[]
override this.GetFormats : bool -> string[]
Public Overridable Function GetFormats (autoConvert As Boolean) As String()
Parametri
- autoConvert
- Boolean
true
per recuperare tutti i formati ai quali sono associati i dati memorizzati in questa classe DataObject o nei quali possono essere convertiti; false
per recuperare solo i formati nativi dei dati.
Restituisce
Matrice di tipo String contenente un elenco di tutti i formati supportati dai dati memorizzati in questo oggetto.
Implementazioni
Esempio
Nell'esempio di codice seguente viene richiesto un DataObject oggetto per i formati associati ai dati. La prima query specifica il autoConvert
parametro come false
, quindi viene restituito solo il formato nativo dei dati. La seconda query specifica il autoConvert
parametro come true
, quindi l'elenco di formati include i formati in cui i dati possono essere convertiti.
Questo codice richiede che textBox1
sia stato creato.
private:
void GetAllFormats2()
{
// Creates a new data object using a string and the text format.
DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"Another string" );
// Gets the original data formats in the DataObject.
array<String^>^ arrayOfFormats = myDataObject->GetFormats( false );
// Prints the results.
textBox1->Text = "The format(s) associated with the data are: \n";
for ( int i = 0; i < arrayOfFormats->Length; i++ )
{
textBox1->Text = String::Concat( textBox1->Text, arrayOfFormats[ i ], "\n" );
}
// Gets the all data formats and data conversion formats for the DataObject.
arrayOfFormats = myDataObject->GetFormats( true );
// Prints the results.
textBox1->Text = String::Concat( textBox1->Text , "The data formats and conversion ",
"format(s) associated with the data are: \n" );
for ( int i = 0; i < arrayOfFormats->Length; i++ )
{
textBox1->Text = String::Concat( textBox1->Text, arrayOfFormats[ i ], "\n" );
}
}
private void GetAllFormats2() {
// Creates a new data object using a string and the text format.
DataObject myDataObject = new DataObject(DataFormats.Text, "Another string");
// Gets the original data formats in the DataObject.
String[] arrayOfFormats = myDataObject.GetFormats(false);
// Prints the results.
textBox1.Text = "The format(s) associated with the data are: " + '\n';
for(int i=0; i<arrayOfFormats.Length; i++)
textBox1.Text += arrayOfFormats[i] + '\n';
// Gets the all data formats and data conversion formats for the DataObject.
arrayOfFormats = myDataObject.GetFormats(true);
// Prints the results.
textBox1.Text += "The data formats and conversion format(s) associated with " +
"the data are: " + '\n';
for(int i=0; i<arrayOfFormats.Length; i++)
textBox1.Text += arrayOfFormats[i] + '\n';
}
Private Sub GetAllFormats2()
' Creates a new data object using a string and the text format.
Dim myDataObject As New DataObject(DataFormats.Text, "Another string")
' Gets the original data formats in the DataObject.
Dim arrayOfFormats As String() = myDataObject.GetFormats(False)
' Prints the results.
textBox1.Text = "The format(s) associated with the data are: " & ControlChars.Cr
Dim i As Integer
For i = 0 To arrayOfFormats.Length - 1
textBox1.Text += arrayOfFormats(i) + ControlChars.Cr
Next i
' Gets the all data formats and data conversion formats for the DataObject.
arrayOfFormats = myDataObject.GetFormats(True)
' Prints the results.
textBox1.Text += "The data formats and conversion format(s) associated with " & _
"the data are: " & ControlChars.Cr
For i = 0 To arrayOfFormats.Length - 1
textBox1.Text += arrayOfFormats(i) + ControlChars.Cr
Next i
End Sub
Commenti
Chiamare questo metodo per ottenere i formati di dati supportati prima di chiamare GetData. Vedere DataFormats per i formati predefiniti.
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.