-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathGoogle.Api.Gax.Grpc.xml
1739 lines (1737 loc) · 113 KB
/
Google.Api.Gax.Grpc.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<?xml version="1.0"?>
<doc>
<assembly>
<name>Google.Api.Gax.Grpc</name>
</assembly>
<members>
<member name="T:Google.Api.Gax.Grpc.ApiBidirectionalStreamingCall`2">
<summary>
Bridge between a duplex streaming RPC method and higher level
abstractions, applying call settings as required.
</summary>
<typeparam name="TRequest">RPC request type</typeparam>
<typeparam name="TResponse">RPC response type</typeparam>
</member>
<member name="P:Google.Api.Gax.Grpc.ApiBidirectionalStreamingCall`2.BaseCallSettings">
<summary>
The base <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> for this API call; these can be further overridden by providing
a <c>CallSettings</c> to <see cref="M:Google.Api.Gax.Grpc.ApiBidirectionalStreamingCall`2.Call(Google.Api.Gax.Grpc.CallSettings)"/>.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.ApiBidirectionalStreamingCall`2.StreamingSettings">
<summary>
Streaming settings.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.ApiBidirectionalStreamingCall`2.Call(Google.Api.Gax.Grpc.CallSettings)">
<summary>
Initializes a streaming RPC call.
</summary>
<param name="perCallCallSettings">The call settings to apply to this specific call,
overriding defaults where necessary.</param>
<returns>A gRPC duplex streaming call object.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.ApiBidirectionalStreamingCall`2.WithMergedBaseCallSettings(Google.Api.Gax.Grpc.CallSettings)">
<summary>
Returns a new API call using the original base call settings merged with <paramref name="callSettings"/>.
Where there's a conflict, the original base call settings have priority.
</summary>
</member>
<member name="T:Google.Api.Gax.Grpc.ApiCall.GrpcCallAdapter`2">
<summary>
Adapter used to mask the fact that when we need response/trailing metadata, a sync call may need
to use the async gRPC code.
</summary>
</member>
<member name="T:Google.Api.Gax.Grpc.ApiCall`2">
<summary>
Bridge between an RPC method (with synchronous and asynchronous variants) and higher level
abstractions, applying call settings as required.
</summary>
<typeparam name="TRequest">RPC request type</typeparam>
<typeparam name="TResponse">RPC response type</typeparam>
</member>
<member name="P:Google.Api.Gax.Grpc.ApiCall`2.BaseCallSettings">
<summary>
The base <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> for this API call; these can be further overridden by providing
a <c>CallSettings</c> to <see cref="M:Google.Api.Gax.Grpc.ApiCall`2.Async(`0,Google.Api.Gax.Grpc.CallSettings)"/> or <see cref="M:Google.Api.Gax.Grpc.ApiCall`2.Sync(`0,Google.Api.Gax.Grpc.CallSettings)"/>.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.ApiCall`2.Async(`0,Google.Api.Gax.Grpc.CallSettings)">
<summary>
Performs an RPC call asynchronously.
</summary>
<param name="request">The RPC request.</param>
<param name="perCallCallSettings">The call settings to apply to this specific call,
overriding defaults where necessary.</param>
<returns>A task representing the asynchronous operation. The result of the completed task
will be the RPC response.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.ApiCall`2.Sync(`0,Google.Api.Gax.Grpc.CallSettings)">
<summary>
Performs an RPC call synchronously.
</summary>
<param name="request">The RPC request.</param>
<param name="perCallCallSettings">The call settings to apply to this specific call,
overriding defaults where necessary.</param>
<returns>The RPC response.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.ApiCall`2.WithMergedBaseCallSettings(Google.Api.Gax.Grpc.CallSettings)">
<summary>
Returns a new API call using the original base call settings merged with <paramref name="callSettings"/>.
Where there's a conflict, the original base call settings have priority.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.ApiCall`2.WithCallSettingsOverlay(System.Func{`0,Google.Api.Gax.Grpc.CallSettings})">
<summary>
Constructs a new <see cref="T:Google.Api.Gax.Grpc.ApiCall`2"/> that applies an overlay to
the underlying <see cref="T:Google.Api.Gax.Grpc.CallSettings"/>. If a value exists in both the original and
the overlay, the overlay takes priority.
</summary>
<param name="callSettingsOverlayFn">Function that builds the overlay <see cref="T:Google.Api.Gax.Grpc.CallSettings"/>.</param>
<returns>A new <see cref="T:Google.Api.Gax.Grpc.ApiCall`2"/> with the overlay applied.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.ApiCall`2.WithGoogleRequestParam(System.String,System.Func{`0,System.String})">
<summary>
Constructs a new <see cref="T:Google.Api.Gax.Grpc.ApiCall`2"/> that applies an x-goog-request-params header to each request,
using the specified parameter name and a value derived from the request.
</summary>
<remarks>Values produced by the function are URL-encoded; it is expected that <paramref name="parameterName"/> is already URL-encoded.</remarks>
<param name="parameterName">The parameter name in the header. Must not be null.</param>
<param name="valueSelector">A function to call on each request, to determine the value to specify in the header.
The parameter must not be null, but may return null.</param>
<returns>A new <see cref="T:Google.Api.Gax.Grpc.ApiCall`2"/> which applies the header on each request.</returns>
</member>
<member name="T:Google.Api.Gax.Grpc.ApiServerStreamingCall`2">
<summary>
Bridge between a server streaming RPC method and higher level
abstractions, applying call settings as required.
</summary>
<typeparam name="TRequest">RPC request type</typeparam>
<typeparam name="TResponse">RPC response type</typeparam>
</member>
<member name="P:Google.Api.Gax.Grpc.ApiServerStreamingCall`2.BaseCallSettings">
<summary>
The base <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> for this API call; these can be further overridden by providing
a <c>CallSettings</c> to <see cref="M:Google.Api.Gax.Grpc.ApiServerStreamingCall`2.Call(`0,Google.Api.Gax.Grpc.CallSettings)"/>.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.ApiServerStreamingCall`2.CallAsync(`0,Google.Api.Gax.Grpc.CallSettings)">
<summary>
Initializes a streaming RPC call asynchronously.
</summary>
<param name="request">The RPC request.</param>
<param name="perCallCallSettings">The call settings to apply to this specific call,
overriding defaults where necessary.</param>
<returns>A task representing the gRPC duplex streaming call object.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.ApiServerStreamingCall`2.Call(`0,Google.Api.Gax.Grpc.CallSettings)">
<summary>
Initializes a streaming RPC call.
</summary>
<param name="request">The RPC request.</param>
<param name="perCallCallSettings">The call settings to apply to this specific call,
overriding defaults where necessary.</param>
<returns>A gRPC duplex streaming call object.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.ApiServerStreamingCall`2.WithMergedBaseCallSettings(Google.Api.Gax.Grpc.CallSettings)">
<summary>
Returns a new API call using the original base call settings merged with <paramref name="callSettings"/>.
Where there's a conflict, the original base call settings have priority.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.ApiServerStreamingCall`2.WithCallSettingsOverlay(System.Func{`0,Google.Api.Gax.Grpc.CallSettings})">
<summary>
Constructs a new <see cref="T:Google.Api.Gax.Grpc.ApiServerStreamingCall`2"/> that applies an overlay to
the underlying <see cref="T:Google.Api.Gax.Grpc.CallSettings"/>. If a value exists in both the original and
the overlay, the overlay takes priority.
</summary>
<param name="callSettingsOverlayFn">Function that builds the overlay <see cref="T:Google.Api.Gax.Grpc.CallSettings"/>.</param>
<returns>A new <see cref="T:Google.Api.Gax.Grpc.ApiServerStreamingCall`2"/> with the overlay applied.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.ApiServerStreamingCall`2.WithGoogleRequestParam(System.String,System.Func{`0,System.String})">
<summary>
Constructs a new <see cref="T:Google.Api.Gax.Grpc.ApiServerStreamingCall`2"/> that applies an x-goog-request-params header to each request,
using the specified parameter name and a value derived from the request.
</summary>
<remarks>Values produced by the function are URL-encoded; it is expected that <paramref name="parameterName"/> is already URL-encoded.</remarks>
<param name="parameterName">The parameter name in the header. Must not be null.</param>
<param name="valueSelector">A function to call on each request, to determine the value to specify in the header.
The parameter must not be null, but may return null.</param>
<returns>A new <see cref="T:Google.Api.Gax.Grpc.ApiServerStreamingCall`2"/> which applies the header on each request.</returns>
</member>
<member name="T:Google.Api.Gax.Grpc.AsyncResponseStream`1">
<summary>
An adapter from the gRPC stream representation (<see cref="T:Grpc.Core.IAsyncStreamReader`1"/>) to <see cref="T:System.Collections.Generic.IAsyncEnumerable`1"/>
and <see cref="T:System.Collections.Generic.IAsyncEnumerator`1"/>. Note that <see cref="M:Google.Api.Gax.Grpc.AsyncResponseStream`1.GetAsyncEnumerator(System.Threading.CancellationToken)"/> can only
be called once per instance due to the "only iterate once" nature of the response stream.
</summary>
<remarks>
This type implements both of the standard asynchronous sequence interfaces for simplicity of use:
<list type="bullet">
<item>C# 8 users can use <c>await foreach</c> because it implements <see cref="T:System.Collections.Generic.IAsyncEnumerable`1"/></item>
<item>It's compatible with the System.Linq.Async package for query transformations.</item>
<item>Pre-C# 8 users who will be calling <see cref="M:Google.Api.Gax.Grpc.AsyncResponseStream`1.MoveNextAsync" /> and <see cref="P:Google.Api.Gax.Grpc.AsyncResponseStream`1.Current"/> directly don't need
to call <see cref="M:Google.Api.Gax.Grpc.AsyncResponseStream`1.GetAsyncEnumerator(System.Threading.CancellationToken)"/>.</item>
</list>
</remarks>
<typeparam name="TResponse">The response type.</typeparam>
</member>
<member name="P:Google.Api.Gax.Grpc.AsyncResponseStream`1.Current">
<inheritdoc />
</member>
<member name="M:Google.Api.Gax.Grpc.AsyncResponseStream`1.DisposeAsync">
<inheritdoc />
</member>
<member name="M:Google.Api.Gax.Grpc.AsyncResponseStream`1.GetAsyncEnumerator(System.Threading.CancellationToken)">
<summary>
Begins iterating over the response stream, using the specified cancellation token. This method can only be called
once per instance.
</summary>
<param name="cancellationToken">The cancellation token to use in subsequent <see cref="M:Google.Api.Gax.Grpc.AsyncResponseStream`1.MoveNextAsync"/> calls.</param>
<exception cref="T:System.InvalidOperationException">This method has already been called on this instance.</exception>
<returns>An iterator over the response stream.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.AsyncResponseStream`1.MoveNextAsync(System.Threading.CancellationToken)">
<summary>
Moves to the next item, using the specified cancellation token.
</summary>
<remarks></remarks>
<param name="cancellationToken">The cancellation token to use for this step.</param>
<returns>A task that will complete with a result of true if the enumerator was successfully advanced to the next element, or false if the enumerator has passed the end of the collection.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.AsyncResponseStream`1.MoveNextAsync">
<summary>
Moves to the next item, using the cancellation token configured by <see cref="M:Google.Api.Gax.Grpc.AsyncResponseStream`1.GetAsyncEnumerator(System.Threading.CancellationToken)"/>.
</summary>
</member>
<member name="T:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2">
<summary>
Base class for bidirectional streaming RPC methods.
</summary>
<typeparam name="TRequest">RPC request type</typeparam>
<typeparam name="TResponse">RPC response type</typeparam>
</member>
<member name="P:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.GrpcCall">
<summary>
The underlying gRPC duplex streaming call.
Warning: DO NOT USE <c>GrpcCall.RequestStream</c> at all if using
<see cref="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.TryWriteAsync(`0)"/>, <see cref="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.WriteAsync(`0)"/>,
<see cref="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.TryWriteAsync(`0,Grpc.Core.WriteOptions)"/> , or <see cref="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.WriteAsync(`0,Grpc.Core.WriteOptions)"/>.
Doing so will cause conflict with the write-buffer used within the <c>[Try]WriteAsync</c> methods.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.TryWriteAsync(`0)">
<summary>
Writes a message to the stream, if there is enough space in the buffer and <see cref="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.WriteCompleteAsync"/>
hasn't already been called. The same write options will be used as for the previous message.
</summary>
<param name="message">The message to write.</param>
<returns><c>null</c> if the message queue is full or the stream has already been completed;
otherwise, a <see cref="T:System.Threading.Tasks.Task"/> which will complete when the message has been written to the stream.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.WriteAsync(`0)">
<summary>
Writes a message to the stream, if there is enough space in the buffer and <see cref="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.WriteCompleteAsync"/>
hasn't already been called. The same write options will be used as for the previous message.
</summary>
<param name="message">The message to write.</param>
<exception cref="T:System.InvalidOperationException">There isn't enough space left in the buffer,
or <see cref="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.WriteCompleteAsync"/> has already been called.</exception>
<returns>A <see cref="T:System.Threading.Tasks.Task"/> which will complete when the message has been written to the stream.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.TryWriteAsync(`0,Grpc.Core.WriteOptions)">
<summary>
Writes a message to the stream, if there is enough space in the buffer and <see cref="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.WriteCompleteAsync"/>
hasn't already been called.
</summary>
<param name="message">The message to write.</param>
<param name="options">The write options to use for this message.</param>
<returns><c>null</c> if the message queue is full or the stream has already been completed.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.WriteAsync(`0,Grpc.Core.WriteOptions)">
<summary>
Writes a message to the stream, if there is enough space in the buffer and <see cref="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.WriteCompleteAsync"/>
hasn't already been called.
</summary>
<param name="message">The message to write.</param>
<param name="options">The write options to use for this message.</param>
<exception cref="T:System.InvalidOperationException">There isn't enough space left in the buffer,
or <see cref="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.WriteCompleteAsync"/> has already been called.</exception>
<returns>A <see cref="T:System.Threading.Tasks.Task"/> which will complete when the message has been written to the stream.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.TryWriteCompleteAsync">
<summary>
Completes the stream when all buffered messages have been sent.
Only the first call to this method on any instance will have any effect;
subsequent calls will return <c>null</c>.
</summary>
<returns>A <see cref="T:System.Threading.Tasks.Task"/> which will complete when the stream has finished being completed;
or <c>null</c> if this method has already been called.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.WriteCompleteAsync">
<summary>
Completes the stream when all buffered messages have been sent. This method can only be called
once, and further messages cannot be written after it has been called.
</summary>
<exception cref="T:System.InvalidOperationException">This method has already been called.</exception>
<returns>A <see cref="T:System.Threading.Tasks.Task"/> which will complete when the stream has finished being completed.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.GetResponseStream">
<summary>
Async stream to read streaming responses, exposed as an async sequence.
The default implementation will use <see cref="P:Google.Api.Gax.Grpc.BidirectionalStreamingBase`2.GrpcCall"/> to extract a response
stream, and adapt it to <see cref="T:Google.Api.Gax.Grpc.AsyncResponseStream`1"/>.
</summary>
<remarks>
If this method is called more than once, all the returned enumerators will be enumerating over the
same underlying response stream, which may cause confusion. Additionally, the sequence returned by
this method can only be iterated over a single time. Attempting to iterate more than once will cause
an <see cref="T:System.InvalidOperationException"/>.
</remarks>
</member>
<member name="T:Google.Api.Gax.Grpc.BidirectionalStreamingSettings">
<summary>
Settings for bidirectional streaming.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.BidirectionalStreamingSettings.#ctor(System.Int32)">
<summary>
Configure settings for bidirectional streaming.
</summary>
<param name="bufferedClientWriterCapacity">The capacity of the write buffer.</param>
</member>
<member name="P:Google.Api.Gax.Grpc.BidirectionalStreamingSettings.BufferedClientWriterCapacity">
<summary>
The capacity of the write buffer, that locally buffers streaming requests
before they are sent to the server.
</summary>
</member>
<member name="T:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1">
<summary>
A wrapper around <see cref="T:Grpc.Core.IClientStreamWriter`1"/> which removes the "one write at a time"
restriction by buffering messages (and the completion signal) up to a given capacity.
</summary>
<typeparam name="T">The type of message in the stream.</typeparam>
</member>
<member name="F:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1._queue">
<summary>
Queue of requests. If this is non-empty, there's at least one request in-flight, which
is always the head of the queue.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.Capacity">
<summary>
The capacity of the writer.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.BufferedWriteCount">
<summary>
The number of write calls that have been buffered.
</summary>
<remarks>
The value of this property may change due to activity from other threads. It should only be used
for testing and similar scenarios where the system state is well understood.
</remarks>
</member>
<member name="M:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.#ctor(Grpc.Core.IClientStreamWriter{`0},System.Int32)">
<summary>
Constructs an instance which writes to the specified writer, and with the given capacity.
</summary>
<param name="writer">The writer to delegate to.</param>
<param name="capacity">The maximum number of messages to buffer.</param>
</member>
<member name="M:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.TryWriteAsync(`0)">
<summary>
Writes a message to the stream, if there is enough space in the buffer and <see cref="M:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.WriteCompleteAsync"/>
hasn't already been called. The same write options will be used as for the previous message.
</summary>
<param name="message">The message to write.</param>
<returns><c>null</c> if the message queue is full or the stream has already been completed;
otherwise, a <see cref="T:System.Threading.Tasks.Task"/> which will complete when the message has been written to the stream.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.TryWriteAsync(`0,Grpc.Core.WriteOptions)">
<summary>
Writes a message to the stream, if there is enough space in the buffer and <see cref="M:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.WriteCompleteAsync"/>
hasn't already been called.
</summary>
<param name="message">The message to write.</param>
<param name="options">The write options to use for this message.</param>
<returns><c>null</c> if the message queue is full or the stream has already been completed.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.WriteAsync(`0)">
<summary>
Writes a message to the stream, if there is enough space in the buffer and <see cref="M:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.WriteCompleteAsync"/>
hasn't already been called. The same write options will be used as for the previous message.
</summary>
<param name="message">The message to write.</param>
<exception cref="T:System.InvalidOperationException">There isn't enough space left in the buffer,
or the stream has been completed.</exception>
<returns>A <see cref="T:System.Threading.Tasks.Task"/> which will complete when the message has been written to the stream.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.WriteAsync(`0,Grpc.Core.WriteOptions)">
<summary>
Writes a message to the stream, if there is enough space in the buffer and <see cref="M:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.WriteCompleteAsync"/>
hasn't already been called.
</summary>
<param name="message">The message to write.</param>
<param name="options">The write options to use for this message.</param>
<exception cref="T:System.InvalidOperationException">There isn't enough space left in the buffer,
or <see cref="M:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.WriteCompleteAsync"/> has already been called.</exception>
<returns>A <see cref="T:System.Threading.Tasks.Task"/> which will complete when the message has been written to the stream.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.HandleWriteComplete(System.Threading.Tasks.Task)">
<summary>
One of the writes completes - possibly successfully, possibly not. On success,
we start the next write (or complete) sending if there is one. On failure, we propagate the result
of this task to all other tasks. Those will in turn trigger further calls to this method,
but by that time we'll have retained the failed task so we can just exit quickly.
</summary>
<param name="writeResult"></param>
</member>
<member name="M:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.ValidateStateForWrite(System.Boolean,System.Boolean)">
<summary>
Validates that we can write to the stream, optionally throwing if there's an error.
This is basically to avoid a big chunk of code appearing in WriteAsyncImpl.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.TryWriteCompleteAsync">
<summary>
Completes the stream when all buffered messages have been sent, if there is enough space in the buffer.
This method can only be successfully called once, and further messages cannot be written after it
has been successfully called.
</summary>
<returns><c>null</c> if this stream has already be completed, or if the buffer is full; otherwise a
<see cref="T:System.Threading.Tasks.Task"/> which will complete when the stream has finished being completed.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.BufferedClientStreamWriter`1.WriteCompleteAsync">
<summary>
Completes the stream when all buffered messages have been sent, if there is enough space in the buffer.
This method can only be successfully called once, and further messages cannot be written after it
has been successfully called.
</summary>
<exception cref="T:System.InvalidOperationException">This stream has already be completed, or the buffer is full</exception>
<returns>A <see cref="T:System.Threading.Tasks.Task"/> which will complete when the stream has finished being completed.</returns>
</member>
<member name="T:Google.Api.Gax.Grpc.CallSettings">
<summary>
Settings to determine how an RPC operates. This type is immutable.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.#ctor(System.Nullable{System.Threading.CancellationToken},Google.Api.Gax.Expiration,Google.Api.Gax.Grpc.RetrySettings,System.Action{Grpc.Core.Metadata},Grpc.Core.WriteOptions,Grpc.Core.ContextPropagationToken)">
<summary>
Constructs an instance with the specified settings.
</summary>
<param name="cancellationToken">Cancellation token that can be used for cancelling the call.</param>
<param name="expiration"><see cref="P:Google.Api.Gax.Grpc.CallSettings.Expiration"/> to use, or null for default expiration behavior.</param>
<param name="retry"><see cref="P:Google.Api.Gax.Grpc.CallSettings.Retry"/> to use, or null for default retry behavior.</param>
<param name="headerMutation">Action to modify the headers to send at the beginning of the call.</param>
<param name="writeOptions"><see cref="T:Grpc.Core.WriteOptions"/> that will be used for the call.</param>
<param name="propagationToken"><see cref="T:Grpc.Core.ContextPropagationToken"/> for propagating settings from a parent call.</param>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.#ctor(System.Nullable{System.Threading.CancellationToken},Grpc.Core.CallCredentials,Google.Api.Gax.Expiration,Google.Api.Gax.Grpc.RetrySettings,System.Action{Grpc.Core.Metadata},Grpc.Core.WriteOptions,Grpc.Core.ContextPropagationToken)">
<summary>
Obsolete.
This is obsolete as it allows per-call credentials to be specified.
Please use <see cref="M:Google.Api.Gax.Grpc.CallSettings.#ctor(System.Nullable{System.Threading.CancellationToken},Google.Api.Gax.Expiration,Google.Api.Gax.Grpc.RetrySettings,System.Action{Grpc.Core.Metadata},Grpc.Core.WriteOptions,Grpc.Core.ContextPropagationToken)"/>,
and see https://github.com/googleapis/gax-dotnet/blob/master/docs/PER_CALL_CREDENTIAL.md for more information.
Constructs an instance with the specified settings.
</summary>
<param name="cancellationToken">Cancellation token that can be used for cancelling the call.</param>
<param name="credentials">Credentials to use for the call.</param>
<param name="expiration"><see cref="P:Google.Api.Gax.Grpc.CallSettings.Expiration"/> to use, or null for default expiration behavior.</param>
<param name="retry"><see cref="P:Google.Api.Gax.Grpc.CallSettings.Retry"/> to use, or null for default retry behavior.</param>
<param name="headerMutation">Action to modify the headers to send at the beginning of the call.</param>
<param name="writeOptions"><see cref="T:Grpc.Core.WriteOptions"/> that will be used for the call.</param>
<param name="propagationToken"><see cref="T:Grpc.Core.ContextPropagationToken"/> for propagating settings from a parent call.</param>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.#ctor(System.Nullable{System.Threading.CancellationToken},Google.Api.Gax.Expiration,Google.Api.Gax.Grpc.RetrySettings,System.Action{Grpc.Core.Metadata},Grpc.Core.WriteOptions,Grpc.Core.ContextPropagationToken,System.Action{Grpc.Core.Metadata},System.Action{Grpc.Core.Metadata})">
<summary>
Constructs an instance with the specified settings.
</summary>
<param name="cancellationToken">Cancellation token that can be used for cancelling the call.</param>
<param name="expiration"><see cref="P:Google.Api.Gax.Grpc.CallSettings.Expiration"/> to use, or null for default expiration behavior.</param>
<param name="retry"><see cref="P:Google.Api.Gax.Grpc.CallSettings.Retry"/> to use, or null for default retry behavior.</param>
<param name="headerMutation">Action to modify the headers to send at the beginning of the call.</param>
<param name="writeOptions"><see cref="T:Grpc.Core.WriteOptions"/> that will be used for the call.</param>
<param name="propagationToken"><see cref="T:Grpc.Core.ContextPropagationToken"/> for propagating settings from a parent call.</param>
<param name="responseMetadataHandler">Action to invoke when response metadata is received.</param>
<param name="trailingMetadataHandler">Action to invoke when trailing metadata is received.</param>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.#ctor(System.Nullable{System.Threading.CancellationToken},Grpc.Core.CallCredentials,Google.Api.Gax.Expiration,Google.Api.Gax.Grpc.RetrySettings,System.Action{Grpc.Core.Metadata},Grpc.Core.WriteOptions,Grpc.Core.ContextPropagationToken,System.Action{Grpc.Core.Metadata},System.Action{Grpc.Core.Metadata})">
<summary>
Obsolete.
This is obsolete as it allows per-call credentials to be specified.
Please use <see cref="M:Google.Api.Gax.Grpc.CallSettings.#ctor(System.Nullable{System.Threading.CancellationToken},Google.Api.Gax.Expiration,Google.Api.Gax.Grpc.RetrySettings,System.Action{Grpc.Core.Metadata},Grpc.Core.WriteOptions,Grpc.Core.ContextPropagationToken,System.Action{Grpc.Core.Metadata},System.Action{Grpc.Core.Metadata})"/>,
and see https://github.com/googleapis/gax-dotnet/blob/master/docs/PER_CALL_CREDENTIAL.md for more information.
Constructs an instance with the specified settings.
</summary>
<param name="cancellationToken">Cancellation token that can be used for cancelling the call.</param>
<param name="credentials">Credentials to use for the call.</param>
<param name="expiration"><see cref="P:Google.Api.Gax.Grpc.CallSettings.Expiration"/> to use, or null for default expiration behavior.</param>
<param name="retry"><see cref="P:Google.Api.Gax.Grpc.CallSettings.Retry"/> to use, or null for default retry behavior.</param>
<param name="headerMutation">Action to modify the headers to send at the beginning of the call.</param>
<param name="writeOptions"><see cref="T:Grpc.Core.WriteOptions"/> that will be used for the call.</param>
<param name="propagationToken"><see cref="T:Grpc.Core.ContextPropagationToken"/> for propagating settings from a parent call.</param>
<param name="responseMetadataHandler">Action to invoke when response metadata is received.</param>
<param name="trailingMetadataHandler">Action to invoke when trailing metadata is received.</param>
</member>
<member name="P:Google.Api.Gax.Grpc.CallSettings.HeaderMutation">
<summary>
Delegate to mutate the metadata which will be sent at the start of the call,
typically to add custom headers.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.CallSettings.CancellationToken">
<summary>
Cancellation token that can be used for cancelling the call.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.CallSettings.WriteOptions">
<summary>
<see cref="T:Grpc.Core.WriteOptions"/> that will be used for the call.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.CallSettings.PropagationToken">
<summary>
<see cref="T:Grpc.Core.ContextPropagationToken"/> for propagating settings from a parent call.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.CallSettings.Credentials">
<summary>
Credentials to use for the call.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.CallSettings.Expiration">
<summary>
The expiration for the call (either a timeout or a deadline), or null for the default expiration.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.CallSettings.Retry">
<summary>
<see cref="T:Google.Api.Gax.Grpc.RetrySettings"/> to use, or null for default retry behavior.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.CallSettings.ResponseMetadataHandler">
<summary>
Delegate to receive the metadata associated with a response.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.CallSettings.TrailingMetadataHandler">
<summary>
Delegate to receive the metadata sent after the response.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.Merge(Google.Api.Gax.Grpc.CallSettings,Google.Api.Gax.Grpc.CallSettings)">
<summary>
Merges the settings in <paramref name="overlaid"/> with those in
<paramref name="original"/>, with <paramref name="overlaid"/> taking priority.
If both arguments are null, the result is null. If one argument is null,
the other argument is returned. Otherwise, a new object is created with a property-wise
overlay. Any header mutations are combined, however: the mutation from the original is
performed, then the mutation in the overlay.
</summary>
<param name="original">Original settings. May be null.</param>
<param name="overlaid">Settings to overlay. May be null.</param>
<returns>A merged set of call settings.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.FromCancellationToken(System.Threading.CancellationToken)">
<summary>
Creates a <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> for the specified cancellation token.
</summary>
<param name="cancellationToken">The cancellation token for the new settings.</param>
<returns>A new instance.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.FromCallCredentials(Grpc.Core.CallCredentials)">
<summary>
Obsolete. See: https://github.com/googleapis/gax-dotnet/blob/master/PER_CALL_CREDENTIAL.md
Creates a <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> for the specified call credentials, or returns null
if <paramref name="credentials"/> is null.
</summary>
<param name="credentials">The call credentials for the new settings.</param>
<returns>A new instance, or null if <paramref name="credentials"/> is null.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.FromExpiration(Google.Api.Gax.Expiration)">
<summary>
Creates a <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> for the specified call expiration, or returns null
if <paramref name="expiration"/> is null.
</summary>
<param name="expiration">The call timing for the new settings.</param>
<returns>A new instance or null if <paramref name="expiration"/> is null..</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.FromRetry(Google.Api.Gax.Grpc.RetrySettings)">
<summary>
Creates a <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> for the specified retry settings, or returns null
if <paramref name="retry"/> is null.
</summary>
<param name="retry">The call timing for the new settings.</param>
<returns>A new instance or null if <paramref name="retry"/> is null..</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.FromHeaderMutation(System.Action{Grpc.Core.Metadata})">
<summary>
Creates a <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> for the specified header mutation, or returns null
if <paramref name="headerMutation"/> is null.
</summary>
<param name="headerMutation">Action to modify the headers to send at the beginning of the call.</param>
<returns>A new instance, or null if <paramref name="headerMutation"/> is null..</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.FromResponseMetadataHandler(System.Action{Grpc.Core.Metadata})">
<summary>
Creates a <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> for the specified response metadata handler, or returns null
if <paramref name="responseMetadataHandler"/> is null.
</summary>
<param name="responseMetadataHandler">Action to receive response metadata when the call completes.</param>
<returns>A new instance, or null if <paramref name="responseMetadataHandler"/> is null..</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.FromTrailingMetadataHandler(System.Action{Grpc.Core.Metadata})">
<summary>
Creates a <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> for the specified trailing metadata handler, or returns null
if <paramref name="trailingMetadataHandler"/> is null.
</summary>
<param name="trailingMetadataHandler">Action to receive trailing metadata when the call completes.</param>
<returns>A new instance, or null if <paramref name="trailingMetadataHandler"/> is null..</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.FromHeader(System.String,System.String)">
<summary>
Creates a <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> for the specified header name and value.
</summary>
<param name="name">The name of the header to add. Must not be null.</param>
<param name="value">The value of the header to add. Must not be null.</param>
<returns>A new instance.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.FromFieldMask(System.String)">
<summary>
Creates a <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> that will include a field mask in the request, to
limit which fields are returned in the response.
</summary>
<remarks>
The precise effect on the request is not guaranteed: it may be through a header or a side-channel,
for example. Likewise the effect of combining multiple settings containing field masks is not specified.
</remarks>
<param name="fieldMask">The field mask for the request. Must not be null.</param>
<returns>A new instance.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.FromGoogleRequestParamsHeader(System.String,System.String)">
<summary>
Creates a CallSettings which applies an x-goog-request-params header with the specified
parameter name and value.
</summary>
<remarks>The value is URL-encoded; it is expected that <paramref name="parameterName"/> is already URL-encoded.</remarks>
<param name="parameterName">The name of the parameter. Must not be null.</param>
<param name="value">The value of the parameter, which may be null. A null value is equivalent to providing an empty string.</param>
<returns>A CallSettings which applies the appropriate parameter.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettings.FromRequestReasonHeader(System.String)">
<summary>
Creates a CallSettings which applies an x-goog-request-reason header with the specified reason.
</summary>
<param name="reason">The request reason to specify in the x-goog-request-reason header. Must not be null</param>
<returns>A CallSettings which applies the appropriate header.</returns>
</member>
<member name="T:Google.Api.Gax.Grpc.CallSettingsExtensions">
<summary>
Extension methods for <see cref="T:Google.Api.Gax.Grpc.CallSettings"/>.
All methods accept a null first parameter as valid unless stated otherwise.
</summary>
</member>
<member name="F:Google.Api.Gax.Grpc.CallSettingsExtensions.QuotaProjectHeaderName">
<summary>
The header used to send the project ID used for billing and quotas.
The value should be set through the credential or the client builder,
never explicitly as a header.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettingsExtensions.MergedWith(Google.Api.Gax.Grpc.CallSettings,Google.Api.Gax.Grpc.CallSettings)">
<summary>
This method merges the settings in <paramref name="overlaid"/> with those in
<paramref name="original"/>, with <paramref name="overlaid"/> taking priority.
If both arguments are null, the result is null. If one argument is null,
the other argument is returned. Otherwise, a new object is created with a property-wise
overlay, where null values do not override non-null values.
Any header mutations are combined, however: the mutation from the original is
performed, then the mutation in the overlay.
</summary>
<param name="original">Original settings. May be null.</param>
<param name="overlaid">Settings to overlay. May be null.</param>
<returns>A merged set of call settings, or null if both parameters are null.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettingsExtensions.WithCancellationToken(Google.Api.Gax.Grpc.CallSettings,System.Threading.CancellationToken)">
<summary>
Returns a new <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> with the specified cancellation token,
merged with the (optional) original settings specified by <paramref name="settings"/>.
</summary>
<param name="settings">Original settings. May be null, in which case the returned settings
will only contain the cancellation token.</param>
<param name="cancellationToken">Cancellation token for the new call settings.</param>
<returns>A new set of call settings.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettingsExtensions.WithCallCredentials(Google.Api.Gax.Grpc.CallSettings,Grpc.Core.CallCredentials)">
<summary>
Obsolete. https://github.com/googleapis/gax-dotnet/blob/master/PER_CALL_CREDENTIAL.md
Returns a new <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> with the specified call credentials,
merged with the (optional) original settings specified by <paramref name="settings"/>.
</summary>
<param name="settings">Original settings. May be null, in which case the returned settings
will only contain call credentials.</param>
<param name="credentials">Call credentials for the new call settings.
This may be null, in which case any call credentials in <paramref name="settings"/> are
not present in the new call settings. If both this and <paramref name="settings"/> are null,
the return value is null.</param>
<returns>A new set of call settings, or null if both parameters are null.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettingsExtensions.WithExpiration(Google.Api.Gax.Grpc.CallSettings,Google.Api.Gax.Expiration)">
<summary>
Returns a new <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> with the specified expiration,
merged with the (optional) original settings specified by <paramref name="settings"/>.
</summary>
<param name="settings">Original settings. May be null, in which case the returned settings
will only contain the expiration.</param>
<param name="expiration">Expiration to use in the returned settings, possibly as part of a retry. May be null,
in which case any expiration in <paramref name="settings"/> is not present in the new call settings. If
both this and <paramref name="settings"/> are null, the return value is null.</param>
<returns>A new set of call settings with the specified expiration, or null of both parameters are null.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettingsExtensions.WithRetry(Google.Api.Gax.Grpc.CallSettings,Google.Api.Gax.Grpc.RetrySettings)">
<summary>
Returns a new <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> with the specified retry settings,
merged with the (optional) original settings specified by <paramref name="settings"/>.
</summary>
<param name="settings">Original settings. May be null, in which case the returned settings
will only contain call timing.</param>
<param name="retry">Call timing for the new call settings.
This may be null, in which case any retry settings in <paramref name="settings"/> are
not present in the new call settings. If both this and <paramref name="settings"/> are null,
the return value is null.</param>
<returns>A new set of call settings, or null if both parameters are null.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettingsExtensions.WithHeader(Google.Api.Gax.Grpc.CallSettings,System.String,System.String)">
<summary>
Returns a new <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> with the specified header,
merged with the (optional) original settings specified by <paramref name="settings"/>.
</summary>
<param name="settings">Original settings. May be null, in which case the returned settings
will only contain the header.</param>
<param name="name">Header name. Must not be null.</param>
<param name="value">Header value. Must not be null.</param>
<returns>A new set of call settings including the specified header.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettingsExtensions.WithResponseMetadataHandler(Google.Api.Gax.Grpc.CallSettings,System.Action{Grpc.Core.Metadata})">
<summary>
</summary>
<param name="handler"></param>
<param name="settings"></param>
<returns></returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettingsExtensions.WithTrailingMetadataHandler(Google.Api.Gax.Grpc.CallSettings,System.Action{Grpc.Core.Metadata})">
<summary>
</summary>
<param name="settings"></param>
<param name="handler"></param>
<returns></returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettingsExtensions.WithDeadline(Google.Api.Gax.Grpc.CallSettings,System.DateTime)">
<summary>
Returns a <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> which will have the specified deadline.
</summary>
<param name="settings">Existing settings. May be null, meaning there are currently no settings.</param>
<param name="deadline">The deadline for the new settings.</param>
<returns>A new <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> with the given deadline.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettingsExtensions.WithTimeout(Google.Api.Gax.Grpc.CallSettings,System.TimeSpan)">
<summary>
Returns a <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> which will have the specified timeout.
</summary>
<param name="settings">Existing settings. May be null, meaning there are currently no settings.</param>
<param name="timeout">The timeout for the new settings.</param>
<returns>A new <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> with the given timeout.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettingsExtensions.WithEarlierDeadline(Google.Api.Gax.Grpc.CallSettings,System.Nullable{System.DateTime},Google.Api.Gax.IClock)">
<summary>
Returns a <see cref="T:Google.Api.Gax.Grpc.CallSettings"/> which will have an effective deadline of at least <paramref name="deadline"/>.
If <paramref name="settings"/> already observes an earlier deadline (with respect to <paramref name="clock"/>),
or if <paramref name="deadline"/> is null, the original settings will be returned.
</summary>
<param name="settings">Existing settings. May be null, meaning there are currently no settings.</param>
<param name="deadline">Deadline to enforce. May be null, meaning there is no deadline to enforce.</param>
<param name="clock">The clock to use when computing deadlines. Must not be null.</param>
<returns>The call settings to use to observe the given deadline.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettingsExtensions.ValidateNoRetry(Google.Api.Gax.Grpc.CallSettings)">
<summary>
Throws <see cref="T:System.InvalidOperationException"/> if <paramref name="callSettings"/> is non-null and has a Retry;
otherwise returns the parameter.
</summary>
<param name="callSettings">The call settings for the call. May be null.</param>
<returns><paramref name="callSettings"/></returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettingsExtensions.ToCallOptions(Google.Api.Gax.Grpc.CallSettings,Google.Api.Gax.IClock)">
<summary>
Transfers settings contained in this into a <see cref="T:Grpc.Core.CallOptions"/>.
</summary>
<param name="callSettings">The call settings for the call. May be null.</param>
<param name="clock">The clock to use for deadline calculation.</param>
<returns>A <see cref="T:Grpc.Core.CallOptions"/> configured from this <see cref="T:Google.Api.Gax.Grpc.CallSettings"/>.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettingsExtensions.CheckMetadata(Grpc.Core.Metadata)">
<summary>
Method used to check that the headers set by the uer are valid.
Current only checks that the <code>x-goog-user-project</code> header is not set
directly by the user. It should be set either through the credential or the client builder.
</summary>
<param name="metadata">The user set headers.</param>
</member>
<member name="M:Google.Api.Gax.Grpc.CallSettingsExtensions.CheckHeader(System.String)">
<summary>
Method used to check if a header set by the uer is valid.
Current only checks that the <code>x-goog-user-project</code> header is not set
directly by the user. It should be set either through the credential or the client builder.
</summary>
<param name="header">The user set header.</param>
</member>
<member name="T:Google.Api.Gax.Grpc.ChannelPool">
<summary>
A pool of channels for the same service, but with potentially different endpoints. Each endpoint
has a single channel. All channels created by this pool use default application credentials.
This class is thread-safe.
</summary>
</member>
<member name="F:Google.Api.Gax.Grpc.ChannelPool._lazyScopedDefaultChannelCredentials">
<summary>
Lazily-created task to retrieve the default application channel credentials. Once completed, this
task can be used whenever channel credentials are required. The returned task always runs in the
thread pool, so its result can be used synchronously from synchronous methods without risk of deadlock.
The same channel credentials are used by all pools. The field is initialized in the constructor, as it uses
_scopes, and you can't refer to an instance field within an instance field initializer.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.ChannelPool.#ctor(System.Collections.Generic.IEnumerable{System.String})">
<summary>
Creates a channel pool which will apply the specified scopes to the default application credentials
if they require any.
</summary>
<param name="scopes">The scopes to apply. Must not be null, and must not contain null references. May be empty.</param>
</member>
<member name="M:Google.Api.Gax.Grpc.ChannelPool.ShutdownChannelsAsync">
<summary>
Shuts down all the currently-allocated channels asynchronously. This does not prevent the channel
pool from being used later on, but the currently-allocated channels will not be reused.
</summary>
<returns>A task which will complete when all the (current) channels have been shut down.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.ChannelPool.GetChannel(Google.Api.Gax.Grpc.GrpcAdapter,System.String,Google.Api.Gax.Grpc.GrpcChannelOptions)">
<summary>
Returns a channel from this pool, creating a new one if there is no channel
already associated with <paramref name="endpoint"/>.
The specified channel options are applied, but only those options.
</summary>
<param name="grpcAdapter">The gRPC implementation to use. Must not be null.</param>
<param name="endpoint">The endpoint to connect to. Must not be null.</param>
<param name="channelOptions">The channel options to include. May be null.</param>
<returns>A channel for the specified endpoint.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.ChannelPool.GetChannelAsync(Google.Api.Gax.Grpc.GrpcAdapter,System.String,Google.Api.Gax.Grpc.GrpcChannelOptions,System.Threading.CancellationToken)">
<summary>
Asynchronously returns a channel from this pool, creating a new one if there is no channel
already associated with <paramref name="endpoint"/>.
The specified channel options are applied, but only those options.
</summary>
<param name="grpcAdapter">The gRPC implementation to use. Must not be null.</param>
<param name="endpoint">The endpoint to connect to. Must not be null.</param>
<param name="channelOptions">The channel options to include. May be null.</param>
<param name="cancellationToken">A cancellation token for the operation.</param>
<returns>A task representing the asynchronous operation. The value of the completed
task will be channel for the specified endpoint.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.ChannelPool.WithCancellationToken``1(System.Threading.Tasks.Task{``0},System.Threading.CancellationToken)">
<summary>
Returns a task which can be cancelled by the given cancellation token, but otherwise observes the original
task's state. This does *not* cancel any work that the original task was doing, and should be used carefully.
</summary>
</member>
<member name="T:Google.Api.Gax.Grpc.ClientBuilderBase`1">
<summary>
Base class for API-specific builders.
</summary>
<typeparam name="TClient">The type of client created by this builder.</typeparam>
</member>
<member name="P:Google.Api.Gax.Grpc.ClientBuilderBase`1.Endpoint">
<summary>
The endpoint to connect to, or null to use the default endpoint.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.ClientBuilderBase`1.Scopes">
<summary>
The scopes to use, or null to use the default scopes.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.ClientBuilderBase`1.ChannelCredentials">
<summary>
The channel credentials to use, or null if credentials are being provided in a different way.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.ClientBuilderBase`1.CredentialsPath">
<summary>
The path to the credentials file to use, or null if credentials are being provided in a different way.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.ClientBuilderBase`1.JsonCredentials">
<summary>
The credentials to use as a JSON string, or null if credentials are being provided in a different way.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.ClientBuilderBase`1.TokenAccessMethod">
<summary>
The token access method to use, or null if credentials are being provided in a different way.
</summary>
<remarks>
<para>
To use a GoogleCredential for credentials, set this property using a method group conversion, e.g.
<c>TokenAccessMethod = credential.GetAccessTokenForRequestAsync</c>
</para>
</remarks>
</member>
<member name="P:Google.Api.Gax.Grpc.ClientBuilderBase`1.CallInvoker">
<summary>
The call invoker to use, or null to create the call invoker when the client is built.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.ClientBuilderBase`1.UserAgent">
<summary>
A custom user agent to specify in the channel metadata, or null if no custom user agent is required.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.ClientBuilderBase`1.GrpcAdapter">
<summary>
The gRPC implementation to use, or null to use the default implementation.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.ClientBuilderBase`1.EmulatorDetection">
<summary>
The emulator detection policy to apply when building a client. Derived classes which support
emulators should create public properties which delegate to this one. The default value is
<see cref="F:Google.Api.Gax.EmulatorDetection.None"/>.
</summary>
</member>
<member name="P:Google.Api.Gax.Grpc.ClientBuilderBase`1.QuotaProject">
<summary>
The GCP project ID that should be used for quota and billing purposes.
May be null.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.ClientBuilderBase`1.#ctor">
<summary>
Creates a new instance with no settings.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.ClientBuilderBase`1.CopyCommonSettings``1(Google.Api.Gax.Grpc.ClientBuilderBase{``0})">
<summary>
Copies common settings from the specified builder into this one. This is a shallow copy.
</summary>
<typeparam name="TOther">The other client type</typeparam>
<param name="source">The builder to copy from.</param>
</member>
<member name="M:Google.Api.Gax.Grpc.ClientBuilderBase`1.Validate">
<summary>
Validates that the builder is in a consistent state for building. For example, it's invalid to call
<see cref="M:Google.Api.Gax.Grpc.ClientBuilderBase`1.Build"/> on an instance which has both JSON credentials and a credentials path specified.
</summary>
<exception cref="T:System.InvalidOperationException">The builder is in an invalid state.</exception>
</member>
<member name="M:Google.Api.Gax.Grpc.ClientBuilderBase`1.GetEmulatorEnvironment(System.Collections.Generic.IEnumerable{System.String},System.Collections.Generic.IEnumerable{System.String},System.Func{System.String,System.String})">
<summary>
Performs basic emulator detection and validation based on the given environment variables.
This method is expected to be called by a derived class that supports emulators, in order to perform the common
work of checking whether the emulator is configured in the environment.
</summary>
<remarks>
<para>
If the emulator should not be used, either due to being disabled in <see cref="P:Google.Api.Gax.Grpc.ClientBuilderBase`1.EmulatorDetection"/> or
the appropriate environment variables not being set, this method returns null.
</para>
<para>
Otherwise, a dictionary is returned mapping every value in <paramref name="allEmulatorEnvironmentVariables"/> to the value in
the environment. Any missing, empty or whitespace-only values are mapped to a null reference in the returned dictionary, but
the entry will still be present (so callers can use an indexer with the returned dictionary for every environment variable passed in).
</para>
</remarks>
<exception cref="T:System.InvalidOperationException">The configuration is inconsistent, e.g. due to some environment variables
being set but not all the required ones, or any environment variables being set in a production-only environment.</exception>
<param name="requiredEmulatorEnvironmentVariables">Required emulator environment variables.</param>
<param name="allEmulatorEnvironmentVariables">All emulator environment variables.</param>
<param name="environmentVariableProvider">The provider used to retrieve environment variables. This is used to faciliate testing, and defaults
to using <see cref="M:System.Environment.GetEnvironmentVariable(System.String)"/>.</param>
<returns>A key/value mapping of the emulator environment variables to their values, or null if the emulator should not be used.</returns>
</member>
<member name="M:Google.Api.Gax.Grpc.ClientBuilderBase`1.ValidateAtMostOneNotNull(System.String,System.Object[])">
<summary>
Validates that at most one of the given values is not null.
</summary>
<param name="message">The message if the condition is violated.</param>
<param name="values">The values to check for nullity.</param>
<exception cref="T:System.InvalidOperationException">More than one value is null.</exception>
</member>
<member name="M:Google.Api.Gax.Grpc.ClientBuilderBase`1.ValidateOptionExcludesOthers(System.String,System.Object,System.Object[])">
<summary>
Validates that if <paramref name="controlling"/> is not null, then every value in <paramref name="values"/> is null.
</summary>
<param name="message">The message if the condition is violated.</param>
<param name="controlling">The value controlling whether or not any other value can be non-null.</param>
<param name="values">The values checked for non-nullity if <paramref name="controlling"/> is non-null.</param>
</member>
<member name="M:Google.Api.Gax.Grpc.ClientBuilderBase`1.CreateCallInvoker">
<summary>
Creates a call invoker synchronously. Override this method in a concrete builder type if more
call invoker mechanisms are supported.
This implementation calls <see cref="M:Google.Api.Gax.Grpc.ClientBuilderBase`1.GetChannelCredentials"/> if no call invoker is specified.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.ClientBuilderBase`1.CreateCallInvokerAsync(System.Threading.CancellationToken)">
<summary>
Creates a call invoker asynchronously. Override this method in a concrete builder type if more
call invoker mechanisms are supported.
This implementation calls <see cref="M:Google.Api.Gax.Grpc.ClientBuilderBase`1.GetChannelCredentialsAsync(System.Threading.CancellationToken)"/> if no call
invoker is specified.
</summary>
</member>
<member name="M:Google.Api.Gax.Grpc.ClientBuilderBase`1.GetChannelCredentials">
<summary>
Obtains channel credentials synchronously. Override this method in a concrete builder type if more