PersonalizationAdministration.FindInactiveUserState 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 매개 변수를 기반으로 비활성 사용자에 대한 사용자별 개인 설정 상태 정보의 컬렉션을 반환합니다.
오버로드
| Name | Description |
|---|---|
| FindInactiveUserState(String, String, DateTime) |
지정된 매개 변수를 기반으로 비활성 사용자에 대한 사용자별 개인 설정 상태 정보의 컬렉션을 반환합니다. |
| FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32) |
지정된 매개 변수를 기반으로 비활성 사용자에 대한 사용자별 개인 설정 상태 정보의 컬렉션을 반환합니다. |
FindInactiveUserState(String, String, DateTime)
지정된 매개 변수를 기반으로 비활성 사용자에 대한 사용자별 개인 설정 상태 정보의 컬렉션을 반환합니다.
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate);public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState(string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate);static member FindInactiveUserState : string * string * DateTime -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollectionPublic Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime) As PersonalizationStateInfoCollection매개 변수
- pathToMatch
- String
일치시킬 페이지의 경로입니다.
- usernameToMatch
- String
페이지와 연결된 개인 설정 데이터가 있는 사용자 이름과 일치합니다.
- userInactiveSinceDate
- DateTime
사용자의 개인 설정 정보에 마지막으로 액세스한 날짜입니다.
반품
사용자별 개인 설정 상태 정보를 포함하는 A PersonalizationStateInfoCollection 입니다.
예외
pathToMatch 또는 usernameToMatch 트리밍 전후에 빈 문자열("")이 있습니다.
-또는-
구성에 정의된 개인 설정 공급자에 대한 공급자가 올바른 형식이 아닙니다.
-또는-
매개 변수의 문자열 길이가 256자를 초과합니다.
구성된 개인 설정 공급자 중 하나의 인스턴스를 만들고 초기화하는 동안 구성 예외가 발생했습니다.
-또는-
구성에 정의된 기본 개인 설정 공급자를 찾을 수 없습니다.
설명
이 메서드는 매개 변수 값이 페이지의 경로와 일치하고, 해당 페이지와 연결된 개인 설정 데이터가 있는 pathToMatch 사용자 이름과 일치하며, usernameToMatch 사용자가 비활성 상태로 간주되는 사용자별 개인 설정 상태 정보인 인스턴스 컬렉션을 UserPersonalizationStateInfo 반환합니다. 즉, 반환된 각 레코드에 대해 사용자의 LastActivityDate 속성 값이 1보다 작거나 같습니다 userInactiveSinceDate. 반환된 컬렉션에는 인스턴스만 UserPersonalizationStateInfo 포함됩니다.
이 메서드는 쿼리 와일드카드 문자를 기본 데이터 저장소에 전달합니다. 와일드카드 문자에 대한 지원은 현재 각 공급자가 별표(*), 백분율 기호(%) 또는 밑줄(_)과 같은 문자를 처리하는 방법에 따라 달라집니다.
일반적으로 SQL 규격 데이터 저장소의 경우 속성의 검색 문자열 텍스트의 시작, 끝 또는 중간에 와일드카드 문자가 나타나는 부분 경로에서 와일드카드 검색을 PathToMatch 수행할 수 있습니다. 예를 들어 "~/vdir" PathToMatch 로 시작하는 모든 경로를 찾으려면 속성이 "~/vdir%"로 설정됩니다.
마찬가지로 부분 사용자 이름에 대한 와일드카드 검색은 속성의 텍스트 문자열에 있는 임의의 지점에 와일드카드 문자가 UsernameToMatch 표시될 수 있습니다. 예를 들어 "John"으로 시작하는 모든 사용자 이름을 찾으려면 속성이 UsernameToMatch "John%"과 같이 표시됩니다.
기본 개인 설정 공급자 PersonalizationStateInfo를 사용하여 파생된 개체는 사전순으로 반환되고 경로와 사용자 이름을 오름차순으로 조합하여 정렬됩니다. 컬렉션에 있는 개체의 순서는 공급자에 의해 결정됩니다.
이 MaxValue경우 userInactiveSinceDate 이 메서드에서 반환된 값은 .에 해당합니다FindUserState.
둘 다 pathToMatch 일 usernameToMatch 수 있습니다 null. Microsoft SQL Server를 실행하는 데이터 저장소와 같은 일부 데이터 저장소는 usernameToMatch 와일드카드 문자로 쉼표를 허용하므로 매개 변수에는 쉼표(,)가 포함될 수 있습니다.
추가 정보
적용 대상
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)
지정된 매개 변수를 기반으로 비활성 사용자에 대한 사용자별 개인 설정 상태 정보의 컬렉션을 반환합니다.
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState(string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);static member FindInactiveUserState : string * string * DateTime * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollectionPublic Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection매개 변수
- pathToMatch
- String
일치시킬 페이지의 경로입니다.
- usernameToMatch
- String
페이지와 연결된 개인 설정 데이터가 있는 사용자 이름과 일치합니다.
- userInactiveSinceDate
- DateTime
개인 설정 정보에 마지막으로 액세스한 날짜입니다.
- pageIndex
- Int32
반환할 결과 페이지의 인덱스(0부터 시작하는 인덱스)입니다.
- pageSize
- Int32
반환할 레코드 수입니다.
- totalRecords
- Int32
사용 가능한 총 레코드 수입니다.
반품
사용자별 개인 설정 상태 정보를 포함하는 A PersonalizationStateInfoCollection 입니다.
예외
pathToMatch 또는 usernameToMatch 트리밍 전후에 빈 문자열("")이 있습니다.
-또는-
pageIndex 가 0보다 작음
-또는-
pageSize 가 0보다 작거나 같습니다.
-또는-
Int32.MaxValue의 pageIndex 조합과 pageSize 초과합니다.
-또는-
구성에 정의된 개인 설정 공급자에 대한 공급자가 올바른 형식이 아닙니다.
-또는-
매개 변수의 문자열 길이가 256자를 초과합니다.
구성된 개인 설정 공급자 중 하나의 인스턴스를 만들고 초기화하는 동안 구성 예외가 발생했습니다.
-또는-
구성에 정의된 기본 개인 설정 공급자를 찾을 수 없습니다.
설명
이 메서드는 매개 변수 값이 페이지의 경로와 일치하고, 해당 페이지와 연결된 개인 설정 데이터가 있는 pathToMatch 사용자 이름과 일치하며, usernameToMatch 사용자가 비활성 상태로 간주되는 사용자별 개인 설정 상태 정보인 인스턴스 컬렉션을 UserPersonalizationStateInfo 반환합니다. 즉, 반환된 각 레코드에 대해 사용자의 LastActivityDate 속성 값이 1보다 작거나 같습니다 userInactiveSinceDate. 컬렉션에는 인스턴스만 UserPersonalizationStateInfo 포함됩니다.
이 메서드는 매개 변수 와일드카드 문자를 기본 개인 설정 공급자에 전달하므로 데이터 저장소에서 이러한 문자를 처리하는 방법은 공급자가 별표(*), 백분율 기호(%) 또는 밑줄(_)과 같은 문자를 처리하는 방법에 따라 달라집니다.
일반적으로 SQL 규격 데이터 저장소의 경우 속성의 검색 문자열 텍스트의 시작, 끝 또는 중간에 와일드카드 문자가 나타나는 부분 경로에서 와일드카드 검색을 PathToMatch 수행할 수 있습니다. 예를 들어 "~/vdir" PathToMatch 로 시작하는 모든 경로를 찾으려면 속성이 "~/vdir%"로 설정됩니다.
마찬가지로 부분 사용자 이름에 대한 와일드카드 검색은 속성의 텍스트 문자열에 있는 임의의 지점에 와일드카드 문자가 UsernameToMatch 표시될 수 있습니다. 예를 들어 "John"으로 시작하는 모든 사용자 이름을 찾으려면 속성이 UsernameToMatch "John%"과 같이 표시됩니다.
기본 개인 설정 공급자 PersonalizationStateInfo를 사용하여 파생된 개체는 사전순으로 반환되고 경로와 사용자 이름을 오름차순으로 조합하여 정렬됩니다. 컬렉션에 있는 개체의 순서는 공급자에 의해 결정됩니다.
이 MaxValue경우 userInactiveSinceDate 이 메서드에서 반환된 값은 .에 해당합니다FindUserState.
둘 다 pathToMatch 일 usernameToMatch 수 있습니다 null. Microsoft SQL Server를 실행하는 데이터 저장소와 같은 일부 데이터 저장소는 usernameToMatch 쉼표를 와일드카드 문자로 허용하기 때문에 매개 변수에는 쉼표(,)가 있을 수 있습니다.
반환되는 pageIndex 데이터는 반환할 레코드를 제어하고 pageSizepageIndex 반환 pageSize 할 레코드 수를 제어하는 제약을 받습니다. 예를 들어 0으로 설정되고 pageSize 25로 설정된 경우 pageIndex 반환되는 데이터는 처음 25개 항목이 됩니다. 1로 설정되고 pageSize 25로 설정된 경우 pageIndex 반환되는 데이터는 26~50개 항목이 됩니다. 매개 변수는 totalRecords 사용할 수 있는 총 레코드 수를 반환합니다.
