Clipboard.SetFileDropList(StringCollection) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Limpa a prancheta e depois adiciona uma coleção de nomes de ficheiros no FileDrop formato.
public:
static void SetFileDropList(System::Collections::Specialized::StringCollection ^ filePaths);public static void SetFileDropList(System.Collections.Specialized.StringCollection filePaths);static member SetFileDropList : System.Collections.Specialized.StringCollection -> unitPublic Shared Sub SetFileDropList (filePaths As StringCollection)Parâmetros
- filePaths
- StringCollection
A StringCollection contendo os nomes dos ficheiros.
Exceções
A prancheta não pôde ser limpa. Isto ocorre tipicamente quando a Prancheta está a ser usada por outro processo.
O tópico atual não está em modo apartamento single-threaded (STA). Adicione-os STAThreadAttribute ao processo da Main sua candidatura.
filePaths é null.
filePaths não contém fios.
-ou-
Pelo menos uma das cadeias em filePaths é Empty, contém apenas espaço em branco, contém um ou mais caracteres inválidos conforme definido por InvalidPathChars, é null, contém dois pontos (:), ou excede o comprimento máximo definido pelo sistema.
Consulte a InnerException propriedade do ArgumentException para mais informações.
Exemplos
O exemplo seguinte demonstra este elemento.
// Demonstrates SetFileDropList, ContainsFileDroList, and GetFileDropList
public System.Collections.Specialized.StringCollection
SwapClipboardFileDropList(
System.Collections.Specialized.StringCollection replacementList)
{
System.Collections.Specialized.StringCollection returnList = null;
if (Clipboard.ContainsFileDropList())
{
returnList = Clipboard.GetFileDropList();
Clipboard.SetFileDropList(replacementList);
}
return returnList;
}
' Demonstrates SetFileDropList, ContainsFileDroList, and GetFileDropList
Public Function SwapClipboardFileDropList(ByVal replacementList _
As System.Collections.Specialized.StringCollection) _
As System.Collections.Specialized.StringCollection
Dim returnList As System.Collections.Specialized.StringCollection _
= Nothing
If Clipboard.ContainsFileDropList() Then
returnList = Clipboard.GetFileDropList()
Clipboard.SetFileDropList(replacementList)
End If
Return returnList
End Function
Observações
Uma lista de drop de ficheiros é uma coleção de strings que contêm informação de caminho para ficheiros.
Uma lista de ficheiros é armazenada na Área de Transferência como um String array. Este método converte filePaths para um String array antes de o adicionar à Prancheta.
Para recuperar uma lista de ficheiros a partir da Área de Transferência, use primeiro o ContainsFileDropList método para determinar se a Área de Transferência contém dados nesse formato antes de os recuperar com o GetFileDropList método.
Note
A classe Clipboard só pode ser usada em threads configurados para o modo apartamento de thread único (modo STA). Para usar essa classe, verifique se o método Main está marcado com o atributo STAThreadAttribute.
