RoleEnvironment 클래스
이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

RoleEnvironment 클래스

 

업데이트 날짜: 2013년 12월

실행 중인 역할 인스턴스 상태, 끝점 및 구성에 대한 정보를 제공합니다.

네임스페이스:   Microsoft.WindowsAzure.ServiceRuntime
어셈블리:  Microsoft.WindowsAzure.ServiceRuntime.dll의 Microsoft.WindowsAzure.ServiceRuntime

System::Object
  Microsoft.WindowsAzure.ServiceRuntime::RoleEnvironment

[WindowsAzureHostingPermissionAttribute(SecurityAction::LinkDemand, 
	Unrestricted = true)]
public ref class RoleEnvironment sealed 

이름설명
System_CAPS_pubpropertySystem_CAPS_staticCurrentRoleInstance

코드가 현재 실행되는 역할 인스턴스를 나타내는 RoleInstance 개체를 가져옵니다.

System_CAPS_pubpropertySystem_CAPS_staticDeploymentId

역할 인스턴스가 실행되는 배포의 고유 식별자를 가져옵니다.

System_CAPS_pubpropertySystem_CAPS_staticIsAvailable

Microsoft Azure 환경에서 역할 인스턴스가 실행 중인지 여부를 나타냅니다.

System_CAPS_pubpropertySystem_CAPS_staticIsEmulated

역할 인스턴스가 실행 되 고 있는지 여부를 나타냅니다는 Microsoft Azure 계산 에뮬레이터합니다.

System_CAPS_pubpropertySystem_CAPS_staticRoles

집합을 가져옵니다 Role 호스팅된 서비스에 대해 정의 된 개체입니다.

이름설명
System_CAPS_pubmethodEquals(Object^)

(Object에서 상속됨.)

System_CAPS_pubmethodSystem_CAPS_staticGetConfigurationSettingValue(String^)

서비스 구성 파일의 설정 값을 검색합니다.

System_CAPS_pubmethodGetHashCode()

(Object에서 상속됨.)

System_CAPS_pubmethodSystem_CAPS_staticGetLocalResource(String^)

지정된 로컬 저장소 리소스를 검색합니다.

System_CAPS_pubmethodGetType()

(Object에서 상속됨.)

System_CAPS_pubmethodSystem_CAPS_staticRequestRecycle()

현재 역할 인스턴스를 중지했다가 다시 시작하도록 요청합니다.

System_CAPS_pubmethodToString()

(Object에서 상속됨.)

이름설명
System_CAPS_pubfieldSystem_CAPS_staticTraceSource

이름설명
System_CAPS_pubeventSystem_CAPS_staticChanged

실행 중인 역할 인스턴스에 서비스 구성 변경 내용을 적용하고 나면 발생합니다.

System_CAPS_pubeventSystem_CAPS_staticChanging

실행 중인 역할 인스턴스에 서비스 구성 변경 내용을 적용하기 전에 발생합니다.

System_CAPS_pubeventSystem_CAPS_staticSimultaneousChanged

실행 중인 역할 인스턴스에 서비스 구성의 동시 변경 내용을 적용하고 나면 발생합니다. 동시 변경 내용은 모든 역할 인스턴스에 동시에 적용됩니다.

System_CAPS_pubeventSystem_CAPS_staticSimultaneousChanging

실행 중인 역할 인스턴스에 서비스 구성의 동시 변경 내용을 적용하기 전에 발생합니다. 동시 변경 내용은 모든 역할 인스턴스에 동시에 적용됩니다.

System_CAPS_pubeventSystem_CAPS_staticStatusCheck

역할 인스턴스 상태를 나타내기 위해 일정한 간격으로 발생합니다.

System_CAPS_pubeventSystem_CAPS_staticStopping

역할 인스턴스를 중지하려고 하면 발생합니다.

사용 하면는 RoleEnvironment 클래스 구성 설정, 로컬 저장소 리소스 및 지정 된 역할 인스턴스에 대 한 끝점 정보를 얻을 수 있습니다. 이 클래스는 역할 인스턴스가 구성 변경에 응답하고 역할 인스턴스 중지 시 알림을 받을 수 있도록 하는 이벤트도 제공합니다.

