Clipboard.SetFileDropList(StringCollection) 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

클립보드를 지운 다음 FileDrop 형식의 파일 이름 컬렉션을 추가합니다.

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입니다.

예외

ExternalException

클립보드를 지울 수 없는 경우. 이 예외는 일반적으로 다른 프로세스에서 클립보드를 사용하고 있는 경우 발생합니다.

ThreadStateException

현재 스레드가 STA(단일 스레드 아파트) 모드에 있지 않은 경우. STAThreadAttribute를 애플리케이션의 Main 메서드에 추가합니다.

ArgumentNullException

filePaths이(가) null인 경우

ArgumentException

filePaths에 문자열이 포함되지 않은 경우

또는

filePaths의 문자열 중 적어도 하나가 Empty이거나, 공백만 포함하거나, InvalidPathChars에 정의된 잘못된 문자를 하나 이상 포함하거나, null이거나, 콜론(:)을 포함하거나, 시스템 정의 최대 길이를 초과하는 경우

자세한 내용은 InnerException의 ArgumentException 속성을 참조하십시오.

예제

다음 예제에서는 이 멤버를 보여 줍니다.

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

설명

파일 드롭 목록이 컬렉션인 파일에 대 한 경로 정보를 포함 하는 문자열입니다.

파일 드롭 목록은 클립보드에 배열로 String 저장됩니다. 이 메서드는 클립보드에 String 추가하기 전에 배열로 변환합니다filePaths.

클립보드에서 파일 드롭 목록을 검색하려면 먼저 메서드를 ContainsFileDropList 사용하여 검색하기 전에 GetFileDropList 메서드를 사용하여 클립보드에 해당 형식의 데이터가 포함되어 있는지 여부를 확인합니다.

참고

Clipboard 클래스는 STA(단일 스레드 아파트) 모드로 설정된 스레드에서만 사용될 수 있습니다. 이 클래스를 사용하려면 Main 메서드가 STAThreadAttribute 특성으로 표시되었는지 확인하세요.

추가 정보

• FileDrop
• ContainsFileDropList()
• GetFileDropList()