Share via


CloudTable.CreateIfNotExistsAsync Method

Definition

Overloads

CreateIfNotExistsAsync()

Initiates an asynchronous operation to create a table if it does not already exist.

CreateIfNotExistsAsync(CancellationToken)

Initiates an asynchronous operation to create a table if it does not already exist.

CreateIfNotExistsAsync(TableRequestOptions, OperationContext)

Initiates an asynchronous operation to create a table if it does not already exist.

CreateIfNotExistsAsync(IndexingMode, Nullable<Int32>, CancellationToken)

Initiates an asynchronous operation to create a table if it does not already exist.

CreateIfNotExistsAsync(TableRequestOptions, OperationContext, CancellationToken)

Initiates an asynchronous operation to create a table if it does not already exist.

CreateIfNotExistsAsync(IndexingMode, Nullable<Int32>, Nullable<Int32>, CancellationToken)

Initiates an asynchronous operation to create a table if it does not already exist.

CreateIfNotExistsAsync(TableRequestOptions, OperationContext, Nullable<IndexingMode>, Nullable<Int32>, CancellationToken)
CreateIfNotExistsAsync(TableRequestOptions, OperationContext, String, Nullable<Int32>, Nullable<Int32>, CancellationToken)

Initiates an asynchronous operation to create a table if it does not already exist.

CreateIfNotExistsAsync()

Initiates an asynchronous operation to create a table if it does not already exist.

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync ();
abstract member CreateIfNotExistsAsync : unit -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : unit -> System.Threading.Tasks.Task<bool>
Public Overridable Function CreateIfNotExistsAsync () As Task(Of Boolean)

Returns

A Task<TResult> object of type bool that represents the asynchronous operation.

Remarks

This API performs an existence check and therefore requires list permissions.

Applies to

CreateIfNotExistsAsync(CancellationToken)

Initiates an asynchronous operation to create a table if it does not already exist.

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (System.Threading.CancellationToken cancellationToken);
abstract member CreateIfNotExistsAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overridable Function CreateIfNotExistsAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

cancellationToken
CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

A Task<TResult> object of type bool that represents the asynchronous operation.

Remarks

This API performs an existence check and therefore requires list permissions.

Applies to

CreateIfNotExistsAsync(TableRequestOptions, OperationContext)

Initiates an asynchronous operation to create a table if it does not already exist.

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.Table.TableRequestOptions requestOptions, Microsoft.Azure.Cosmos.Table.OperationContext operationContext);
abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext -> System.Threading.Tasks.Task<bool>
Public Overridable Function CreateIfNotExistsAsync (requestOptions As TableRequestOptions, operationContext As OperationContext) As Task(Of Boolean)

Parameters

requestOptions
TableRequestOptions

A TableRequestOptions object that specifies additional options for the request.

operationContext
OperationContext

An OperationContext object that represents the context for the current operation.

Returns

A Task<TResult> object of type bool that represents the asynchronous operation.

Remarks

This API performs an existence check and therefore requires list permissions.

Applies to

CreateIfNotExistsAsync(IndexingMode, Nullable<Int32>, CancellationToken)

