다음을 통해 공유


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>()

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

속성

Assets

애플리케이션에 대한 ResourceAssetCollection 가져옵니다.

(다음에서 상속됨 ComponentBase)
AssignedRenderMode

이 구성 요소에 할당된 IComponentRenderMode 가져옵니다.

(다음에서 상속됨 ComponentBase)
ChildContent

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

EmptyContent

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

ItemContent

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

Items

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

ItemSize

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

ItemsProvider

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

OverscanCount

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

Placeholder

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

RendererInfo

구성 요소가 실행되는 RendererInfo 가져옵니다.

(다음에서 상속됨 ComponentBase)
SpacerElement

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

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

메서드

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)

적용 대상