Clipboard.SetFileDropList(StringCollection) 메서드

정의

클립보드를 지운 다음 FileDrop 형식의 파일 이름 컬렉션을 추가합니다.Clears the Clipboard and then adds a collection of file names in the FileDrop format.

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 -> unit
Public Shared Sub SetFileDropList (filePaths As StringCollection)

매개 변수

filePaths
StringCollection

파일 이름을 포함하는 StringCollection입니다.A StringCollection containing the file names.

예외

클립보드를 지울 수 없는 경우.The Clipboard could not be cleared. 이 예외는 일반적으로 다른 프로세스에서 클립보드를 사용하고 있는 경우 발생합니다.This typically occurs when the Clipboard is being used by another process.

현재 스레드가 STA(단일 스레드 아파트) 모드에 있지 않은 경우.The current thread is not in single-threaded apartment (STA) mode. STAThreadAttribute를 애플리케이션의 Main 메서드에 추가합니다.Add the STAThreadAttribute to your application's Main method.

filePathsnull입니다.filePaths is null.

filePaths에 문자열이 포함되지 않은 경우filePaths does not contain any strings.

또는-or- filePaths의 문자열 중 적어도 하나가 Empty이거나, 공백만 포함하거나, InvalidPathChars에 정의된 잘못된 문자를 하나 이상 포함하거나, null이거나, 콜론(:)을 포함하거나, 시스템 정의 최대 길이를 초과하는 경우At least one of the strings in filePaths is Empty, contains only white space, contains one or more invalid characters as defined by InvalidPathChars, is null, contains a colon (:), or exceeds the system-defined maximum length.

자세한 내용은 InnerExceptionArgumentException 속성을 참조하십시오.See the InnerException property of the ArgumentException for more information.

예제

다음 예제에서는이 멤버를 보여 줍니다.The following example demonstrates this member.

// 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

설명

파일 드롭 목록이 컬렉션인 파일에 대 한 경로 정보를 포함 하는 문자열입니다.A file drop list is a collection of strings containing path information for files.

파일 드롭 목록이으로 클립보드에 저장 되는 String 배열 합니다.A file drop list is stored on the Clipboard as a String array. 이 메서드는 변환 filePathsString 배열 클립보드에 추가 해야 합니다.This method converts filePaths to a String array before adding it to the Clipboard.

클립보드에서 파일 드롭 목록이 검색 하려면 먼저 사용 합니다 ContainsFileDropList 검색 하기 전에 해당 형식의 데이터가 클립보드에 포함 되는지 여부를 결정 하는 방법의 GetFileDropList 메서드.To retrieve a file drop list from the Clipboard, first use the ContainsFileDropList method to determine whether the Clipboard contains data in that format before retrieving it with the GetFileDropList method.

참고

Clipboard 단일 스레드 아파트 (STA) 모드를 설정 하는 스레드의 클래스 에서만 사용할 수 있습니다.The Clipboard class can only be used in threads set to single thread apartment (STA) mode. 이 클래스를 사용 하려면 프로그램 Main 표시 된 메서드가 STAThreadAttribute 특성입니다.To use this class, ensure that your Main method is marked with the STAThreadAttribute attribute.

보안

UIPermission
데이터를 추가 하기 위한는 FileDrop 시스템 클립보드 형식입니다.for adding data in the FileDrop format to the system Clipboard. 연결 된 열거형: AllClipboardAssociated enumeration: AllClipboard

FileIOPermission
파일 시스템에 액세스 합니다.for access to the file system. 연결 된 열거형: PathDiscoveryAssociated enumeration: PathDiscovery

적용 대상

추가 정보