내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

StorageFolder.CreateFileAsync(String, CreationCollisionOption) | createFileAsync(String, CreationCollisionOption) Method

현재 폴더에 새 파일을 만들고 현재 폴더에 동일한 이름의 파일이 이미 있는 경우 수행할 작업을 지정합니다.

구문


storageFolder.createFileAsync(desiredName, options).done( /* 성공 및 오류 처리기 */ );

매개 변수

desiredName

유형: String [JavaScript] | System.String [.NET] | Platform::String [C++]

만들 파일의 원하는 이름입니다.

desiredName이 이미 지정된 현재 폴더에 기존 파일이 있는 경우 CreationCollisionOption은 Windows가 충돌에 대응하는 방법을 결정합니다.

options

유형: CreationCollisionOption

desiredName이 현재 폴더의 기존 파일 이름과 동일한 경우 Windows에서 응답하는 방식을 결정하는 열거형 값입니다.

반환 값

유형: IAsyncOperation<StorageFile>

이 메서드가 완료되면 새 파일이 StorageFile로 반환됩니다.

설명

라이브러리 또는 파일 그룹과 같은 가상 폴더에 파일을 만들려고 하면 이 메서드는 실패할 수 있습니다.

예제

파일 액세스 샘플에서는 createFileAsync(String, CreationCollisionOption) 메서드를 사용하여 다음과 같은 문서 라이브러리에 새 파일을 만드는 방법을 보여 줍니다.


Windows.Storage.KnownFolders.documentsLibrary.createFileAsync("sample.txt",
    Windows.Storage.CreationCollisionOption.replaceExisting).then(function (file) {
        sampleFile = file;
    });

샘플에 나와 있는 대로, then 또는 done을 사용하여 새 파일을 캡처 및 처리하는 함수를 선언할 수 있습니다. createFileAsync(String, CreationCollisionOption) 메서드가 완료된 후 새 파일이 처리 함수에 StorageFile 개체(샘플의 file)로 전달됩니다.

참고  문서 라이브러리에서 파일을 만들려면 앱 매니페스트에서 필요한 기능을 선언해야 합니다. Windows 런타임을 사용하여 사용자 리소스에 액세스에서 기능에 대해 자세히 알아 보십시오.

요구 사항

지원되는 최소 클라이언트

Windows 8

지원되는 최소 서버

Windows Server 2012

지원되는 최소 전화

Windows Phone 8

네임스페이스

Windows.Storage
Windows::Storage [C++]

메타데이터

Windows.winmd

참고 항목

StorageFolder
CreateFileAsync(String)

 

 

표시:
© 2014 Microsoft