Virtualize<TItem> 클래스

정의

가상화된 항목 목록을 렌더링하는 기능을 제공합니다.

generic <typename TItem>
public ref class Virtualize sealed : Microsoft::AspNetCore::Components::ComponentBase, IAsyncDisposable
public sealed class Virtualize<TItem> : Microsoft.AspNetCore.Components.ComponentBase, IAsyncDisposable
type Virtualize<'Item> = class
    inherit ComponentBase
    interface IAsyncDisposable
Public NotInheritable Class Virtualize(Of TItem)
Inherits ComponentBase
Implements IAsyncDisposable

형식 매개 변수

TItem

context 렌더링되는 항목의 형식입니다.

상속
Virtualize<TItem>
구현

생성자

Virtualize<TItem>()

가상화된 항목 목록을 렌더링하는 기능을 제공합니다.

속성

ChildContent

목록의 항목 템플릿을 가져오거나 설정합니다.

EmptyContent

가 비어 있거나 가 0일 때 ItemsTotalItemCount 표시할 콘텐츠를 가져오거나 설정합니다.

ItemContent

목록의 항목 템플릿을 가져오거나 설정합니다.

Items

고정 항목 원본을 가져오거나 설정합니다.

ItemSize

각 항목의 크기를 픽셀 단위로 가져옵니다. 기본값은 50px입니다.

ItemsProvider

목록에 항목을 제공하는 함수를 가져오거나 설정합니다.

OverscanCount

표시되는 영역 전후에 렌더링할 추가 항목 수를 결정하는 값을 가져오거나 설정합니다. 이렇게 하면 스크롤하는 동안 렌더링 빈도를 줄일 수 있습니다. 그러나 값이 높을수록 페이지에 더 많은 요소가 표시됩니다.

Placeholder

메모리에 아직 로드되지 않은 항목에 대한 템플릿을 가져오거나 설정합니다.

SpacerElement

가상화 스페이서로 사용할 HTML 요소의 태그 이름을 가져오거나 설정합니다. 이러한 요소 중 하나는 표시되는 항목 앞에 렌더링되고 그 다음에는 명시적 "높이" 스타일을 사용하여 스크롤 범위를 제어합니다.

기본값은 "div"입니다. 특정 자식 태그 이름이 필요한 요소 내에 instance 배치 Virtualize<TItem> 하는 경우 여기서 설정하는 것이 좋습니다. 예를 들어 "tbody" 내에서 렌더링할 때 값을 "tr"로 설정하는 SpacerElement 것이 좋습니다.

메서드

BuildRenderTree(RenderTreeBuilder)

제공된 에 구성 요소를 렌더링 RenderTreeBuilder합니다.

(다음에서 상속됨 ComponentBase)
DispatchExceptionAsync(Exception)

제공된 exception 를 이 구성 요소에 의해 throw되는 것으로 처리합니다. 이로 인해 바깥쪽 ErrorBoundary가 실패 상태로 전환됩니다. 바깥쪽 ErrorBoundary가 없으면 바깥쪽 렌더러의 예외로 간주됩니다.

이는 구성 요소 수명 주기 메서드 외부에서 예외가 발생하지만 구성 요소 수명 주기 메서드의 예외와 동일하게 처리하려는 경우에 유용합니다.

(다음에서 상속됨 ComponentBase)
DisposeAsync()

가상화된 항목 목록을 렌더링하는 기능을 제공합니다.

InvokeAsync(Action)

연결된 렌더러의 동기화 컨텍스트에서 제공된 작업 항목을 실행합니다.

(다음에서 상속됨 ComponentBase)
InvokeAsync(Func<Task>)

연결된 렌더러의 동기화 컨텍스트에서 제공된 작업 항목을 실행합니다.

(다음에서 상속됨 ComponentBase)
OnAfterRender(Boolean)

구성 요소가 대화형으로 렌더링되고 UI가 업데이트를 완료할 때마다 호출되는 메서드(예: 요소가 브라우저 DOM에 추가된 후). 모든 ElementReference 필드는 이 실행될 때까지 채워집니다.

이 메서드는 사전 렌더링 또는 서버 쪽 렌더링 중에 호출되지 않습니다. 이러한 프로세스는 라이브 브라우저 DOM에 연결되지 않고 DOM이 업데이트되기 전에 이미 완료되었기 때문입니다.

(다음에서 상속됨 ComponentBase)
OnAfterRenderAsync(Boolean)

구성 요소가 대화형으로 렌더링되고 UI가 업데이트를 완료할 때마다 호출되는 메서드(예: 요소가 브라우저 DOM에 추가된 후). 모든 ElementReference 필드는 이 실행될 때까지 채워집니다.

이 메서드는 사전 렌더링 또는 서버 쪽 렌더링 중에 호출되지 않습니다. 이러한 프로세스는 라이브 브라우저 DOM에 연결되지 않고 DOM이 업데이트되기 전에 이미 완료되었기 때문입니다.

이 경우 무한 렌더링 루프가 발생하므로 반환 Task된 가 완료된 후에는 구성 요소가 자동으로 다시 렌더링되지 않습니다.

(다음에서 상속됨 ComponentBase)
OnInitialized()

렌더링 트리의 부모로부터 초기 매개 변수를 받은 후 구성 요소를 시작할 준비가 되면 호출되는 메서드입니다.

(다음에서 상속됨 ComponentBase)
OnInitializedAsync()

렌더링 트리의 부모로부터 초기 매개 변수를 받은 후 구성 요소를 시작할 준비가 되면 호출되는 메서드입니다.

비동기 작업을 수행하고 해당 작업이 완료될 때 구성 요소를 새로 고치려는 경우 이 메서드를 재정의합니다.

(다음에서 상속됨 ComponentBase)
OnParametersSet()

구성 요소가 렌더링 트리의 부모로부터 매개 변수를 수신하고 들어오는 값이 속성에 할당되었을 때 호출되는 메서드입니다.

(다음에서 상속됨 ComponentBase)
OnParametersSetAsync()

구성 요소가 렌더링 트리의 부모로부터 매개 변수를 수신하고 들어오는 값이 속성에 할당되었을 때 호출되는 메서드입니다.

(다음에서 상속됨 ComponentBase)
RefreshDataAsync()

구성 요소에 에서 데이터를 다시 요청하도록 지시합니다 ItemsProvider. 외부 데이터가 변경되었을 수 있는 경우에 유용합니다. 를 사용할 Items때 이 호출할 필요가 없습니다.

SetParametersAsync(ParameterView)

렌더링 트리에서 구성 요소의 부모가 제공하는 매개 변수를 설정합니다.

(다음에서 상속됨 ComponentBase)
ShouldRender()

구성 요소가 렌더링되어야 하는지 여부를 나타내는 플래그를 반환합니다.

(다음에서 상속됨 ComponentBase)
StateHasChanged()

구성 요소에 상태가 변경되었음을 알 수 있습니다. 해당하는 경우 구성 요소가 다시 렌더링됩니다.

(다음에서 상속됨 ComponentBase)

명시적 인터페이스 구현

IComponent.Attach(RenderHandle)

가상화된 항목 목록을 렌더링하는 기능을 제공합니다.

(다음에서 상속됨 ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

가상화된 항목 목록을 렌더링하는 기능을 제공합니다.

(다음에서 상속됨 ComponentBase)
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object)

가상화된 항목 목록을 렌더링하는 기능을 제공합니다.

(다음에서 상속됨 ComponentBase)

적용 대상