System_CAPS_note참고

Microsoft Azure 1.3 이상 버전에서는 "RdRoleID"와 같이 "RD" 문자로 시작하는 환경 변수를 자체적으로 사용할 수 있도록 예약합니다. 응용 프로그램 특정 상황에서는 "RD"로 시작 하는 환경 변수를 만드는 경우이 IsAvailable 속성은 반환 false, 기타 메서드 및 속성의는 RoleEnvironment 클래스 "역할 검색 데이터를 사용할 수 없습니다." 오류 메시지가 발생 합니다 이 문제를 해결하려면 "RD" 문자로 시작하지 않는 환경 변수를 사용합니다.

System_CAPS_note참고

RoleEnvironment 클래스 외부 Azure 역할에서 Azure VM에서 독립 실행형 구성 요소에 사용할 수 있습니다. 이러한 구성 요소는 원격 인스턴스로 원격 실행하여 명령줄에서 구성 요소를 시작하는 등의 방법으로 실행할 수 있는 프로그램일 수 있습니다. 이러한 프로세스에 액세스 하려면 상승 된 권한으로 실행 해야는 RoleEnvironment 클래스입니다.

다음 코드 예제에는 get 및 구성 설정을 사용 하 여 MySetting 호출에 대 한 값을 작성 하는 방법을 보여줍니다는 GetConfigurationSettingValue 메서드:


var settingValue = RoleEnvironment.GetConfigurationSettingValue("MySetting"); Trace.WriteLine("The setting value is: " + settingValue, "Information");

정의 하 고 설정을 구성 하는 방법에 대 한 자세한 내용은 참조 Windows Azure Service Configuration SchemaWindows Azure Service Definition Schema.

다음 코드 예제에서는 로컬 저장소 리소스를 검색하고 텍스트 파일을 해당 리소스에 작성하는 방법을 보여 줍니다.


// Retrieve an object that points to the local storage resource LocalResource localResource = RoleEnvironment.GetLocalResource("localStoreTwo"); //Define the file name and path string[] paths = { localResource.RootPath, "MyStorageTest.txt"}; String filePath = Path.Combine(paths); using (FileStream writeStream = File.Create(filePath)) { Byte[] textToWrite = new UTF8Encoding(true).GetBytes("Testing Web role storage"); writeStream.Write(textToWrite, 0, textToWrite.Length); }

다음 코드 예제에서는 현재 역할 인스턴스에 대한 끝점 정보를 검색하는 방법을 보여 줍니다.


var roleInstance = RoleEnvironment.CurrentRoleInstance; foreach (RoleInstanceEndpoint instanceEndpoint in roleInstance.InstanceEndpoints.Values) { Trace.WriteLine("Instance endpoint address and port: " + instanceEndpoint.IPEndpoint, "Information"); Trace.WriteLine("Protocol for the endpoint: " + , instanceEndpoint.Protocol, "Information"); }

다음 코드 예제에서는 역할 인스턴스에 적용된 구성 변경 내용을 검색하는 방법을 보여 줍니다.


public override bool OnStart() { RoleEnvironment.Changed += RoleEnvironmentChanged; return base.OnStart(); } private void RoleEnvironmentChanged(object sender, RoleEnvironmentChangedEventArgs e) { // Get the list of configuration changes var settingChanges = e.Changes.OfType<RoleEnvironmentConfigurationSettingChange>(); foreach (var settingChange in settingChanges) { var message = "Setting: " + settingChange.ConfigurationSettingName; Trace.WriteLine(message, "Information"); } }

ServiceDefinition.csdef 파일에서 역할에 대해 내부 끝점이 정의되어 있는 경우에만 이벤트가 발생합니다. 끝점을 정의 하는 방법에 대 한 자세한 내용은 참조 합니다.3c806d3f-e335-4b1e-8a03-115bae2b3aab

이 형식의 모든 public static (Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

맨 위로 이동
표시:
© 2016 Microsoft