다음을 통해 공유


MoveRecord 메서드(ADO)

Record가 나타내는 엔터티를 다른 위치로 이동합니다.

구문

  
Record.MoveRecord (Source, Destination, UserName, Password, Options, Async)  

매개 변수

원본
(선택 사항) 이동할 Record를 식별하는 URL이 포함된 String 값입니다. Source를 생략하거나 빈 문자열을 지정하면 이 Record에서 나타내는 개체가 이동됩니다. 예를 들어 Record가 파일을 나타내는 경우 파일의 내용은 Destination에서 지정한 위치로 이동됩니다.

대상
선택 사항입니다. Source가 이동할 위치를 지정하는 URL이 포함된 String 값입니다.

UserName
(선택 사항) 필요한 경우 Destination에 대한 액세스 권한을 부여하는 사용자 ID를 포함하는 String 값입니다.

암호
(선택 사항) 필요한 경우 UserName을 확인하는 암호를 포함하는 String입니다.

옵션
(선택 사항) 기본값이 adMoveUnspecifiedMoveRecordOptionsEnum 값입니다. 이 메서드의 동작을 지정합니다.

비동기
(선택 사항) True인 경우 이 작업이 비동기적이어야 한다고 지정하는 부울 값입니다.

반환 값

문자열 값입니다. 일반적으로 Destination 값이 반환됩니다. 그러나 반환되는 정확한 값은 공급자에 따라 다릅니다.

설명

SourceDestination의 값은 동일하지 않아야 합니다. 그렇지 않으면 런타임 오류가 발생합니다. 적어도 서버, 경로, 리소스 이름은 달라야 합니다.

인터넷 게시 공급자를 사용하여 이동한 파일의 경우 이 메서드는 옵션에서 달리 지정하지 않는 한 이동 중인 파일의 모든 하이퍼텍스트 링크를 업데이트합니다. adMoveOverWrite를 지정하지 않는 한 Destination에서 기존 개체(예: 파일 또는 디렉터리)를 식별하면 이 메서드가 실패합니다.

참고

adMoveOverWrite 옵션을 신중하게 사용합니다. 예를 들어 디렉터리에 파일을 이동할 때 이 옵션을 지정하면 디렉터리가 삭제되고 해당 파일로 바뀝니다.

Record 개체의 특정 특성(예: ParentURL 속성)은 이 작업이 완료된 후에 업데이트되지 않습니다. Record를 닫아 Record 개체의 속성을 새로 고친 다음, 파일 또는 디렉터리가 이동된 위치의 URL을 사용하여 다시 엽니다.

레코드 집합에서 이 레코드를 가져온 경우 이동된 파일 또는 디렉터리의 새 위치는 레코드 집합에 즉시 반영되지 않습니다. 레코드 집합을 닫았다가 다시 열어 레코드 집합을 새로 고칩니다.

참고

http 체계를 사용하는 URL은 Microsoft OLE DB Provider for Internet Publishing을 자동으로 호출합니다. 자세한 내용은 절대 URL 및 상대 URL을 참조하세요.

적용 대상

레코드 개체(ADO)

참고 항목

Move 메서드(ADO)
MoveFirst, MoveLast, MoveNext 및 MovePrevious 메서드(ADO)
MoveFirst, MoveLast, MoveNext 및 MovePrevious 메서드(RDS)