PropertyPath.Path 속성

정의

네임스페이스:

System.Windows

어셈블리:

PresentationFramework.dll

경로를 설명하는 문자열을 가져오거나 설정합니다.

public:
 property System::String ^ Path { System::String ^ get(); void set(System::String ^ value); };

public string Path { get; set; }

member this.Path : string with get, set

Public Property Path As String

속성 값

String

경로를 설명하는 문자열입니다.

설명

이 속성에 포함된 문자열은 바인딩의 소스 모드 속성 경로, 스토리보드 대상의 대상 모드 단일 단계 속성 경로 또는 스토리보드 대상의 복잡한 경로에 사용되는지 여부에 PropertyPath 따라 완전히 다른 세 가지 의미가 있습니다.

바인딩 Path 에 대해 소스 모드에서 사용하는 PropertyPath 경우 속성 이름을 나타내는 문자열이거나 바인딩의 원본으로 사용되는 개체의 CLR 개체 모델에서 속성에 대한 "단계별" 경로를 설명하는 문자열일 수 있습니다. 바인딩 속성 경로의 경우 "step"을 식별하는 문자는 점(.)입니다. 인덱서 참조(여러 인덱서 및 형식 구분 포함)도 지원됩니다. 개체에서 특별히 사용되는 문자열 구문에 대한 자세한 내용은 다음을 Binding 참조하세요 Binding.Path. 바인딩 소스로 사용되는 속성은 종속성 속성일 필요가 없습니다. 바인딩이 양방향으로 업데이트되는 경우 속성 원본은 읽기/쓰기여야 합니다. 또한 바인딩 대상은 종속성 속성이어야 합니다. 자세한 내용은 데이터 바인딩 개요를 참조하세요.

스토리보드 PropertyPath 대상의 단일 단계 경로에 대해 대상 모드에서 이를 PropertyPath 사용하는 경우 typeName 인 문자열입니다.propertyName 정규화된 종속성 속성 이름 문자열입니다.

스토리보드 대상 Path 의 복잡한 경로에 이 PropertyPath 형식을 사용하는 경우 지정된 다양한 개체PathParameters의 관계를 설명하는 토큰화된 문자열 형식입니다.

• 배열의 각 항목은 괄호로 묶인 항목의 배열 인덱스에 의해 이 형식으로 지정됩니다. 예를 들어 배열에서 첫 번째 항목을 지정하려면 문자열 토큰은 .입니다 (0).

• 항목 간의 관계(경로의 "단계")는 점(.)으로 지정됩니다. 점 앞의 속성은 경로의 첫 번째 단계이고, 이후의 속성은 두 번째 단계입니다( 두 단계를 초과하는 단계를 지정할 수 있음). 체인의 마지막 단계는 항상 애니메이션 효과를 주게 되는 속성을 나타냅니다.

• 컬렉션 속성 내의 항목은 인덱서 구문을 사용하여 액세스되고 인덱스는 대괄호([ 및 ]) 내에 있습니다. 인덱서는 속성을 나타내는 토큰에 추가됩니다. 예를 들어 다음은 2단계 경로이며, 첫 번째 단계에서 토큰 조합이 해당 속성 (0)[1].(1) 의 컬렉션 내에서 두 번째 항목을 지정합니다. 체인의 마지막 속성에서 인덱서는 사용할 수 없습니다. 실제 컬렉션 위치에 애니메이션 효과를 적용할 수 없으며 해당 개체의 속성에 애니메이션 효과를 주어야 합니다.

일반적으로 경로 문자열 PropertyPath 은 생성자를 PropertyPath(Object) 통해 설정됩니다. 즉, 바인딩 또는 단일 단계 스토리보드 대상에 대한 서명, PropertyPath(String, Object[]) 다단계 스토리보드 대상의 서명입니다.

XAML: XAML에서 속성 참조를 특성 값으로 설명하는 데 사용하는 PropertyPath 경우 지정한 문자열은 먼저 형식 변환기(PropertyPathConverter)에 의해 처리됩니다. 그런 다음 이 형식 변환기는 문자열을 처리하고 해당 구문에 따라 생성자 서명 중 PropertyPath 하나를 호출합니다. 특성 값을 처리하는 형식 변환기를 통한 이 간접 참조는 일반적으로 개체 요소를 선언한 다음 특정 값을 다음과 같은 PathParametersPath 특성에 적용하는 PropertyPath 대신 XAML에서 사용하는 PropertyPath 방법입니다. 자세한 내용은 PropertyPath XAML 구문을 참조하세요.

XAML 텍스트 사용

형식의 PropertyPath 멤버는 일반적으로 직접 XAML 구문에서 설정되지 않습니다. 설명 부분을 참조하세요.