이 항목은 Windows Workflow Foundation 4에 적용됩니다.
이 샘플에서는 ExternalizedPolicy4 활동을 통해 WF 3.5에서 제공되는 규칙 엔진을 사용하여 .NET Framework 버전 4 Windows Workflow Foundation(WF 4)에서 직접 기존 .NET Framework 버전 3.5 Windows Workflow Foundation(WF 3.5) RuleSet 개체를 실행하는 방법을 보여 줍니다. 이 활동을 사용하여 기존 WF 3.5 RuleSet을 열고 실행할 수 있습니다. Windows Workflow Foundation의 일부로 포함된 WF 3.5 규칙 엔진에 대한 자세한 내용은 Introduction to the Windows Workflow Foundation Rules Engine을 참조하십시오. .NET Framework 4에서 규칙을 WF로 마이그레이션하는 방법에 대한 자세한 내용은 마이그레이션 지침을 참조하십시오.
이 샘플의 프로젝트
프로젝트 이름 |
설명 |
기본 파일 |
ExternalizedPolicy4 |
ExternalizedPolicy4 활동과 이 활동의 WF 4 디자이너가 들어 있습니다. |
ExternalizedPolicy4.cs: 활동 정의입니다. ExternalizedPolicy4Designer.xaml: ExternalizedPolicy4 활동에 대한 사용자 지정 디자이너입니다. 이 디자이너는 WF 3.5 규칙 엔진의 규칙 편집기(RuleSetDialog)를 사용합니다. |
ImperativeCodeClientSample |
명령적 C# 코드를 사용하는 ExternalizedPolicy4 응용 프로그램을 사용하여 워크플로를 구성하고 실행하는 샘플 클라이언트 응용 프로그램입니다(디자이너가 사용되지 않음). |
ApplyDiscount.rules: WF 규칙 정의가 있는 파일입니다. Order.cs: 고객 주문을 나타내는 형식입니다. 이 형식의 개체에 규칙이 적용됩니다. Program.cs: Policy4 활동이 있는 워크플로를 구성하고 실행하여 ApplyDiscount.rules에 정의된 규칙을 Order 개체의 인스턴스에 적용합니다. App.config: 규칙 파일의 경로가 있는 구성 파일입니다. |
DesignerClientSample |
WF 디자이너에서 ExternalPolicy4 응용 프로그램을 사용하여 워크플로를 구성하고 실행하는 샘플 클라이언트 응용 프로그램입니다. |
Sequence1.xaml: Policy4 활동을 사용하여 규칙을 평가하는 순차 워크플로입니다. Program.cs: Sequence1.xaml에 정의된 워크플로의 인스턴스를 실행합니다. |
ExternalizedPolicy4 활동
ExternalizedPolicy4 활동은 WF 4.0 워크플로 내의 WF 3.5 RuleSet 개체를 실행할 수 있는 NativeActivity입니다. 다음 예제는 활동의 공용 개체 모델에 대한 간략한 정의입니다.
public class ExternalizedPolicy4Activity<TResult>: CodeActivity
{
public string RulesFilePath
public string RuleSetName
[RequiredArgument]
public InArgument<T> TargetObject
[RequiredArgument]
public OutArgument<T> ResultObject
public OutArgument<ValidationErrorCollection> ValidationErrors
}
속성 |
설명 |
RuleSetFilePath |
활동을 실행할 때 평가할 .NET Framework 3.5 RuleSet 파일의 경로입니다. |
RuleSetName |
.rules 파일 내에서 사용할 RuleSet의 이름입니다. |
TargetObject |
RuleSet의 Rule 개체를 평가할 기준 개체입니다. |
ResultObject |
규칙이 적용되는 결과 개체입니다. 예를 들어 규칙은 입력 인수에 대해 적용되고 결과는 결과 인수에 저장됩니다. |
ValidationError |
실행하기 전에 대상 개체에 대해 RuleSet의 유효성을 검사할 때 WF 3.5 규칙 엔진에서 반환하는 유효성 검사 오류 목록입니다. |
ExternalizedPolicy4 활동 디자이너
ExternalizedPolicy4 디자이너를 사용하면 코드를 작성하지 않고 기존 RuleSet을 사용하도록 활동을 구성할 수 있습니다. .rules 파일이 있는 경로를 설정하고 사용할 RuleSet 이름을 지정하기만 하면 됩니다. 이 디자이너를 사용하여 RuleSet을 수정할 수도 있습니다. 솔루션을 빌드한 후에는 도구 상자의 Microsoft.Samples.Activities.Rules 섹션에 있습니다. 디자이너를 사용하여 .rules 파일과 RuleSet을 선택할 수 있습니다. RuleSet 편집 단추를 클릭하면 WF 3.5 RuleSetDialog가 표시됩니다. 이 대화 상자는 다시 호스팅된 WF 3.5 규칙 편집기이며, ExternalizedPolicy4 활동에서 실행하는 규칙을 보고 편집하는 데 사용됩니다.
Policy4 및 ExternalPolicy4
.NET Framework 4의 정책 활동 활동을 사용하면 WF 4 워크플로에 .NET Framework 3.5 RuleSet을 만들고 실행할 수 있습니다. RuleSet은 Policy4 활동 XAML 정의에 serialize된 인라인입니다. ExternalizedPolicy4 샘플에서는 .rules 파일에 포함된 기존 외부 RuleSet을 사용하는 방법을 보여 줍니다.
이 샘플의 사용법
이 샘플을 실행하기 위한 특별한 설정 작업은 필요하지 않습니다. Visual Studio 2010에서 솔루션을 열고 F5 키를 누르면 응용 프로그램이 실행됩니다.
이 샘플에는 두 개의 클라이언트 응용 프로그램인 ImperativeCodeClientSample과 DesignerClientSample이 포함되어 있습니다. ImperativeCodeClientSample 클라이언트에서는 C# 명령적 코드를 사용하여 ExternalizedPolicy4 활동을 구성 및 실행하는 방법을 보여 주고, DesignerClientSample에서는 디자이너를 사용하여 ExternalizedPolicy4 활동을 구성 및 실행하는 방법을 보여 줍니다.
ImperativeCodeClientSample 응용 프로그램을 실행하려면
Visual Studio 2010을 사용하여 Policy4sample.sln 솔루션 파일을 엽니다.
솔루션 탐색기에서 ImperativeCodeClientSample 프로젝트를 마우스 오른쪽 단추로 클릭한 다음 시작 프로젝트로 설정을 선택합니다.
Ctrl+F5를 눌러 프로젝트를 실행합니다.
DesignerClientSample 응용 프로그램을 실행하려면
Visual Studio 2010을 사용하여 Policy4sample.sln 솔루션 파일을 엽니다.
솔루션 탐색기에서 DesignerClientSample 프로젝트를 마우스 오른쪽 단추로 클릭한 다음 시작 프로젝트로 설정을 선택합니다.
F6 키를 눌러 프로젝트를 컴파일합니다.
Ctrl+F5를 눌러 프로젝트를 실행합니다.
.gif "Ee662962.Important(ko-kr,VS.100).gif") 참고: |
|---|
컴퓨터에 이 샘플이 이미 설치되어 있을 수도 있습니다. 계속하기 전에 다음(기본) 디렉터리를 확인하십시오.
<InstallDrive>:\WF_WCF_Samples
이 디렉터리가 없으면 Windows Communication Foundation (WCF) and Windows Workflow Foundation (WF) Samples for .NET Framework 4로 이동하여 WCF(Windows Communication Foundation) 및 WF 샘플을 모두 다운로드하십시오. 이 샘플은 다음 디렉터리에 있습니다.
<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\ExternalizedPolicy4
|