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