다음을 통해 공유


IRemoteObjectContract.RemoteCast(String) 메서드

정의

현재 IRemoteObjectContract가 식별하는 개체를 지정된 형식으로 캐스팅합니다.

public:
 System::AddIn::Contract::RemoteArgument RemoteCast(System::String ^ canonicalName);
public System.AddIn.Contract.RemoteArgument RemoteCast (string canonicalName);
abstract member RemoteCast : string -> System.AddIn.Contract.RemoteArgument
Public Function RemoteCast (canonicalName As String) As RemoteArgument

매개 변수

canonicalName
String

개체를 캐스팅할 형식의 정식 이름입니다.

반환

캐스트 작업의 결과를 나타내는 RemoteArgument입니다.

설명

정식 이름은 전역적으로 고유한 이름을 GUID와 같은 경우 어셈블리 이름> 형식 < 의 문자열, <정규화된 형식 이름을> 사용하는 것이 좋습니다. 권장 되는 형식의 정식 이름 예로 "ShapeApp의 경우 Microsoft.VisualStudio.Tools.Applications.Samples.ShapeApp.Application"입니다.

형식의 canonical 이름을 형식이 구성 요소에서 게시 된 후에 변경할 수 없습니다. 형식 종류를 이미 사용 하는 클라이언트 구성 요소와 구성 요소 나누기 호환성의 이후 버전에서 정식 이름을 변경 합니다.

것이 좋습니다 RemoteCast 구현은 throw는 InvalidCastException 캐스트 작업이 실패 한 경우.

적용 대상