IRemoteObjectContract.RemoteCast(String) 메서드

정의

현재 IRemoteObjectContract가 식별하는 개체를 지정된 형식으로 캐스팅합니다.Casts the object identified by the current IRemoteObjectContract to a specified type.

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

개체를 캐스팅할 형식의 정식 이름입니다.The canonical name of the type to cast the object to.

반환

RemoteArgument

캐스트 작업의 결과를 나타내는 RemoteArgument입니다.A RemoteArgument that represents the result of the cast operation.

설명

정식 이름은 전역적으로 고유한 이름을 GUID와 같은 경우A canonical name is a globally unique name, such as a GUID. 형식의 문자열을 지정 <assembly name> 하는 <fully qualified type name> 것이 좋습니다.Strings in the format <assembly name>, <fully qualified type name> are recommended. 권장 되는 형식의 정식 이름 예로 "ShapeApp의 경우 Microsoft.VisualStudio.Tools.Applications.Samples.ShapeApp.Application"입니다.An example of the recommended format of a canonical name is "ShapeApp, Microsoft.VisualStudio.Tools.Applications.Samples.ShapeApp.Application".

형식의 canonical 이름을 형식이 구성 요소에서 게시 된 후에 변경할 수 없습니다.The canonical name for a type cannot change after a type is published in a component. 형식 종류를 이미 사용 하는 클라이언트 구성 요소와 구성 요소 나누기 호환성의 이후 버전에서 정식 이름을 변경 합니다.Changing the canonical name of a type in a future version of a component breaks compatibility between the component and clients that are already using the type.

것이 좋습니다 RemoteCast 구현은 throw는 InvalidCastException 캐스트 작업이 실패 한 경우.It is recommended that RemoteCast implementations throw an InvalidCastException if the cast operation fails.

적용 대상