Initiates an asynchronous operation to create a table if it does not already exist.

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.IndexingMode indexingMode, int? throughput, System.Threading.CancellationToken cancellationToken);
abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.IndexingMode * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.IndexingMode * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overridable Function CreateIfNotExistsAsync (indexingMode As IndexingMode, throughput As Nullable(Of Integer), cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

indexingMode
IndexingMode

CosmosDB table indexing mode

throughput
Nullable<Int32>

CosmosDB table throughput

cancellationToken
CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

A Task<TResult> object of type bool that represents the asynchronous operation.

Remarks

This API performs an existence check and therefore requires list permissions.

Applies to

CreateIfNotExistsAsync(TableRequestOptions, OperationContext, CancellationToken)

Initiates an asynchronous operation to create a table if it does not already exist.

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.Table.TableRequestOptions requestOptions, Microsoft.Azure.Cosmos.Table.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);
abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overridable Function CreateIfNotExistsAsync (requestOptions As TableRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

requestOptions
TableRequestOptions

A TableRequestOptions object that specifies additional options for the request.

operationContext
OperationContext

An OperationContext object that represents the context for the current operation.

cancellationToken
CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

A Task<TResult> object of type bool that represents the asynchronous operation.

Remarks

This API performs an existence check and therefore requires list permissions.

Applies to

CreateIfNotExistsAsync(IndexingMode, Nullable<Int32>, Nullable<Int32>, CancellationToken)

Initiates an asynchronous operation to create a table if it does not already exist.

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.IndexingMode indexingMode, int? throughput, int? defaultTimeToLive, System.Threading.CancellationToken cancellationToken);
abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.IndexingMode * Nullable<int> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.IndexingMode * Nullable<int> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overridable Function CreateIfNotExistsAsync (indexingMode As IndexingMode, throughput As Nullable(Of Integer), defaultTimeToLive As Nullable(Of Integer), cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

indexingMode
IndexingMode

CosmosDB table indexing mode

throughput
Nullable<Int32>

CosmosDB table throughput.

defaultTimeToLive
Nullable<Int32>

CosmosDB table time to live in seconds. Null implies TTL is off, -1 equals TTL is on and retain rows indefinitely, any other value sets TTL.

cancellationToken
CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

A Task<TResult> object of type bool that represents the asynchronous operation.

Remarks

This API performs an existence check and therefore requires list permissions.

Applies to

CreateIfNotExistsAsync(TableRequestOptions, OperationContext, Nullable<IndexingMode>, Nullable<Int32>, CancellationToken)

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.Table.TableRequestOptions requestOptions, Microsoft.Azure.Cosmos.Table.OperationContext operationContext, Microsoft.Azure.Cosmos.IndexingMode? indexingMode, int? throughput, System.Threading.CancellationToken cancellationToken);
abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * Nullable<Microsoft.Azure.Cosmos.IndexingMode> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * Nullable<Microsoft.Azure.Cosmos.IndexingMode> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overridable Function CreateIfNotExistsAsync (requestOptions As TableRequestOptions, operationContext As OperationContext, indexingMode As Nullable(Of IndexingMode), throughput As Nullable(Of Integer), cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

requestOptions
TableRequestOptions
operationContext
OperationContext
indexingMode
Nullable<IndexingMode>
throughput
Nullable<Int32>
cancellationToken
CancellationToken

Returns

Applies to

CreateIfNotExistsAsync(TableRequestOptions, OperationContext, String, Nullable<Int32>, Nullable<Int32>, CancellationToken)

Initiates an asynchronous operation to create a table if it does not already exist.

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.Table.TableRequestOptions requestOptions, Microsoft.Azure.Cosmos.Table.OperationContext operationContext, string serializedIndexingPolicy, int? throughput, int? defaultTimeToLive, System.Threading.CancellationToken cancellationToken);
abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * string * Nullable<int> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * string * Nullable<int> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overridable Function CreateIfNotExistsAsync (requestOptions As TableRequestOptions, operationContext As OperationContext, serializedIndexingPolicy As String, throughput As Nullable(Of Integer), defaultTimeToLive As Nullable(Of Integer), cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

requestOptions
TableRequestOptions

A TableRequestOptions object that specifies additional options for the request.

operationContext
OperationContext

An OperationContext object that represents the context for the current operation.

serializedIndexingPolicy
String

CosmosDB table indexing policy.

throughput
Nullable<Int32>

CosmosDB table throughput.

defaultTimeToLive
Nullable<Int32>

CosmosDB table time to live in seconds. Null implies TTL is off, -1 equals TTL is on and retain rows indefinitely, any other value sets TTL.

cancellationToken
CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

A Task<TResult> object of type bool that represents the asynchronous operation.

Remarks

This API performs an existence check and therefore requires list permissions.

Applies to