Class PaginatedNoteClient
- Namespace
- Crews.PlanningCenter.Api.Giving.V2018_08_01
- Assembly
- Crews.PlanningCenter.Api.dll
Client for interacting with Note collection resources.
public class PaginatedNoteClient : PaginatedResourceClient<Note, NoteResource, NoteCollectionResponse, NoteResponse>
- Inheritance
-
PaginatedNoteClient
- Inherited Members
Constructors
PaginatedNoteClient(HttpClient, Uri)
Client for interacting with Note collection resources.
public PaginatedNoteClient(HttpClient httpClient, Uri uri)
Parameters
httpClientHttpClienturiUri
Methods
AddCustomParameter(string, string)
Adds a custom query parameter to the request URI.
public PaginatedNoteClient AddCustomParameter(string parameter, string value)
Parameters
Returns
- PaginatedNoteClient
The current PaginatedNoteClient instance.
ClearParameters()
Removes the entire query string from the request URI.
public PaginatedNoteClient ClearParameters()
Returns
- PaginatedNoteClient
The current PaginatedNoteClient instance.
Filter(string)
Adds a filter query parameter to the request.
public PaginatedNoteClient Filter(string filter)
Parameters
filterstringThe filter criteria.
Returns
- PaginatedNoteClient
The current PaginatedNoteClient instance.
Remarks
See Planning Center API documentation for details on supported filter values for this resource.
GetAsync(CancellationToken)
Fetches a paginated list of Note resources asynchronously.
public Task<NoteCollectionResponse> GetAsync(CancellationToken cancellationToken = default)
Parameters
cancellationTokenCancellationTokenA token to monitor for cancellation requests.
Returns
- Task<NoteCollectionResponse>
A task representing the asynchronous operation, containing a paginated list of Note resources.
Exceptions
- JsonApiException
Thrown when the HTTP response indicates a failure status code.
Offset(int)
Sets the item offset in the paginated response.
public PaginatedNoteClient Offset(int count)
Parameters
countintThe number of items to skip.
Returns
- PaginatedNoteClient
The current PaginatedNoteClient instance.
PerPage(int)
Sets the number of items to be returned per page in the paginated response.
public PaginatedNoteClient PerPage(int count)
Parameters
countintThe number of items to be returned per page.
Returns
- PaginatedNoteClient
The current PaginatedNoteClient instance.
PostAsync(Note, CancellationToken)
Creates a new Note resource asynchronously.
public Task<NoteResponse> PostAsync(Note resource, CancellationToken cancellationToken = default)
Parameters
resourceNoteThe resource data to be sent in the POST request.
cancellationTokenCancellationTokenA token to monitor for cancellation requests.
Returns
- Task<NoteResponse>
A task representing the asynchronous operation, containing the created Note resource.
Exceptions
- JsonApiException
Thrown when the HTTP response indicates a failure status code.
PostAsync(JsonApiDocument<NoteResource>, CancellationToken)
Creates a new Note resource asynchronously.
public Task<NoteResponse> PostAsync(JsonApiDocument<NoteResource> document, CancellationToken cancellationToken = default)
Parameters
documentJsonApiDocument<NoteResource>The JSON:API document to be sent in the POST request.
cancellationTokenCancellationTokenA token to monitor for cancellation requests.
Returns
- Task<NoteResponse>
A task representing the asynchronous operation, containing the created Note resource.
Exceptions
- JsonApiException
Thrown when the HTTP response indicates a failure status code.
WithId(string)
Creates a new instance of a Note client for a specific resource ID.
public NoteClient WithId(string id)
Parameters
idstringThe ID of the resource to create a client for.
Returns
- NoteClient
A new instance of the resource client for the specified resource ID.