IRemoteObjectContract.RemoteCast(String) 메서드

정의

네임스페이스:
System.AddIn.Contract.Automation
어셈블리:
System.AddIn.Contract.dll

현재 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

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

설명

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

형식이 구성 요소에 게시된 후에는 형식의 정식 이름을 변경할 수 없습니다. 구성 요소의 이후 버전에서 형식의 정식 이름을 변경하면 이미 형식을 사용하고 있는 구성 요소와 클라이언트 간의 호환성이 중단됩니다.

캐스팅 작업이 실패할 RemoteCast 경우 구현에서 throw InvalidCastException 하는 것이 좋습니다.

적용 대상