MailKit.xml 3.1 MB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922592359245925592659275928592959305931593259335934593559365937593859395940594159425943594459455946594759485949595059515952595359545955595659575958595959605961596259635964596559665967596859695970597159725973597459755976597759785979598059815982598359845985598659875988598959905991599259935994599559965997599859996000600160026003600460056006600760086009601060116012601360146015601660176018601960206021602260236024602560266027602860296030603160326033603460356036603760386039604060416042604360446045604660476048604960506051605260536054605560566057605860596060606160626063606460656066606760686069607060716072607360746075607660776078607960806081608260836084608560866087608860896090609160926093609460956096609760986099610061016102610361046105610661076108610961106111611261136114611561166117611861196120612161226123612461256126612761286129613061316132613361346135613661376138613961406141614261436144614561466147614861496150615161526153615461556156615761586159616061616162616361646165616661676168616961706171617261736174617561766177617861796180618161826183618461856186618761886189619061916192619361946195619661976198619962006201620262036204620562066207620862096210621162126213621462156216621762186219622062216222622362246225622662276228622962306231623262336234623562366237623862396240624162426243624462456246624762486249625062516252625362546255625662576258625962606261626262636264626562666267626862696270627162726273627462756276627762786279628062816282628362846285628662876288628962906291629262936294629562966297629862996300630163026303630463056306630763086309631063116312631363146315631663176318631963206321632263236324632563266327632863296330633163326333633463356336633763386339634063416342634363446345634663476348634963506351635263536354635563566357635863596360636163626363636463656366636763686369637063716372637363746375637663776378637963806381638263836384638563866387638863896390639163926393639463956396639763986399640064016402640364046405640664076408640964106411641264136414641564166417641864196420642164226423642464256426642764286429643064316432643364346435643664376438643964406441644264436444644564466447644864496450645164526453645464556456645764586459646064616462646364646465646664676468646964706471647264736474647564766477647864796480648164826483648464856486648764886489649064916492649364946495649664976498649965006501650265036504650565066507650865096510651165126513651465156516651765186519652065216522652365246525652665276528652965306531653265336534653565366537653865396540654165426543654465456546654765486549655065516552655365546555655665576558655965606561656265636564656565666567656865696570657165726573657465756576657765786579658065816582658365846585658665876588658965906591659265936594659565966597659865996600660166026603660466056606660766086609661066116612661366146615661666176618661966206621662266236624662566266627662866296630663166326633663466356636663766386639664066416642664366446645664666476648664966506651665266536654665566566657665866596660666166626663666466656666666766686669667066716672667366746675667666776678667966806681668266836684668566866687668866896690669166926693669466956696669766986699670067016702670367046705670667076708670967106711671267136714671567166717671867196720672167226723672467256726672767286729673067316732673367346735673667376738673967406741674267436744674567466747674867496750675167526753675467556756675767586759676067616762676367646765676667676768676967706771677267736774677567766777677867796780678167826783678467856786678767886789679067916792679367946795679667976798679968006801680268036804680568066807680868096810681168126813681468156816681768186819682068216822682368246825682668276828682968306831683268336834683568366837683868396840684168426843684468456846684768486849685068516852685368546855685668576858685968606861686268636864686568666867686868696870687168726873687468756876687768786879688068816882688368846885688668876888688968906891689268936894689568966897689868996900690169026903690469056906690769086909691069116912691369146915691669176918691969206921692269236924692569266927692869296930693169326933693469356936693769386939694069416942694369446945694669476948694969506951695269536954695569566957695869596960696169626963696469656966696769686969697069716972697369746975697669776978697969806981698269836984698569866987698869896990699169926993699469956996699769986999700070017002700370047005700670077008700970107011701270137014701570167017701870197020702170227023702470257026702770287029703070317032703370347035703670377038703970407041704270437044704570467047704870497050705170527053705470557056705770587059706070617062706370647065706670677068706970707071707270737074707570767077707870797080708170827083708470857086708770887089709070917092709370947095709670977098709971007101710271037104710571067107710871097110711171127113711471157116711771187119712071217122712371247125712671277128712971307131713271337134713571367137713871397140714171427143714471457146714771487149715071517152715371547155715671577158715971607161716271637164716571667167716871697170717171727173717471757176717771787179718071817182718371847185718671877188718971907191719271937194719571967197719871997200720172027203720472057206720772087209721072117212721372147215721672177218721972207221722272237224722572267227722872297230723172327233723472357236723772387239724072417242724372447245724672477248724972507251725272537254725572567257725872597260726172627263726472657266726772687269727072717272727372747275727672777278727972807281728272837284728572867287728872897290729172927293729472957296729772987299730073017302730373047305730673077308730973107311731273137314731573167317731873197320732173227323732473257326732773287329733073317332733373347335733673377338733973407341734273437344734573467347734873497350735173527353735473557356735773587359736073617362736373647365736673677368736973707371737273737374737573767377737873797380738173827383738473857386738773887389739073917392739373947395739673977398739974007401740274037404740574067407740874097410741174127413741474157416741774187419742074217422742374247425742674277428742974307431743274337434743574367437743874397440744174427443744474457446744774487449745074517452745374547455745674577458745974607461746274637464746574667467746874697470747174727473747474757476747774787479748074817482748374847485748674877488748974907491749274937494749574967497749874997500750175027503750475057506750775087509751075117512751375147515751675177518751975207521752275237524752575267527752875297530753175327533753475357536753775387539754075417542754375447545754675477548754975507551755275537554755575567557755875597560756175627563756475657566756775687569757075717572757375747575757675777578757975807581758275837584758575867587758875897590759175927593759475957596759775987599760076017602760376047605760676077608760976107611761276137614761576167617761876197620762176227623762476257626762776287629763076317632763376347635763676377638763976407641764276437644764576467647764876497650765176527653765476557656765776587659766076617662766376647665766676677668766976707671767276737674767576767677767876797680768176827683768476857686768776887689769076917692769376947695769676977698769977007701770277037704770577067707770877097710771177127713771477157716771777187719772077217722772377247725772677277728772977307731773277337734773577367737773877397740774177427743774477457746774777487749775077517752775377547755775677577758775977607761776277637764776577667767776877697770777177727773777477757776777777787779778077817782778377847785778677877788778977907791779277937794779577967797779877997800780178027803780478057806780778087809781078117812781378147815781678177818781978207821782278237824782578267827782878297830783178327833783478357836783778387839784078417842784378447845784678477848784978507851785278537854785578567857785878597860786178627863786478657866786778687869787078717872787378747875787678777878787978807881788278837884788578867887788878897890789178927893789478957896789778987899790079017902790379047905790679077908790979107911791279137914791579167917791879197920792179227923792479257926792779287929793079317932793379347935793679377938793979407941794279437944794579467947794879497950795179527953795479557956795779587959796079617962796379647965796679677968796979707971797279737974797579767977797879797980798179827983798479857986798779887989799079917992799379947995799679977998799980008001800280038004800580068007800880098010801180128013801480158016801780188019802080218022802380248025802680278028802980308031803280338034803580368037803880398040804180428043804480458046804780488049805080518052805380548055805680578058805980608061806280638064806580668067806880698070807180728073807480758076807780788079808080818082808380848085808680878088808980908091809280938094809580968097809880998100810181028103810481058106810781088109811081118112811381148115811681178118811981208121812281238124812581268127812881298130813181328133813481358136813781388139814081418142814381448145814681478148814981508151815281538154815581568157815881598160816181628163816481658166816781688169817081718172817381748175817681778178817981808181818281838184818581868187818881898190819181928193819481958196819781988199820082018202820382048205820682078208820982108211821282138214821582168217821882198220822182228223822482258226822782288229823082318232823382348235823682378238823982408241824282438244824582468247824882498250825182528253825482558256825782588259826082618262826382648265826682678268826982708271827282738274827582768277827882798280828182828283828482858286828782888289829082918292829382948295829682978298829983008301830283038304830583068307830883098310831183128313831483158316831783188319832083218322832383248325832683278328832983308331833283338334833583368337833883398340834183428343834483458346834783488349835083518352835383548355835683578358835983608361836283638364836583668367836883698370837183728373837483758376837783788379838083818382838383848385838683878388838983908391839283938394839583968397839883998400840184028403840484058406840784088409841084118412841384148415841684178418841984208421842284238424842584268427842884298430843184328433843484358436843784388439844084418442844384448445844684478448844984508451845284538454845584568457845884598460846184628463846484658466846784688469847084718472847384748475847684778478847984808481848284838484848584868487848884898490849184928493849484958496849784988499850085018502850385048505850685078508850985108511851285138514851585168517851885198520852185228523852485258526852785288529853085318532853385348535853685378538853985408541854285438544854585468547854885498550855185528553855485558556855785588559856085618562856385648565856685678568856985708571857285738574857585768577857885798580858185828583858485858586858785888589859085918592859385948595859685978598859986008601860286038604860586068607860886098610861186128613861486158616861786188619862086218622862386248625862686278628862986308631863286338634863586368637863886398640864186428643864486458646864786488649865086518652865386548655865686578658865986608661866286638664866586668667866886698670867186728673867486758676867786788679868086818682868386848685868686878688868986908691869286938694869586968697869886998700870187028703870487058706870787088709871087118712871387148715871687178718871987208721872287238724872587268727872887298730873187328733873487358736873787388739874087418742874387448745874687478748874987508751875287538754875587568757875887598760876187628763876487658766876787688769877087718772877387748775877687778778877987808781878287838784878587868787878887898790879187928793879487958796879787988799880088018802880388048805880688078808880988108811881288138814881588168817881888198820882188228823882488258826882788288829883088318832883388348835883688378838883988408841884288438844884588468847884888498850885188528853885488558856885788588859886088618862886388648865886688678868886988708871887288738874887588768877887888798880888188828883888488858886888788888889889088918892889388948895889688978898889989008901890289038904890589068907890889098910891189128913891489158916891789188919892089218922892389248925892689278928892989308931893289338934893589368937893889398940894189428943894489458946894789488949895089518952895389548955895689578958895989608961896289638964896589668967896889698970897189728973897489758976897789788979898089818982898389848985898689878988898989908991899289938994899589968997899889999000900190029003900490059006900790089009901090119012901390149015901690179018901990209021902290239024902590269027902890299030903190329033903490359036903790389039904090419042904390449045904690479048904990509051905290539054905590569057905890599060906190629063906490659066906790689069907090719072907390749075907690779078907990809081908290839084908590869087908890899090909190929093909490959096909790989099910091019102910391049105910691079108910991109111911291139114911591169117911891199120912191229123912491259126912791289129913091319132913391349135913691379138913991409141914291439144914591469147914891499150915191529153915491559156915791589159916091619162916391649165916691679168916991709171917291739174917591769177917891799180918191829183918491859186918791889189919091919192919391949195919691979198919992009201920292039204920592069207920892099210921192129213921492159216921792189219922092219222922392249225922692279228922992309231923292339234923592369237923892399240924192429243924492459246924792489249925092519252925392549255925692579258925992609261926292639264926592669267926892699270927192729273927492759276927792789279928092819282928392849285928692879288928992909291929292939294929592969297929892999300930193029303930493059306930793089309931093119312931393149315931693179318931993209321932293239324932593269327932893299330933193329333933493359336933793389339934093419342934393449345934693479348934993509351935293539354935593569357935893599360936193629363936493659366936793689369937093719372937393749375937693779378937993809381938293839384938593869387938893899390939193929393939493959396939793989399940094019402940394049405940694079408940994109411941294139414941594169417941894199420942194229423942494259426942794289429943094319432943394349435943694379438943994409441944294439444944594469447944894499450945194529453945494559456945794589459946094619462946394649465946694679468946994709471947294739474947594769477947894799480948194829483948494859486948794889489949094919492949394949495949694979498949995009501950295039504950595069507950895099510951195129513951495159516951795189519952095219522952395249525952695279528952995309531953295339534953595369537953895399540954195429543954495459546954795489549955095519552955395549555955695579558955995609561956295639564956595669567956895699570957195729573957495759576957795789579958095819582958395849585958695879588958995909591959295939594959595969597959895999600960196029603960496059606960796089609961096119612961396149615961696179618961996209621962296239624962596269627962896299630963196329633963496359636963796389639964096419642964396449645964696479648964996509651965296539654965596569657965896599660966196629663966496659666966796689669967096719672967396749675967696779678967996809681968296839684968596869687968896899690969196929693969496959696969796989699970097019702970397049705970697079708970997109711971297139714971597169717971897199720972197229723972497259726972797289729973097319732973397349735973697379738973997409741974297439744974597469747974897499750975197529753975497559756975797589759976097619762976397649765976697679768976997709771977297739774977597769777977897799780978197829783978497859786978797889789979097919792979397949795979697979798979998009801980298039804980598069807980898099810981198129813981498159816981798189819982098219822982398249825982698279828982998309831983298339834983598369837983898399840984198429843984498459846984798489849985098519852985398549855985698579858985998609861986298639864986598669867986898699870987198729873987498759876987798789879988098819882988398849885988698879888988998909891989298939894989598969897989898999900990199029903990499059906990799089909991099119912991399149915991699179918991999209921992299239924992599269927992899299930993199329933993499359936993799389939994099419942994399449945994699479948994999509951995299539954995599569957995899599960996199629963996499659966996799689969997099719972997399749975997699779978997999809981998299839984998599869987998899899990999199929993999499959996999799989999100001000110002100031000410005100061000710008100091001010011100121001310014100151001610017100181001910020100211002210023100241002510026100271002810029100301003110032100331003410035100361003710038100391004010041100421004310044100451004610047100481004910050100511005210053100541005510056100571005810059100601006110062100631006410065100661006710068100691007010071100721007310074100751007610077100781007910080100811008210083100841008510086100871008810089100901009110092100931009410095100961009710098100991010010101101021010310104101051010610107101081010910110101111011210113101141011510116101171011810119101201012110122101231012410125101261012710128101291013010131101321013310134101351013610137101381013910140101411014210143101441014510146101471014810149101501015110152101531015410155101561015710158101591016010161101621016310164101651016610167101681016910170101711017210173101741017510176101771017810179101801018110182101831018410185101861018710188101891019010191101921019310194101951019610197101981019910200102011020210203102041020510206102071020810209102101021110212102131021410215102161021710218102191022010221102221022310224102251022610227102281022910230102311023210233102341023510236102371023810239102401024110242102431024410245102461024710248102491025010251102521025310254102551025610257102581025910260102611026210263102641026510266102671026810269102701027110272102731027410275102761027710278102791028010281102821028310284102851028610287102881028910290102911029210293102941029510296102971029810299103001030110302103031030410305103061030710308103091031010311103121031310314103151031610317103181031910320103211032210323103241032510326103271032810329103301033110332103331033410335103361033710338103391034010341103421034310344103451034610347103481034910350103511035210353103541035510356103571035810359103601036110362103631036410365103661036710368103691037010371103721037310374103751037610377103781037910380103811038210383103841038510386103871038810389103901039110392103931039410395103961039710398103991040010401104021040310404104051040610407104081040910410104111041210413104141041510416104171041810419104201042110422104231042410425104261042710428104291043010431104321043310434104351043610437104381043910440104411044210443104441044510446104471044810449104501045110452104531045410455104561045710458104591046010461104621046310464104651046610467104681046910470104711047210473104741047510476104771047810479104801048110482104831048410485104861048710488104891049010491104921049310494104951049610497104981049910500105011050210503105041050510506105071050810509105101051110512105131051410515105161051710518105191052010521105221052310524105251052610527105281052910530105311053210533105341053510536105371053810539105401054110542105431054410545105461054710548105491055010551105521055310554105551055610557105581055910560105611056210563105641056510566105671056810569105701057110572105731057410575105761057710578105791058010581105821058310584105851058610587105881058910590105911059210593105941059510596105971059810599106001060110602106031060410605106061060710608106091061010611106121061310614106151061610617106181061910620106211062210623106241062510626106271062810629106301063110632106331063410635106361063710638106391064010641106421064310644106451064610647106481064910650106511065210653106541065510656106571065810659106601066110662106631066410665106661066710668106691067010671106721067310674106751067610677106781067910680106811068210683106841068510686106871068810689106901069110692106931069410695106961069710698106991070010701107021070310704107051070610707107081070910710107111071210713107141071510716107171071810719107201072110722107231072410725107261072710728107291073010731107321073310734107351073610737107381073910740107411074210743107441074510746107471074810749107501075110752107531075410755107561075710758107591076010761107621076310764107651076610767107681076910770107711077210773107741077510776107771077810779107801078110782107831078410785107861078710788107891079010791107921079310794107951079610797107981079910800108011080210803108041080510806108071080810809108101081110812108131081410815108161081710818108191082010821108221082310824108251082610827108281082910830108311083210833108341083510836108371083810839108401084110842108431084410845108461084710848108491085010851108521085310854108551085610857108581085910860108611086210863108641086510866108671086810869108701087110872108731087410875108761087710878108791088010881108821088310884108851088610887108881088910890108911089210893108941089510896108971089810899109001090110902109031090410905109061090710908109091091010911109121091310914109151091610917109181091910920109211092210923109241092510926109271092810929109301093110932109331093410935109361093710938109391094010941109421094310944109451094610947109481094910950109511095210953109541095510956109571095810959109601096110962109631096410965109661096710968109691097010971109721097310974109751097610977109781097910980109811098210983109841098510986109871098810989109901099110992109931099410995109961099710998109991100011001110021100311004110051100611007110081100911010110111101211013110141101511016110171101811019110201102111022110231102411025110261102711028110291103011031110321103311034110351103611037110381103911040110411104211043110441104511046110471104811049110501105111052110531105411055110561105711058110591106011061110621106311064110651106611067110681106911070110711107211073110741107511076110771107811079110801108111082110831108411085110861108711088110891109011091110921109311094110951109611097110981109911100111011110211103111041110511106111071110811109111101111111112111131111411115111161111711118111191112011121111221112311124111251112611127111281112911130111311113211133111341113511136111371113811139111401114111142111431114411145111461114711148111491115011151111521115311154111551115611157111581115911160111611116211163111641116511166111671116811169111701117111172111731117411175111761117711178111791118011181111821118311184111851118611187111881118911190111911119211193111941119511196111971119811199112001120111202112031120411205112061120711208112091121011211112121121311214112151121611217112181121911220112211122211223112241122511226112271122811229112301123111232112331123411235112361123711238112391124011241112421124311244112451124611247112481124911250112511125211253112541125511256112571125811259112601126111262112631126411265112661126711268112691127011271112721127311274112751127611277112781127911280112811128211283112841128511286112871128811289112901129111292112931129411295112961129711298112991130011301113021130311304113051130611307113081130911310113111131211313113141131511316113171131811319113201132111322113231132411325113261132711328113291133011331113321133311334113351133611337113381133911340113411134211343113441134511346113471134811349113501135111352113531135411355113561135711358113591136011361113621136311364113651136611367113681136911370113711137211373113741137511376113771137811379113801138111382113831138411385113861138711388113891139011391113921139311394113951139611397113981139911400114011140211403114041140511406114071140811409114101141111412114131141411415114161141711418114191142011421114221142311424114251142611427114281142911430114311143211433114341143511436114371143811439114401144111442114431144411445114461144711448114491145011451114521145311454114551145611457114581145911460114611146211463114641146511466114671146811469114701147111472114731147411475114761147711478114791148011481114821148311484114851148611487114881148911490114911149211493114941149511496114971149811499115001150111502115031150411505115061150711508115091151011511115121151311514115151151611517115181151911520115211152211523115241152511526115271152811529115301153111532115331153411535115361153711538115391154011541115421154311544115451154611547115481154911550115511155211553115541155511556115571155811559115601156111562115631156411565115661156711568115691157011571115721157311574115751157611577115781157911580115811158211583115841158511586115871158811589115901159111592115931159411595115961159711598115991160011601116021160311604116051160611607116081160911610116111161211613116141161511616116171161811619116201162111622116231162411625116261162711628116291163011631116321163311634116351163611637116381163911640116411164211643116441164511646116471164811649116501165111652116531165411655116561165711658116591166011661116621166311664116651166611667116681166911670116711167211673116741167511676116771167811679116801168111682116831168411685116861168711688116891169011691116921169311694116951169611697116981169911700117011170211703117041170511706117071170811709117101171111712117131171411715117161171711718117191172011721117221172311724117251172611727117281172911730117311173211733117341173511736117371173811739117401174111742117431174411745117461174711748117491175011751117521175311754117551175611757117581175911760117611176211763117641176511766117671176811769117701177111772117731177411775117761177711778117791178011781117821178311784117851178611787117881178911790117911179211793117941179511796117971179811799118001180111802118031180411805118061180711808118091181011811118121181311814118151181611817118181181911820118211182211823118241182511826118271182811829118301183111832118331183411835118361183711838118391184011841118421184311844118451184611847118481184911850118511185211853118541185511856118571185811859118601186111862118631186411865118661186711868118691187011871118721187311874118751187611877118781187911880118811188211883118841188511886118871188811889118901189111892118931189411895118961189711898118991190011901119021190311904119051190611907119081190911910119111191211913119141191511916119171191811919119201192111922119231192411925119261192711928119291193011931119321193311934119351193611937119381193911940119411194211943119441194511946119471194811949119501195111952119531195411955119561195711958119591196011961119621196311964119651196611967119681196911970119711197211973119741197511976119771197811979119801198111982119831198411985119861198711988119891199011991119921199311994119951199611997119981199912000120011200212003120041200512006120071200812009120101201112012120131201412015120161201712018120191202012021120221202312024120251202612027120281202912030120311203212033120341203512036120371203812039120401204112042120431204412045120461204712048120491205012051120521205312054120551205612057120581205912060120611206212063120641206512066120671206812069120701207112072120731207412075120761207712078120791208012081120821208312084120851208612087120881208912090120911209212093120941209512096120971209812099121001210112102121031210412105121061210712108121091211012111121121211312114121151211612117121181211912120121211212212123121241212512126121271212812129121301213112132121331213412135121361213712138121391214012141121421214312144121451214612147121481214912150121511215212153121541215512156121571215812159121601216112162121631216412165121661216712168121691217012171121721217312174121751217612177121781217912180121811218212183121841218512186121871218812189121901219112192121931219412195121961219712198121991220012201122021220312204122051220612207122081220912210122111221212213122141221512216122171221812219122201222112222122231222412225122261222712228122291223012231122321223312234122351223612237122381223912240122411224212243122441224512246122471224812249122501225112252122531225412255122561225712258122591226012261122621226312264122651226612267122681226912270122711227212273122741227512276122771227812279122801228112282122831228412285122861228712288122891229012291122921229312294122951229612297122981229912300123011230212303123041230512306123071230812309123101231112312123131231412315123161231712318123191232012321123221232312324123251232612327123281232912330123311233212333123341233512336123371233812339123401234112342123431234412345123461234712348123491235012351123521235312354123551235612357123581235912360123611236212363123641236512366123671236812369123701237112372123731237412375123761237712378123791238012381123821238312384123851238612387123881238912390123911239212393123941239512396123971239812399124001240112402124031240412405124061240712408124091241012411124121241312414124151241612417124181241912420124211242212423124241242512426124271242812429124301243112432124331243412435124361243712438124391244012441124421244312444124451244612447124481244912450124511245212453124541245512456124571245812459124601246112462124631246412465124661246712468124691247012471124721247312474124751247612477124781247912480124811248212483124841248512486124871248812489124901249112492124931249412495124961249712498124991250012501125021250312504125051250612507125081250912510125111251212513125141251512516125171251812519125201252112522125231252412525125261252712528125291253012531125321253312534125351253612537125381253912540125411254212543125441254512546125471254812549125501255112552125531255412555125561255712558125591256012561125621256312564125651256612567125681256912570125711257212573125741257512576125771257812579125801258112582125831258412585125861258712588125891259012591125921259312594125951259612597125981259912600126011260212603126041260512606126071260812609126101261112612126131261412615126161261712618126191262012621126221262312624126251262612627126281262912630126311263212633126341263512636126371263812639126401264112642126431264412645126461264712648126491265012651126521265312654126551265612657126581265912660126611266212663126641266512666126671266812669126701267112672126731267412675126761267712678126791268012681126821268312684126851268612687126881268912690126911269212693126941269512696126971269812699127001270112702127031270412705127061270712708127091271012711127121271312714127151271612717127181271912720127211272212723127241272512726127271272812729127301273112732127331273412735127361273712738127391274012741127421274312744127451274612747127481274912750127511275212753127541275512756127571275812759127601276112762127631276412765127661276712768127691277012771127721277312774127751277612777127781277912780127811278212783127841278512786127871278812789127901279112792127931279412795127961279712798127991280012801128021280312804128051280612807128081280912810128111281212813128141281512816128171281812819128201282112822128231282412825128261282712828128291283012831128321283312834128351283612837128381283912840128411284212843128441284512846128471284812849128501285112852128531285412855128561285712858128591286012861128621286312864128651286612867128681286912870128711287212873128741287512876128771287812879128801288112882128831288412885128861288712888128891289012891128921289312894128951289612897128981289912900129011290212903129041290512906129071290812909129101291112912129131291412915129161291712918129191292012921129221292312924129251292612927129281292912930129311293212933129341293512936129371293812939129401294112942129431294412945129461294712948129491295012951129521295312954129551295612957129581295912960129611296212963129641296512966129671296812969129701297112972129731297412975129761297712978129791298012981129821298312984129851298612987129881298912990129911299212993129941299512996129971299812999130001300113002130031300413005130061300713008130091301013011130121301313014130151301613017130181301913020130211302213023130241302513026130271302813029130301303113032130331303413035130361303713038130391304013041130421304313044130451304613047130481304913050130511305213053130541305513056130571305813059130601306113062130631306413065130661306713068130691307013071130721307313074130751307613077130781307913080130811308213083130841308513086130871308813089130901309113092130931309413095130961309713098130991310013101131021310313104131051310613107131081310913110131111311213113131141311513116131171311813119131201312113122131231312413125131261312713128131291313013131131321313313134131351313613137131381313913140131411314213143131441314513146131471314813149131501315113152131531315413155131561315713158131591316013161131621316313164131651316613167131681316913170131711317213173131741317513176131771317813179131801318113182131831318413185131861318713188131891319013191131921319313194131951319613197131981319913200132011320213203132041320513206132071320813209132101321113212132131321413215132161321713218132191322013221132221322313224132251322613227132281322913230132311323213233132341323513236132371323813239132401324113242132431324413245132461324713248132491325013251132521325313254132551325613257132581325913260132611326213263132641326513266132671326813269132701327113272132731327413275132761327713278132791328013281132821328313284132851328613287132881328913290132911329213293132941329513296132971329813299133001330113302133031330413305133061330713308133091331013311133121331313314133151331613317133181331913320133211332213323133241332513326133271332813329133301333113332133331333413335133361333713338133391334013341133421334313344133451334613347133481334913350133511335213353133541335513356133571335813359133601336113362133631336413365133661336713368133691337013371133721337313374133751337613377133781337913380133811338213383133841338513386133871338813389133901339113392133931339413395133961339713398133991340013401134021340313404134051340613407134081340913410134111341213413134141341513416134171341813419134201342113422134231342413425134261342713428134291343013431134321343313434134351343613437134381343913440134411344213443134441344513446134471344813449134501345113452134531345413455134561345713458134591346013461134621346313464134651346613467134681346913470134711347213473134741347513476134771347813479134801348113482134831348413485134861348713488134891349013491134921349313494134951349613497134981349913500135011350213503135041350513506135071350813509135101351113512135131351413515135161351713518135191352013521135221352313524135251352613527135281352913530135311353213533135341353513536135371353813539135401354113542135431354413545135461354713548135491355013551135521355313554135551355613557135581355913560135611356213563135641356513566135671356813569135701357113572135731357413575135761357713578135791358013581135821358313584135851358613587135881358913590135911359213593135941359513596135971359813599136001360113602136031360413605136061360713608136091361013611136121361313614136151361613617136181361913620136211362213623136241362513626136271362813629136301363113632136331363413635136361363713638136391364013641136421364313644136451364613647136481364913650136511365213653136541365513656136571365813659136601366113662136631366413665136661366713668136691367013671136721367313674136751367613677136781367913680136811368213683136841368513686136871368813689136901369113692136931369413695136961369713698136991370013701137021370313704137051370613707137081370913710137111371213713137141371513716137171371813719137201372113722137231372413725137261372713728137291373013731137321373313734137351373613737137381373913740137411374213743137441374513746137471374813749137501375113752137531375413755137561375713758137591376013761137621376313764137651376613767137681376913770137711377213773137741377513776137771377813779137801378113782137831378413785137861378713788137891379013791137921379313794137951379613797137981379913800138011380213803138041380513806138071380813809138101381113812138131381413815138161381713818138191382013821138221382313824138251382613827138281382913830138311383213833138341383513836138371383813839138401384113842138431384413845138461384713848138491385013851138521385313854138551385613857138581385913860138611386213863138641386513866138671386813869138701387113872138731387413875138761387713878138791388013881138821388313884138851388613887138881388913890138911389213893138941389513896138971389813899139001390113902139031390413905139061390713908139091391013911139121391313914139151391613917139181391913920139211392213923139241392513926139271392813929139301393113932139331393413935139361393713938139391394013941139421394313944139451394613947139481394913950139511395213953139541395513956139571395813959139601396113962139631396413965139661396713968139691397013971139721397313974139751397613977139781397913980139811398213983139841398513986139871398813989139901399113992139931399413995139961399713998139991400014001140021400314004140051400614007140081400914010140111401214013140141401514016140171401814019140201402114022140231402414025140261402714028140291403014031140321403314034140351403614037140381403914040140411404214043140441404514046140471404814049140501405114052140531405414055140561405714058140591406014061140621406314064140651406614067140681406914070140711407214073140741407514076140771407814079140801408114082140831408414085140861408714088140891409014091140921409314094140951409614097140981409914100141011410214103141041410514106141071410814109141101411114112141131411414115141161411714118141191412014121141221412314124141251412614127141281412914130141311413214133141341413514136141371413814139141401414114142141431414414145141461414714148141491415014151141521415314154141551415614157141581415914160141611416214163141641416514166141671416814169141701417114172141731417414175141761417714178141791418014181141821418314184141851418614187141881418914190141911419214193141941419514196141971419814199142001420114202142031420414205142061420714208142091421014211142121421314214142151421614217142181421914220142211422214223142241422514226142271422814229142301423114232142331423414235142361423714238142391424014241142421424314244142451424614247142481424914250142511425214253142541425514256142571425814259142601426114262142631426414265142661426714268142691427014271142721427314274142751427614277142781427914280142811428214283142841428514286142871428814289142901429114292142931429414295142961429714298142991430014301143021430314304143051430614307143081430914310143111431214313143141431514316143171431814319143201432114322143231432414325143261432714328143291433014331143321433314334143351433614337143381433914340143411434214343143441434514346143471434814349143501435114352143531435414355143561435714358143591436014361143621436314364143651436614367143681436914370143711437214373143741437514376143771437814379143801438114382143831438414385143861438714388143891439014391143921439314394143951439614397143981439914400144011440214403144041440514406144071440814409144101441114412144131441414415144161441714418144191442014421144221442314424144251442614427144281442914430144311443214433144341443514436144371443814439144401444114442144431444414445144461444714448144491445014451144521445314454144551445614457144581445914460144611446214463144641446514466144671446814469144701447114472144731447414475144761447714478144791448014481144821448314484144851448614487144881448914490144911449214493144941449514496144971449814499145001450114502145031450414505145061450714508145091451014511145121451314514145151451614517145181451914520145211452214523145241452514526145271452814529145301453114532145331453414535145361453714538145391454014541145421454314544145451454614547145481454914550145511455214553145541455514556145571455814559145601456114562145631456414565145661456714568145691457014571145721457314574145751457614577145781457914580145811458214583145841458514586145871458814589145901459114592145931459414595145961459714598145991460014601146021460314604146051460614607146081460914610146111461214613146141461514616146171461814619146201462114622146231462414625146261462714628146291463014631146321463314634146351463614637146381463914640146411464214643146441464514646146471464814649146501465114652146531465414655146561465714658146591466014661146621466314664146651466614667146681466914670146711467214673146741467514676146771467814679146801468114682146831468414685146861468714688146891469014691146921469314694146951469614697146981469914700147011470214703147041470514706147071470814709147101471114712147131471414715147161471714718147191472014721147221472314724147251472614727147281472914730147311473214733147341473514736147371473814739147401474114742147431474414745147461474714748147491475014751147521475314754147551475614757147581475914760147611476214763147641476514766147671476814769147701477114772147731477414775147761477714778147791478014781147821478314784147851478614787147881478914790147911479214793147941479514796147971479814799148001480114802148031480414805148061480714808148091481014811148121481314814148151481614817148181481914820148211482214823148241482514826148271482814829148301483114832148331483414835148361483714838148391484014841148421484314844148451484614847148481484914850148511485214853148541485514856148571485814859148601486114862148631486414865148661486714868148691487014871148721487314874148751487614877148781487914880148811488214883148841488514886148871488814889148901489114892148931489414895148961489714898148991490014901149021490314904149051490614907149081490914910149111491214913149141491514916149171491814919149201492114922149231492414925149261492714928149291493014931149321493314934149351493614937149381493914940149411494214943149441494514946149471494814949149501495114952149531495414955149561495714958149591496014961149621496314964149651496614967149681496914970149711497214973149741497514976149771497814979149801498114982149831498414985149861498714988149891499014991149921499314994149951499614997149981499915000150011500215003150041500515006150071500815009150101501115012150131501415015150161501715018150191502015021150221502315024150251502615027150281502915030150311503215033150341503515036150371503815039150401504115042150431504415045150461504715048150491505015051150521505315054150551505615057150581505915060150611506215063150641506515066150671506815069150701507115072150731507415075150761507715078150791508015081150821508315084150851508615087150881508915090150911509215093150941509515096150971509815099151001510115102151031510415105151061510715108151091511015111151121511315114151151511615117151181511915120151211512215123151241512515126151271512815129151301513115132151331513415135151361513715138151391514015141151421514315144151451514615147151481514915150151511515215153151541515515156151571515815159151601516115162151631516415165151661516715168151691517015171151721517315174151751517615177151781517915180151811518215183151841518515186151871518815189151901519115192151931519415195151961519715198151991520015201152021520315204152051520615207152081520915210152111521215213152141521515216152171521815219152201522115222152231522415225152261522715228152291523015231152321523315234152351523615237152381523915240152411524215243152441524515246152471524815249152501525115252152531525415255152561525715258152591526015261152621526315264152651526615267152681526915270152711527215273152741527515276152771527815279152801528115282152831528415285152861528715288152891529015291152921529315294152951529615297152981529915300153011530215303153041530515306153071530815309153101531115312153131531415315153161531715318153191532015321153221532315324153251532615327153281532915330153311533215333153341533515336153371533815339153401534115342153431534415345153461534715348153491535015351153521535315354153551535615357153581535915360153611536215363153641536515366153671536815369153701537115372153731537415375153761537715378153791538015381153821538315384153851538615387153881538915390153911539215393153941539515396153971539815399154001540115402154031540415405154061540715408154091541015411154121541315414154151541615417154181541915420154211542215423154241542515426154271542815429154301543115432154331543415435154361543715438154391544015441154421544315444154451544615447154481544915450154511545215453154541545515456154571545815459154601546115462154631546415465154661546715468154691547015471154721547315474154751547615477154781547915480154811548215483154841548515486154871548815489154901549115492154931549415495154961549715498154991550015501155021550315504155051550615507155081550915510155111551215513155141551515516155171551815519155201552115522155231552415525155261552715528155291553015531155321553315534155351553615537155381553915540155411554215543155441554515546155471554815549155501555115552155531555415555155561555715558155591556015561155621556315564155651556615567155681556915570155711557215573155741557515576155771557815579155801558115582155831558415585155861558715588155891559015591155921559315594155951559615597155981559915600156011560215603156041560515606156071560815609156101561115612156131561415615156161561715618156191562015621156221562315624156251562615627156281562915630156311563215633156341563515636156371563815639156401564115642156431564415645156461564715648156491565015651156521565315654156551565615657156581565915660156611566215663156641566515666156671566815669156701567115672156731567415675156761567715678156791568015681156821568315684156851568615687156881568915690156911569215693156941569515696156971569815699157001570115702157031570415705157061570715708157091571015711157121571315714157151571615717157181571915720157211572215723157241572515726157271572815729157301573115732157331573415735157361573715738157391574015741157421574315744157451574615747157481574915750157511575215753157541575515756157571575815759157601576115762157631576415765157661576715768157691577015771157721577315774157751577615777157781577915780157811578215783157841578515786157871578815789157901579115792157931579415795157961579715798157991580015801158021580315804158051580615807158081580915810158111581215813158141581515816158171581815819158201582115822158231582415825158261582715828158291583015831158321583315834158351583615837158381583915840158411584215843158441584515846158471584815849158501585115852158531585415855158561585715858158591586015861158621586315864158651586615867158681586915870158711587215873158741587515876158771587815879158801588115882158831588415885158861588715888158891589015891158921589315894158951589615897158981589915900159011590215903159041590515906159071590815909159101591115912159131591415915159161591715918159191592015921159221592315924159251592615927159281592915930159311593215933159341593515936159371593815939159401594115942159431594415945159461594715948159491595015951159521595315954159551595615957159581595915960159611596215963159641596515966159671596815969159701597115972159731597415975159761597715978159791598015981159821598315984159851598615987159881598915990159911599215993159941599515996159971599815999160001600116002160031600416005160061600716008160091601016011160121601316014160151601616017160181601916020160211602216023160241602516026160271602816029160301603116032160331603416035160361603716038160391604016041160421604316044160451604616047160481604916050160511605216053160541605516056160571605816059160601606116062160631606416065160661606716068160691607016071160721607316074160751607616077160781607916080160811608216083160841608516086160871608816089160901609116092160931609416095160961609716098160991610016101161021610316104161051610616107161081610916110161111611216113161141611516116161171611816119161201612116122161231612416125161261612716128161291613016131161321613316134161351613616137161381613916140161411614216143161441614516146161471614816149161501615116152161531615416155161561615716158161591616016161161621616316164161651616616167161681616916170161711617216173161741617516176161771617816179161801618116182161831618416185161861618716188161891619016191161921619316194161951619616197161981619916200162011620216203162041620516206162071620816209162101621116212162131621416215162161621716218162191622016221162221622316224162251622616227162281622916230162311623216233162341623516236162371623816239162401624116242162431624416245162461624716248162491625016251162521625316254162551625616257162581625916260162611626216263162641626516266162671626816269162701627116272162731627416275162761627716278162791628016281162821628316284162851628616287162881628916290162911629216293162941629516296162971629816299163001630116302163031630416305163061630716308163091631016311163121631316314163151631616317163181631916320163211632216323163241632516326163271632816329163301633116332163331633416335163361633716338163391634016341163421634316344163451634616347163481634916350163511635216353163541635516356163571635816359163601636116362163631636416365163661636716368163691637016371163721637316374163751637616377163781637916380163811638216383163841638516386163871638816389163901639116392163931639416395163961639716398163991640016401164021640316404164051640616407164081640916410164111641216413164141641516416164171641816419164201642116422164231642416425164261642716428164291643016431164321643316434164351643616437164381643916440164411644216443164441644516446164471644816449164501645116452164531645416455164561645716458164591646016461164621646316464164651646616467164681646916470164711647216473164741647516476164771647816479164801648116482164831648416485164861648716488164891649016491164921649316494164951649616497164981649916500165011650216503165041650516506165071650816509165101651116512165131651416515165161651716518165191652016521165221652316524165251652616527165281652916530165311653216533165341653516536165371653816539165401654116542165431654416545165461654716548165491655016551165521655316554165551655616557165581655916560165611656216563165641656516566165671656816569165701657116572165731657416575165761657716578165791658016581165821658316584165851658616587165881658916590165911659216593165941659516596165971659816599166001660116602166031660416605166061660716608166091661016611166121661316614166151661616617166181661916620166211662216623166241662516626166271662816629166301663116632166331663416635166361663716638166391664016641166421664316644166451664616647166481664916650166511665216653166541665516656166571665816659166601666116662166631666416665166661666716668166691667016671166721667316674166751667616677166781667916680166811668216683166841668516686166871668816689166901669116692166931669416695166961669716698166991670016701167021670316704167051670616707167081670916710167111671216713167141671516716167171671816719167201672116722167231672416725167261672716728167291673016731167321673316734167351673616737167381673916740167411674216743167441674516746167471674816749167501675116752167531675416755167561675716758167591676016761167621676316764167651676616767167681676916770167711677216773167741677516776167771677816779167801678116782167831678416785167861678716788167891679016791167921679316794167951679616797167981679916800168011680216803168041680516806168071680816809168101681116812168131681416815168161681716818168191682016821168221682316824168251682616827168281682916830168311683216833168341683516836168371683816839168401684116842168431684416845168461684716848168491685016851168521685316854168551685616857168581685916860168611686216863168641686516866168671686816869168701687116872168731687416875168761687716878168791688016881168821688316884168851688616887168881688916890168911689216893168941689516896168971689816899169001690116902169031690416905169061690716908169091691016911169121691316914169151691616917169181691916920169211692216923169241692516926169271692816929169301693116932169331693416935169361693716938169391694016941169421694316944169451694616947169481694916950169511695216953169541695516956169571695816959169601696116962169631696416965169661696716968169691697016971169721697316974169751697616977169781697916980169811698216983169841698516986169871698816989169901699116992169931699416995169961699716998169991700017001170021700317004170051700617007170081700917010170111701217013170141701517016170171701817019170201702117022170231702417025170261702717028170291703017031170321703317034170351703617037170381703917040170411704217043170441704517046170471704817049170501705117052170531705417055170561705717058170591706017061170621706317064170651706617067170681706917070170711707217073170741707517076170771707817079170801708117082170831708417085170861708717088170891709017091170921709317094170951709617097170981709917100171011710217103171041710517106171071710817109171101711117112171131711417115171161711717118171191712017121171221712317124171251712617127171281712917130171311713217133171341713517136171371713817139171401714117142171431714417145171461714717148171491715017151171521715317154171551715617157171581715917160171611716217163171641716517166171671716817169171701717117172171731717417175171761717717178171791718017181171821718317184171851718617187171881718917190171911719217193171941719517196171971719817199172001720117202172031720417205172061720717208172091721017211172121721317214172151721617217172181721917220172211722217223172241722517226172271722817229172301723117232172331723417235172361723717238172391724017241172421724317244172451724617247172481724917250172511725217253172541725517256172571725817259172601726117262172631726417265172661726717268172691727017271172721727317274172751727617277172781727917280172811728217283172841728517286172871728817289172901729117292172931729417295172961729717298172991730017301173021730317304173051730617307173081730917310173111731217313173141731517316173171731817319173201732117322173231732417325173261732717328173291733017331173321733317334173351733617337173381733917340173411734217343173441734517346173471734817349173501735117352173531735417355173561735717358173591736017361173621736317364173651736617367173681736917370173711737217373173741737517376173771737817379173801738117382173831738417385173861738717388173891739017391173921739317394173951739617397173981739917400174011740217403174041740517406174071740817409174101741117412174131741417415174161741717418174191742017421174221742317424174251742617427174281742917430174311743217433174341743517436174371743817439174401744117442174431744417445174461744717448174491745017451174521745317454174551745617457174581745917460174611746217463174641746517466174671746817469174701747117472174731747417475174761747717478174791748017481174821748317484174851748617487174881748917490174911749217493174941749517496174971749817499175001750117502175031750417505175061750717508175091751017511175121751317514175151751617517175181751917520175211752217523175241752517526175271752817529175301753117532175331753417535175361753717538175391754017541175421754317544175451754617547175481754917550175511755217553175541755517556175571755817559175601756117562175631756417565175661756717568175691757017571175721757317574175751757617577175781757917580175811758217583175841758517586175871758817589175901759117592175931759417595175961759717598175991760017601176021760317604176051760617607176081760917610176111761217613176141761517616176171761817619176201762117622176231762417625176261762717628176291763017631176321763317634176351763617637176381763917640176411764217643176441764517646176471764817649176501765117652176531765417655176561765717658176591766017661176621766317664176651766617667176681766917670176711767217673176741767517676176771767817679176801768117682176831768417685176861768717688176891769017691176921769317694176951769617697176981769917700177011770217703177041770517706177071770817709177101771117712177131771417715177161771717718177191772017721177221772317724177251772617727177281772917730177311773217733177341773517736177371773817739177401774117742177431774417745177461774717748177491775017751177521775317754177551775617757177581775917760177611776217763177641776517766177671776817769177701777117772177731777417775177761777717778177791778017781177821778317784177851778617787177881778917790177911779217793177941779517796177971779817799178001780117802178031780417805178061780717808178091781017811178121781317814178151781617817178181781917820178211782217823178241782517826178271782817829178301783117832178331783417835178361783717838178391784017841178421784317844178451784617847178481784917850178511785217853178541785517856178571785817859178601786117862178631786417865178661786717868178691787017871178721787317874178751787617877178781787917880178811788217883178841788517886178871788817889178901789117892178931789417895178961789717898178991790017901179021790317904179051790617907179081790917910179111791217913179141791517916179171791817919179201792117922179231792417925179261792717928179291793017931179321793317934179351793617937179381793917940179411794217943179441794517946179471794817949179501795117952179531795417955179561795717958179591796017961179621796317964179651796617967179681796917970179711797217973179741797517976179771797817979179801798117982179831798417985179861798717988179891799017991179921799317994179951799617997179981799918000180011800218003180041800518006180071800818009180101801118012180131801418015180161801718018180191802018021180221802318024180251802618027180281802918030180311803218033180341803518036180371803818039180401804118042180431804418045180461804718048180491805018051180521805318054180551805618057180581805918060180611806218063180641806518066180671806818069180701807118072180731807418075180761807718078180791808018081180821808318084180851808618087180881808918090180911809218093180941809518096180971809818099181001810118102181031810418105181061810718108181091811018111181121811318114181151811618117181181811918120181211812218123181241812518126181271812818129181301813118132181331813418135181361813718138181391814018141181421814318144181451814618147181481814918150181511815218153181541815518156181571815818159181601816118162181631816418165181661816718168181691817018171181721817318174181751817618177181781817918180181811818218183181841818518186181871818818189181901819118192181931819418195181961819718198181991820018201182021820318204182051820618207182081820918210182111821218213182141821518216182171821818219182201822118222182231822418225182261822718228182291823018231182321823318234182351823618237182381823918240182411824218243182441824518246182471824818249182501825118252182531825418255182561825718258182591826018261182621826318264182651826618267182681826918270182711827218273182741827518276182771827818279182801828118282182831828418285182861828718288182891829018291182921829318294182951829618297182981829918300183011830218303183041830518306183071830818309183101831118312183131831418315183161831718318183191832018321183221832318324183251832618327183281832918330183311833218333183341833518336183371833818339183401834118342183431834418345183461834718348183491835018351183521835318354183551835618357183581835918360183611836218363183641836518366183671836818369183701837118372183731837418375183761837718378183791838018381183821838318384183851838618387183881838918390183911839218393183941839518396183971839818399184001840118402184031840418405184061840718408184091841018411184121841318414184151841618417184181841918420184211842218423184241842518426184271842818429184301843118432184331843418435184361843718438184391844018441184421844318444184451844618447184481844918450184511845218453184541845518456184571845818459184601846118462184631846418465184661846718468184691847018471184721847318474184751847618477184781847918480184811848218483184841848518486184871848818489184901849118492184931849418495184961849718498184991850018501185021850318504185051850618507185081850918510185111851218513185141851518516185171851818519185201852118522185231852418525185261852718528185291853018531185321853318534185351853618537185381853918540185411854218543185441854518546185471854818549185501855118552185531855418555185561855718558185591856018561185621856318564185651856618567185681856918570185711857218573185741857518576185771857818579185801858118582185831858418585185861858718588185891859018591185921859318594185951859618597185981859918600186011860218603186041860518606186071860818609186101861118612186131861418615186161861718618186191862018621186221862318624186251862618627186281862918630186311863218633186341863518636186371863818639186401864118642186431864418645186461864718648186491865018651186521865318654186551865618657186581865918660186611866218663186641866518666186671866818669186701867118672186731867418675186761867718678186791868018681186821868318684186851868618687186881868918690186911869218693186941869518696186971869818699187001870118702187031870418705187061870718708187091871018711187121871318714187151871618717187181871918720187211872218723187241872518726187271872818729187301873118732187331873418735187361873718738187391874018741187421874318744187451874618747187481874918750187511875218753187541875518756187571875818759187601876118762187631876418765187661876718768187691877018771187721877318774187751877618777187781877918780187811878218783187841878518786187871878818789187901879118792187931879418795187961879718798187991880018801188021880318804188051880618807188081880918810188111881218813188141881518816188171881818819188201882118822188231882418825188261882718828188291883018831188321883318834188351883618837188381883918840188411884218843188441884518846188471884818849188501885118852188531885418855188561885718858188591886018861188621886318864188651886618867188681886918870188711887218873188741887518876188771887818879188801888118882188831888418885188861888718888188891889018891188921889318894188951889618897188981889918900189011890218903189041890518906189071890818909189101891118912189131891418915189161891718918189191892018921189221892318924189251892618927189281892918930189311893218933189341893518936189371893818939189401894118942189431894418945189461894718948189491895018951189521895318954189551895618957189581895918960189611896218963189641896518966189671896818969189701897118972189731897418975189761897718978189791898018981189821898318984189851898618987189881898918990189911899218993189941899518996189971899818999190001900119002190031900419005190061900719008190091901019011190121901319014190151901619017190181901919020190211902219023190241902519026190271902819029190301903119032190331903419035190361903719038190391904019041190421904319044190451904619047190481904919050190511905219053190541905519056190571905819059190601906119062190631906419065190661906719068190691907019071190721907319074190751907619077190781907919080190811908219083190841908519086190871908819089190901909119092190931909419095190961909719098190991910019101191021910319104191051910619107191081910919110191111911219113191141911519116191171911819119191201912119122191231912419125191261912719128191291913019131191321913319134191351913619137191381913919140191411914219143191441914519146191471914819149191501915119152191531915419155191561915719158191591916019161191621916319164191651916619167191681916919170191711917219173191741917519176191771917819179191801918119182191831918419185191861918719188191891919019191191921919319194191951919619197191981919919200192011920219203192041920519206192071920819209192101921119212192131921419215192161921719218192191922019221192221922319224192251922619227192281922919230192311923219233192341923519236192371923819239192401924119242192431924419245192461924719248192491925019251192521925319254192551925619257192581925919260192611926219263192641926519266192671926819269192701927119272192731927419275192761927719278192791928019281192821928319284192851928619287192881928919290192911929219293192941929519296192971929819299193001930119302193031930419305193061930719308193091931019311193121931319314193151931619317193181931919320193211932219323193241932519326193271932819329193301933119332193331933419335193361933719338193391934019341193421934319344193451934619347193481934919350193511935219353193541935519356193571935819359193601936119362193631936419365193661936719368193691937019371193721937319374193751937619377193781937919380193811938219383193841938519386193871938819389193901939119392193931939419395193961939719398193991940019401194021940319404194051940619407194081940919410194111941219413194141941519416194171941819419194201942119422194231942419425194261942719428194291943019431194321943319434194351943619437194381943919440194411944219443194441944519446194471944819449194501945119452194531945419455194561945719458194591946019461194621946319464194651946619467194681946919470194711947219473194741947519476194771947819479194801948119482194831948419485194861948719488194891949019491194921949319494194951949619497194981949919500195011950219503195041950519506195071950819509195101951119512195131951419515195161951719518195191952019521195221952319524195251952619527195281952919530195311953219533195341953519536195371953819539195401954119542195431954419545195461954719548195491955019551195521955319554195551955619557195581955919560195611956219563195641956519566195671956819569195701957119572195731957419575195761957719578195791958019581195821958319584195851958619587195881958919590195911959219593195941959519596195971959819599196001960119602196031960419605196061960719608196091961019611196121961319614196151961619617196181961919620196211962219623196241962519626196271962819629196301963119632196331963419635196361963719638196391964019641196421964319644196451964619647196481964919650196511965219653196541965519656196571965819659196601966119662196631966419665196661966719668196691967019671196721967319674196751967619677196781967919680196811968219683196841968519686196871968819689196901969119692196931969419695196961969719698196991970019701197021970319704197051970619707197081970919710197111971219713197141971519716197171971819719197201972119722197231972419725197261972719728197291973019731197321973319734197351973619737197381973919740197411974219743197441974519746197471974819749197501975119752197531975419755197561975719758197591976019761197621976319764197651976619767197681976919770197711977219773197741977519776197771977819779197801978119782197831978419785197861978719788197891979019791197921979319794197951979619797197981979919800198011980219803198041980519806198071980819809198101981119812198131981419815198161981719818198191982019821198221982319824198251982619827198281982919830198311983219833198341983519836198371983819839198401984119842198431984419845198461984719848198491985019851198521985319854198551985619857198581985919860198611986219863198641986519866198671986819869198701987119872198731987419875198761987719878198791988019881198821988319884198851988619887198881988919890198911989219893198941989519896198971989819899199001990119902199031990419905199061990719908199091991019911199121991319914199151991619917199181991919920199211992219923199241992519926199271992819929199301993119932199331993419935199361993719938199391994019941199421994319944199451994619947199481994919950199511995219953199541995519956199571995819959199601996119962199631996419965199661996719968199691997019971199721997319974199751997619977199781997919980199811998219983199841998519986199871998819989199901999119992199931999419995199961999719998199992000020001200022000320004200052000620007200082000920010200112001220013200142001520016200172001820019200202002120022200232002420025200262002720028200292003020031200322003320034200352003620037200382003920040200412004220043200442004520046200472004820049200502005120052200532005420055200562005720058200592006020061200622006320064200652006620067200682006920070200712007220073200742007520076200772007820079200802008120082200832008420085200862008720088200892009020091200922009320094200952009620097200982009920100201012010220103201042010520106201072010820109201102011120112201132011420115201162011720118201192012020121201222012320124201252012620127201282012920130201312013220133201342013520136201372013820139201402014120142201432014420145201462014720148201492015020151201522015320154201552015620157201582015920160201612016220163201642016520166201672016820169201702017120172201732017420175201762017720178201792018020181201822018320184201852018620187201882018920190201912019220193201942019520196201972019820199202002020120202202032020420205202062020720208202092021020211202122021320214202152021620217202182021920220202212022220223202242022520226202272022820229202302023120232202332023420235202362023720238202392024020241202422024320244202452024620247202482024920250202512025220253202542025520256202572025820259202602026120262202632026420265202662026720268202692027020271202722027320274202752027620277202782027920280202812028220283202842028520286202872028820289202902029120292202932029420295202962029720298202992030020301203022030320304203052030620307203082030920310203112031220313203142031520316203172031820319203202032120322203232032420325203262032720328203292033020331203322033320334203352033620337203382033920340203412034220343203442034520346203472034820349203502035120352203532035420355203562035720358203592036020361203622036320364203652036620367203682036920370203712037220373203742037520376203772037820379203802038120382203832038420385203862038720388203892039020391203922039320394203952039620397203982039920400204012040220403204042040520406204072040820409204102041120412204132041420415204162041720418204192042020421204222042320424204252042620427204282042920430204312043220433204342043520436204372043820439204402044120442204432044420445204462044720448204492045020451204522045320454204552045620457204582045920460204612046220463204642046520466204672046820469204702047120472204732047420475204762047720478204792048020481204822048320484204852048620487204882048920490204912049220493204942049520496204972049820499205002050120502205032050420505205062050720508205092051020511205122051320514205152051620517205182051920520205212052220523205242052520526205272052820529205302053120532205332053420535205362053720538205392054020541205422054320544205452054620547205482054920550205512055220553205542055520556205572055820559205602056120562205632056420565205662056720568205692057020571205722057320574205752057620577205782057920580205812058220583205842058520586205872058820589205902059120592205932059420595205962059720598205992060020601206022060320604206052060620607206082060920610206112061220613206142061520616206172061820619206202062120622206232062420625206262062720628206292063020631206322063320634206352063620637206382063920640206412064220643206442064520646206472064820649206502065120652206532065420655206562065720658206592066020661206622066320664206652066620667206682066920670206712067220673206742067520676206772067820679206802068120682206832068420685206862068720688206892069020691206922069320694206952069620697206982069920700207012070220703207042070520706207072070820709207102071120712207132071420715207162071720718207192072020721207222072320724207252072620727207282072920730207312073220733207342073520736207372073820739207402074120742207432074420745207462074720748207492075020751207522075320754207552075620757207582075920760207612076220763207642076520766207672076820769207702077120772207732077420775207762077720778207792078020781207822078320784207852078620787207882078920790207912079220793207942079520796207972079820799208002080120802208032080420805208062080720808208092081020811208122081320814208152081620817208182081920820208212082220823208242082520826208272082820829208302083120832208332083420835208362083720838208392084020841208422084320844208452084620847208482084920850208512085220853208542085520856208572085820859208602086120862208632086420865208662086720868208692087020871208722087320874208752087620877208782087920880208812088220883208842088520886208872088820889208902089120892208932089420895208962089720898208992090020901209022090320904209052090620907209082090920910209112091220913209142091520916209172091820919209202092120922209232092420925209262092720928209292093020931209322093320934209352093620937209382093920940209412094220943209442094520946209472094820949209502095120952209532095420955209562095720958209592096020961209622096320964209652096620967209682096920970209712097220973209742097520976209772097820979209802098120982209832098420985209862098720988209892099020991209922099320994209952099620997209982099921000210012100221003210042100521006210072100821009210102101121012210132101421015210162101721018210192102021021210222102321024210252102621027210282102921030210312103221033210342103521036210372103821039210402104121042210432104421045210462104721048210492105021051210522105321054210552105621057210582105921060210612106221063210642106521066210672106821069210702107121072210732107421075210762107721078210792108021081210822108321084210852108621087210882108921090210912109221093210942109521096210972109821099211002110121102211032110421105211062110721108211092111021111211122111321114211152111621117211182111921120211212112221123211242112521126211272112821129211302113121132211332113421135211362113721138211392114021141211422114321144211452114621147211482114921150211512115221153211542115521156211572115821159211602116121162211632116421165211662116721168211692117021171211722117321174211752117621177211782117921180211812118221183211842118521186211872118821189211902119121192211932119421195211962119721198211992120021201212022120321204212052120621207212082120921210212112121221213212142121521216212172121821219212202122121222212232122421225212262122721228212292123021231212322123321234212352123621237212382123921240212412124221243212442124521246212472124821249212502125121252212532125421255212562125721258212592126021261212622126321264212652126621267212682126921270212712127221273212742127521276212772127821279212802128121282212832128421285212862128721288212892129021291212922129321294212952129621297212982129921300213012130221303213042130521306213072130821309213102131121312213132131421315213162131721318213192132021321213222132321324213252132621327213282132921330213312133221333213342133521336213372133821339213402134121342213432134421345213462134721348213492135021351213522135321354213552135621357213582135921360213612136221363213642136521366213672136821369213702137121372213732137421375213762137721378213792138021381213822138321384213852138621387213882138921390213912139221393213942139521396213972139821399214002140121402214032140421405214062140721408214092141021411214122141321414214152141621417214182141921420214212142221423214242142521426214272142821429214302143121432214332143421435214362143721438214392144021441214422144321444214452144621447214482144921450214512145221453214542145521456214572145821459214602146121462214632146421465214662146721468214692147021471214722147321474214752147621477214782147921480214812148221483214842148521486214872148821489214902149121492214932149421495214962149721498214992150021501215022150321504215052150621507215082150921510215112151221513215142151521516215172151821519215202152121522215232152421525215262152721528215292153021531215322153321534215352153621537215382153921540215412154221543215442154521546215472154821549215502155121552215532155421555215562155721558215592156021561215622156321564215652156621567215682156921570215712157221573215742157521576215772157821579215802158121582215832158421585215862158721588215892159021591215922159321594215952159621597215982159921600216012160221603216042160521606216072160821609216102161121612216132161421615216162161721618216192162021621216222162321624216252162621627216282162921630216312163221633216342163521636216372163821639216402164121642216432164421645216462164721648216492165021651216522165321654216552165621657216582165921660216612166221663216642166521666216672166821669216702167121672216732167421675216762167721678216792168021681216822168321684216852168621687216882168921690216912169221693216942169521696216972169821699217002170121702217032170421705217062170721708217092171021711217122171321714217152171621717217182171921720217212172221723217242172521726217272172821729217302173121732217332173421735217362173721738217392174021741217422174321744217452174621747217482174921750217512175221753217542175521756217572175821759217602176121762217632176421765217662176721768217692177021771217722177321774217752177621777217782177921780217812178221783217842178521786217872178821789217902179121792217932179421795217962179721798217992180021801218022180321804218052180621807218082180921810218112181221813218142181521816218172181821819218202182121822218232182421825218262182721828218292183021831218322183321834218352183621837218382183921840218412184221843218442184521846218472184821849218502185121852218532185421855218562185721858218592186021861218622186321864218652186621867218682186921870218712187221873218742187521876218772187821879218802188121882218832188421885218862188721888218892189021891218922189321894218952189621897218982189921900219012190221903219042190521906219072190821909219102191121912219132191421915219162191721918219192192021921219222192321924219252192621927219282192921930219312193221933219342193521936219372193821939219402194121942219432194421945219462194721948219492195021951219522195321954219552195621957219582195921960219612196221963219642196521966219672196821969219702197121972219732197421975219762197721978219792198021981219822198321984219852198621987219882198921990219912199221993219942199521996219972199821999220002200122002220032200422005220062200722008220092201022011220122201322014220152201622017220182201922020220212202222023220242202522026220272202822029220302203122032220332203422035220362203722038220392204022041220422204322044220452204622047220482204922050220512205222053220542205522056220572205822059220602206122062220632206422065220662206722068220692207022071220722207322074220752207622077220782207922080220812208222083220842208522086220872208822089220902209122092220932209422095220962209722098220992210022101221022210322104221052210622107221082210922110221112211222113221142211522116221172211822119221202212122122221232212422125221262212722128221292213022131221322213322134221352213622137221382213922140221412214222143221442214522146221472214822149221502215122152221532215422155221562215722158221592216022161221622216322164221652216622167221682216922170221712217222173221742217522176221772217822179221802218122182221832218422185221862218722188221892219022191221922219322194221952219622197221982219922200222012220222203222042220522206222072220822209222102221122212222132221422215222162221722218222192222022221222222222322224222252222622227222282222922230222312223222233222342223522236222372223822239222402224122242222432224422245222462224722248222492225022251222522225322254222552225622257222582225922260222612226222263222642226522266222672226822269222702227122272222732227422275222762227722278222792228022281222822228322284222852228622287222882228922290222912229222293222942229522296222972229822299223002230122302223032230422305223062230722308223092231022311223122231322314223152231622317223182231922320223212232222323223242232522326223272232822329223302233122332223332233422335223362233722338223392234022341223422234322344223452234622347223482234922350223512235222353223542235522356223572235822359223602236122362223632236422365223662236722368223692237022371223722237322374223752237622377223782237922380223812238222383223842238522386223872238822389223902239122392223932239422395223962239722398223992240022401224022240322404224052240622407224082240922410224112241222413224142241522416224172241822419224202242122422224232242422425224262242722428224292243022431224322243322434224352243622437224382243922440224412244222443224442244522446224472244822449224502245122452224532245422455224562245722458224592246022461224622246322464224652246622467224682246922470224712247222473224742247522476224772247822479224802248122482224832248422485224862248722488224892249022491224922249322494224952249622497224982249922500225012250222503225042250522506225072250822509225102251122512225132251422515225162251722518225192252022521225222252322524225252252622527225282252922530225312253222533225342253522536225372253822539225402254122542225432254422545225462254722548225492255022551225522255322554225552255622557225582255922560225612256222563225642256522566225672256822569225702257122572225732257422575225762257722578225792258022581225822258322584225852258622587225882258922590225912259222593225942259522596225972259822599226002260122602226032260422605226062260722608226092261022611226122261322614226152261622617226182261922620226212262222623226242262522626226272262822629226302263122632226332263422635226362263722638226392264022641226422264322644226452264622647226482264922650226512265222653226542265522656226572265822659226602266122662226632266422665226662266722668226692267022671226722267322674226752267622677226782267922680226812268222683226842268522686226872268822689226902269122692226932269422695226962269722698226992270022701227022270322704227052270622707227082270922710227112271222713227142271522716227172271822719227202272122722227232272422725227262272722728227292273022731227322273322734227352273622737227382273922740227412274222743227442274522746227472274822749227502275122752227532275422755227562275722758227592276022761227622276322764227652276622767227682276922770227712277222773227742277522776227772277822779227802278122782227832278422785227862278722788227892279022791227922279322794227952279622797227982279922800228012280222803228042280522806228072280822809228102281122812228132281422815228162281722818228192282022821228222282322824228252282622827228282282922830228312283222833228342283522836228372283822839228402284122842228432284422845228462284722848228492285022851228522285322854228552285622857228582285922860228612286222863228642286522866228672286822869228702287122872228732287422875228762287722878228792288022881228822288322884228852288622887228882288922890228912289222893228942289522896228972289822899229002290122902229032290422905229062290722908229092291022911229122291322914229152291622917229182291922920229212292222923229242292522926229272292822929229302293122932229332293422935229362293722938229392294022941229422294322944229452294622947229482294922950229512295222953229542295522956229572295822959229602296122962229632296422965229662296722968229692297022971229722297322974229752297622977229782297922980229812298222983229842298522986229872298822989229902299122992229932299422995229962299722998229992300023001230022300323004230052300623007230082300923010230112301223013230142301523016230172301823019230202302123022230232302423025230262302723028230292303023031230322303323034230352303623037230382303923040230412304223043230442304523046230472304823049230502305123052230532305423055230562305723058230592306023061230622306323064230652306623067230682306923070230712307223073230742307523076230772307823079230802308123082230832308423085230862308723088230892309023091230922309323094230952309623097230982309923100231012310223103231042310523106231072310823109231102311123112231132311423115231162311723118231192312023121231222312323124231252312623127231282312923130231312313223133231342313523136231372313823139231402314123142231432314423145231462314723148231492315023151231522315323154231552315623157231582315923160231612316223163231642316523166231672316823169231702317123172231732317423175231762317723178231792318023181231822318323184231852318623187231882318923190231912319223193231942319523196231972319823199232002320123202232032320423205232062320723208232092321023211232122321323214232152321623217232182321923220232212322223223232242322523226232272322823229232302323123232232332323423235232362323723238232392324023241232422324323244232452324623247232482324923250232512325223253232542325523256232572325823259232602326123262232632326423265232662326723268232692327023271232722327323274232752327623277232782327923280232812328223283232842328523286232872328823289232902329123292232932329423295232962329723298232992330023301233022330323304233052330623307233082330923310233112331223313233142331523316233172331823319233202332123322233232332423325233262332723328233292333023331233322333323334233352333623337233382333923340233412334223343233442334523346233472334823349233502335123352233532335423355233562335723358233592336023361233622336323364233652336623367233682336923370233712337223373233742337523376233772337823379233802338123382233832338423385233862338723388233892339023391233922339323394233952339623397233982339923400234012340223403234042340523406234072340823409234102341123412234132341423415234162341723418234192342023421234222342323424234252342623427234282342923430234312343223433234342343523436234372343823439234402344123442234432344423445234462344723448234492345023451234522345323454234552345623457234582345923460234612346223463234642346523466234672346823469234702347123472234732347423475234762347723478234792348023481234822348323484234852348623487234882348923490234912349223493234942349523496234972349823499235002350123502235032350423505235062350723508235092351023511235122351323514235152351623517235182351923520235212352223523235242352523526235272352823529235302353123532235332353423535235362353723538235392354023541235422354323544235452354623547235482354923550235512355223553235542355523556235572355823559235602356123562235632356423565235662356723568235692357023571235722357323574235752357623577235782357923580235812358223583235842358523586235872358823589235902359123592235932359423595235962359723598235992360023601236022360323604236052360623607236082360923610236112361223613236142361523616236172361823619236202362123622236232362423625236262362723628236292363023631236322363323634236352363623637236382363923640236412364223643236442364523646236472364823649236502365123652236532365423655236562365723658236592366023661236622366323664236652366623667236682366923670236712367223673236742367523676236772367823679236802368123682236832368423685236862368723688236892369023691236922369323694236952369623697236982369923700237012370223703237042370523706237072370823709237102371123712237132371423715237162371723718237192372023721237222372323724237252372623727237282372923730237312373223733237342373523736237372373823739237402374123742237432374423745237462374723748237492375023751237522375323754237552375623757237582375923760237612376223763237642376523766237672376823769237702377123772237732377423775237762377723778237792378023781237822378323784237852378623787237882378923790237912379223793237942379523796237972379823799238002380123802238032380423805238062380723808238092381023811238122381323814238152381623817238182381923820238212382223823238242382523826238272382823829238302383123832238332383423835238362383723838238392384023841238422384323844238452384623847238482384923850238512385223853238542385523856238572385823859238602386123862238632386423865238662386723868238692387023871238722387323874238752387623877238782387923880238812388223883238842388523886238872388823889238902389123892238932389423895238962389723898238992390023901239022390323904239052390623907239082390923910239112391223913239142391523916239172391823919239202392123922239232392423925239262392723928239292393023931239322393323934239352393623937239382393923940239412394223943239442394523946239472394823949239502395123952239532395423955239562395723958239592396023961239622396323964239652396623967239682396923970239712397223973239742397523976239772397823979239802398123982239832398423985239862398723988239892399023991239922399323994239952399623997239982399924000240012400224003240042400524006240072400824009240102401124012240132401424015240162401724018240192402024021240222402324024240252402624027240282402924030240312403224033240342403524036240372403824039240402404124042240432404424045240462404724048240492405024051240522405324054240552405624057240582405924060240612406224063240642406524066240672406824069240702407124072240732407424075240762407724078240792408024081240822408324084240852408624087240882408924090240912409224093240942409524096240972409824099241002410124102241032410424105241062410724108241092411024111241122411324114241152411624117241182411924120241212412224123241242412524126241272412824129241302413124132241332413424135241362413724138241392414024141241422414324144241452414624147241482414924150241512415224153241542415524156241572415824159241602416124162241632416424165241662416724168241692417024171241722417324174241752417624177241782417924180241812418224183241842418524186241872418824189241902419124192241932419424195241962419724198241992420024201242022420324204242052420624207242082420924210242112421224213242142421524216242172421824219242202422124222242232422424225242262422724228242292423024231242322423324234242352423624237242382423924240242412424224243242442424524246242472424824249242502425124252242532425424255242562425724258242592426024261242622426324264242652426624267242682426924270242712427224273242742427524276242772427824279242802428124282242832428424285242862428724288242892429024291242922429324294242952429624297242982429924300243012430224303243042430524306243072430824309243102431124312243132431424315243162431724318243192432024321243222432324324243252432624327243282432924330243312433224333243342433524336243372433824339243402434124342243432434424345243462434724348243492435024351243522435324354243552435624357243582435924360243612436224363243642436524366243672436824369243702437124372243732437424375243762437724378243792438024381243822438324384243852438624387243882438924390243912439224393243942439524396243972439824399244002440124402244032440424405244062440724408244092441024411244122441324414244152441624417244182441924420244212442224423244242442524426244272442824429244302443124432244332443424435244362443724438244392444024441244422444324444244452444624447244482444924450244512445224453244542445524456244572445824459244602446124462244632446424465244662446724468244692447024471244722447324474244752447624477244782447924480244812448224483244842448524486244872448824489244902449124492244932449424495244962449724498244992450024501245022450324504245052450624507245082450924510245112451224513245142451524516245172451824519245202452124522245232452424525245262452724528245292453024531245322453324534245352453624537245382453924540245412454224543245442454524546245472454824549245502455124552245532455424555245562455724558245592456024561245622456324564245652456624567245682456924570245712457224573245742457524576245772457824579245802458124582245832458424585245862458724588245892459024591245922459324594245952459624597245982459924600246012460224603246042460524606246072460824609246102461124612246132461424615246162461724618246192462024621246222462324624246252462624627246282462924630246312463224633246342463524636246372463824639246402464124642246432464424645246462464724648246492465024651246522465324654246552465624657246582465924660246612466224663246642466524666246672466824669246702467124672246732467424675246762467724678246792468024681246822468324684246852468624687246882468924690246912469224693246942469524696246972469824699247002470124702247032470424705247062470724708247092471024711247122471324714247152471624717247182471924720247212472224723247242472524726247272472824729247302473124732247332473424735247362473724738247392474024741247422474324744247452474624747247482474924750247512475224753247542475524756247572475824759247602476124762247632476424765247662476724768247692477024771247722477324774247752477624777247782477924780247812478224783247842478524786247872478824789247902479124792247932479424795247962479724798247992480024801248022480324804248052480624807248082480924810248112481224813248142481524816248172481824819248202482124822248232482424825248262482724828248292483024831248322483324834248352483624837248382483924840248412484224843248442484524846248472484824849248502485124852248532485424855248562485724858248592486024861248622486324864248652486624867248682486924870248712487224873248742487524876248772487824879248802488124882248832488424885248862488724888248892489024891248922489324894248952489624897248982489924900249012490224903249042490524906249072490824909249102491124912249132491424915249162491724918249192492024921249222492324924249252492624927249282492924930249312493224933249342493524936249372493824939249402494124942249432494424945249462494724948249492495024951249522495324954249552495624957249582495924960249612496224963249642496524966249672496824969249702497124972249732497424975249762497724978249792498024981249822498324984249852498624987249882498924990249912499224993249942499524996249972499824999250002500125002250032500425005250062500725008250092501025011250122501325014250152501625017250182501925020250212502225023250242502525026250272502825029250302503125032250332503425035250362503725038250392504025041250422504325044250452504625047250482504925050250512505225053250542505525056250572505825059250602506125062250632506425065250662506725068250692507025071250722507325074250752507625077250782507925080250812508225083250842508525086250872508825089250902509125092250932509425095250962509725098250992510025101251022510325104251052510625107251082510925110251112511225113251142511525116251172511825119251202512125122251232512425125251262512725128251292513025131251322513325134251352513625137251382513925140251412514225143251442514525146251472514825149251502515125152251532515425155251562515725158251592516025161251622516325164251652516625167251682516925170251712517225173251742517525176251772517825179251802518125182251832518425185251862518725188251892519025191251922519325194251952519625197251982519925200252012520225203252042520525206252072520825209252102521125212252132521425215252162521725218252192522025221252222522325224252252522625227252282522925230252312523225233252342523525236252372523825239252402524125242252432524425245252462524725248252492525025251252522525325254252552525625257252582525925260252612526225263252642526525266252672526825269252702527125272252732527425275252762527725278252792528025281252822528325284252852528625287252882528925290252912529225293252942529525296252972529825299253002530125302253032530425305253062530725308253092531025311253122531325314253152531625317253182531925320253212532225323253242532525326253272532825329253302533125332253332533425335253362533725338253392534025341253422534325344253452534625347253482534925350253512535225353253542535525356253572535825359253602536125362253632536425365253662536725368253692537025371253722537325374253752537625377253782537925380253812538225383253842538525386253872538825389253902539125392253932539425395253962539725398253992540025401254022540325404254052540625407254082540925410254112541225413254142541525416254172541825419254202542125422254232542425425254262542725428254292543025431254322543325434254352543625437254382543925440254412544225443254442544525446254472544825449254502545125452254532545425455254562545725458254592546025461254622546325464254652546625467254682546925470254712547225473254742547525476254772547825479254802548125482254832548425485254862548725488254892549025491254922549325494254952549625497254982549925500255012550225503255042550525506255072550825509255102551125512255132551425515255162551725518255192552025521255222552325524255252552625527255282552925530255312553225533255342553525536255372553825539255402554125542255432554425545255462554725548255492555025551255522555325554255552555625557255582555925560255612556225563255642556525566255672556825569255702557125572255732557425575255762557725578255792558025581255822558325584255852558625587255882558925590255912559225593255942559525596255972559825599256002560125602256032560425605256062560725608256092561025611256122561325614256152561625617256182561925620256212562225623256242562525626256272562825629256302563125632256332563425635256362563725638256392564025641256422564325644256452564625647256482564925650256512565225653256542565525656256572565825659256602566125662256632566425665256662566725668256692567025671256722567325674256752567625677256782567925680256812568225683256842568525686256872568825689256902569125692256932569425695256962569725698256992570025701257022570325704257052570625707257082570925710257112571225713257142571525716257172571825719257202572125722257232572425725257262572725728257292573025731257322573325734257352573625737257382573925740257412574225743257442574525746257472574825749257502575125752257532575425755257562575725758257592576025761257622576325764257652576625767257682576925770257712577225773257742577525776257772577825779257802578125782257832578425785257862578725788257892579025791257922579325794257952579625797257982579925800258012580225803258042580525806258072580825809258102581125812258132581425815258162581725818258192582025821258222582325824258252582625827258282582925830258312583225833258342583525836258372583825839258402584125842258432584425845258462584725848258492585025851258522585325854258552585625857258582585925860258612586225863258642586525866258672586825869258702587125872258732587425875258762587725878258792588025881258822588325884258852588625887258882588925890258912589225893258942589525896258972589825899259002590125902259032590425905259062590725908259092591025911259122591325914259152591625917259182591925920259212592225923259242592525926259272592825929259302593125932259332593425935259362593725938259392594025941259422594325944259452594625947259482594925950259512595225953259542595525956259572595825959259602596125962259632596425965259662596725968259692597025971259722597325974259752597625977259782597925980259812598225983259842598525986259872598825989259902599125992259932599425995259962599725998259992600026001260022600326004260052600626007260082600926010260112601226013260142601526016260172601826019260202602126022260232602426025260262602726028260292603026031260322603326034260352603626037260382603926040260412604226043260442604526046260472604826049260502605126052260532605426055260562605726058260592606026061260622606326064260652606626067260682606926070260712607226073260742607526076260772607826079260802608126082260832608426085260862608726088260892609026091260922609326094260952609626097260982609926100261012610226103261042610526106261072610826109261102611126112261132611426115261162611726118261192612026121261222612326124261252612626127261282612926130261312613226133261342613526136261372613826139261402614126142261432614426145261462614726148261492615026151261522615326154261552615626157261582615926160261612616226163261642616526166261672616826169261702617126172261732617426175261762617726178261792618026181261822618326184261852618626187261882618926190261912619226193261942619526196261972619826199262002620126202262032620426205262062620726208262092621026211262122621326214262152621626217262182621926220262212622226223262242622526226262272622826229262302623126232262332623426235262362623726238262392624026241262422624326244262452624626247262482624926250262512625226253262542625526256262572625826259262602626126262262632626426265262662626726268262692627026271262722627326274262752627626277262782627926280262812628226283262842628526286262872628826289262902629126292262932629426295262962629726298262992630026301263022630326304263052630626307263082630926310263112631226313263142631526316263172631826319263202632126322263232632426325263262632726328263292633026331263322633326334263352633626337263382633926340263412634226343263442634526346263472634826349263502635126352263532635426355263562635726358263592636026361263622636326364263652636626367263682636926370263712637226373263742637526376263772637826379263802638126382263832638426385263862638726388263892639026391263922639326394263952639626397263982639926400264012640226403264042640526406264072640826409264102641126412264132641426415264162641726418264192642026421264222642326424264252642626427264282642926430264312643226433264342643526436264372643826439264402644126442264432644426445264462644726448264492645026451264522645326454264552645626457264582645926460264612646226463264642646526466264672646826469264702647126472264732647426475264762647726478264792648026481264822648326484264852648626487264882648926490264912649226493264942649526496264972649826499265002650126502265032650426505265062650726508265092651026511265122651326514265152651626517265182651926520265212652226523265242652526526265272652826529265302653126532265332653426535265362653726538265392654026541265422654326544265452654626547265482654926550265512655226553265542655526556265572655826559265602656126562265632656426565265662656726568265692657026571265722657326574265752657626577265782657926580265812658226583265842658526586265872658826589265902659126592265932659426595265962659726598265992660026601266022660326604266052660626607266082660926610266112661226613266142661526616266172661826619266202662126622266232662426625266262662726628266292663026631266322663326634266352663626637266382663926640266412664226643266442664526646266472664826649266502665126652266532665426655266562665726658266592666026661266622666326664266652666626667266682666926670266712667226673266742667526676266772667826679266802668126682266832668426685266862668726688266892669026691266922669326694266952669626697266982669926700267012670226703267042670526706267072670826709267102671126712267132671426715267162671726718267192672026721267222672326724267252672626727267282672926730267312673226733267342673526736267372673826739267402674126742267432674426745267462674726748267492675026751267522675326754267552675626757267582675926760267612676226763267642676526766267672676826769267702677126772267732677426775267762677726778267792678026781267822678326784267852678626787267882678926790267912679226793267942679526796267972679826799268002680126802268032680426805268062680726808268092681026811268122681326814268152681626817268182681926820268212682226823268242682526826268272682826829268302683126832268332683426835268362683726838268392684026841268422684326844268452684626847268482684926850268512685226853268542685526856268572685826859268602686126862268632686426865268662686726868268692687026871268722687326874268752687626877268782687926880268812688226883268842688526886268872688826889268902689126892268932689426895268962689726898268992690026901269022690326904269052690626907269082690926910269112691226913269142691526916269172691826919269202692126922269232692426925269262692726928269292693026931269322693326934269352693626937269382693926940269412694226943269442694526946269472694826949269502695126952269532695426955269562695726958269592696026961269622696326964269652696626967269682696926970269712697226973269742697526976269772697826979269802698126982269832698426985269862698726988269892699026991269922699326994269952699626997269982699927000270012700227003270042700527006270072700827009270102701127012270132701427015270162701727018270192702027021270222702327024270252702627027270282702927030270312703227033270342703527036270372703827039270402704127042270432704427045270462704727048270492705027051270522705327054270552705627057270582705927060270612706227063270642706527066270672706827069270702707127072270732707427075270762707727078270792708027081270822708327084270852708627087270882708927090270912709227093270942709527096270972709827099271002710127102271032710427105271062710727108271092711027111271122711327114271152711627117271182711927120271212712227123271242712527126271272712827129271302713127132271332713427135271362713727138271392714027141271422714327144271452714627147271482714927150271512715227153271542715527156271572715827159271602716127162271632716427165271662716727168271692717027171271722717327174271752717627177271782717927180271812718227183271842718527186271872718827189271902719127192271932719427195271962719727198271992720027201272022720327204272052720627207272082720927210272112721227213272142721527216272172721827219272202722127222272232722427225272262722727228272292723027231272322723327234272352723627237272382723927240272412724227243272442724527246272472724827249272502725127252272532725427255272562725727258272592726027261272622726327264272652726627267272682726927270272712727227273272742727527276272772727827279272802728127282272832728427285272862728727288272892729027291272922729327294272952729627297272982729927300273012730227303273042730527306273072730827309273102731127312273132731427315273162731727318273192732027321273222732327324273252732627327273282732927330273312733227333273342733527336273372733827339273402734127342273432734427345273462734727348273492735027351273522735327354273552735627357273582735927360273612736227363273642736527366273672736827369273702737127372273732737427375273762737727378273792738027381273822738327384273852738627387273882738927390273912739227393273942739527396273972739827399274002740127402274032740427405274062740727408274092741027411274122741327414274152741627417274182741927420274212742227423274242742527426274272742827429274302743127432274332743427435274362743727438274392744027441274422744327444274452744627447274482744927450274512745227453274542745527456274572745827459274602746127462274632746427465274662746727468274692747027471274722747327474274752747627477274782747927480274812748227483274842748527486274872748827489274902749127492274932749427495274962749727498274992750027501275022750327504275052750627507275082750927510275112751227513275142751527516275172751827519275202752127522275232752427525275262752727528275292753027531275322753327534275352753627537275382753927540275412754227543275442754527546275472754827549275502755127552275532755427555275562755727558275592756027561275622756327564275652756627567275682756927570275712757227573275742757527576275772757827579275802758127582275832758427585275862758727588275892759027591275922759327594275952759627597275982759927600276012760227603276042760527606276072760827609276102761127612276132761427615276162761727618276192762027621276222762327624276252762627627276282762927630276312763227633276342763527636276372763827639276402764127642276432764427645276462764727648276492765027651276522765327654276552765627657276582765927660276612766227663276642766527666276672766827669276702767127672276732767427675276762767727678276792768027681276822768327684276852768627687276882768927690276912769227693276942769527696276972769827699277002770127702277032770427705277062770727708277092771027711277122771327714277152771627717277182771927720277212772227723277242772527726277272772827729277302773127732277332773427735277362773727738277392774027741277422774327744277452774627747277482774927750277512775227753277542775527756277572775827759277602776127762277632776427765277662776727768277692777027771277722777327774277752777627777277782777927780277812778227783277842778527786277872778827789277902779127792277932779427795277962779727798277992780027801278022780327804278052780627807278082780927810278112781227813278142781527816278172781827819278202782127822278232782427825278262782727828278292783027831278322783327834278352783627837278382783927840278412784227843278442784527846278472784827849278502785127852278532785427855278562785727858278592786027861278622786327864278652786627867278682786927870278712787227873278742787527876278772787827879278802788127882278832788427885278862788727888278892789027891278922789327894278952789627897278982789927900279012790227903279042790527906279072790827909279102791127912279132791427915279162791727918279192792027921279222792327924279252792627927279282792927930279312793227933279342793527936279372793827939279402794127942279432794427945279462794727948279492795027951279522795327954279552795627957279582795927960279612796227963279642796527966279672796827969279702797127972279732797427975279762797727978279792798027981279822798327984279852798627987279882798927990279912799227993279942799527996279972799827999280002800128002280032800428005280062800728008280092801028011280122801328014280152801628017280182801928020280212802228023280242802528026280272802828029280302803128032280332803428035280362803728038280392804028041280422804328044280452804628047280482804928050280512805228053280542805528056280572805828059280602806128062280632806428065280662806728068280692807028071280722807328074280752807628077280782807928080280812808228083280842808528086280872808828089280902809128092280932809428095280962809728098280992810028101281022810328104281052810628107281082810928110281112811228113281142811528116281172811828119281202812128122281232812428125281262812728128281292813028131281322813328134281352813628137281382813928140281412814228143281442814528146281472814828149281502815128152281532815428155281562815728158281592816028161281622816328164281652816628167281682816928170281712817228173281742817528176281772817828179281802818128182281832818428185281862818728188281892819028191281922819328194281952819628197281982819928200282012820228203282042820528206282072820828209282102821128212282132821428215282162821728218282192822028221282222822328224282252822628227282282822928230282312823228233282342823528236282372823828239282402824128242282432824428245282462824728248282492825028251282522825328254282552825628257282582825928260282612826228263282642826528266282672826828269282702827128272282732827428275282762827728278282792828028281282822828328284282852828628287282882828928290282912829228293282942829528296282972829828299283002830128302283032830428305283062830728308283092831028311283122831328314283152831628317283182831928320283212832228323283242832528326283272832828329283302833128332283332833428335283362833728338283392834028341283422834328344283452834628347283482834928350283512835228353283542835528356283572835828359283602836128362283632836428365283662836728368283692837028371283722837328374283752837628377283782837928380283812838228383283842838528386283872838828389283902839128392283932839428395283962839728398283992840028401284022840328404284052840628407284082840928410284112841228413284142841528416284172841828419284202842128422284232842428425284262842728428284292843028431284322843328434284352843628437284382843928440284412844228443284442844528446284472844828449284502845128452284532845428455284562845728458284592846028461284622846328464284652846628467284682846928470284712847228473284742847528476284772847828479284802848128482284832848428485284862848728488284892849028491284922849328494284952849628497284982849928500285012850228503285042850528506285072850828509285102851128512285132851428515285162851728518285192852028521285222852328524285252852628527285282852928530285312853228533285342853528536285372853828539285402854128542285432854428545285462854728548285492855028551285522855328554285552855628557285582855928560285612856228563285642856528566285672856828569285702857128572285732857428575285762857728578285792858028581285822858328584285852858628587285882858928590285912859228593285942859528596285972859828599286002860128602286032860428605286062860728608286092861028611286122861328614286152861628617286182861928620286212862228623286242862528626286272862828629286302863128632286332863428635286362863728638286392864028641286422864328644286452864628647286482864928650286512865228653286542865528656286572865828659286602866128662286632866428665286662866728668286692867028671286722867328674286752867628677286782867928680286812868228683286842868528686286872868828689286902869128692286932869428695286962869728698286992870028701287022870328704287052870628707287082870928710287112871228713287142871528716287172871828719287202872128722287232872428725287262872728728287292873028731287322873328734287352873628737287382873928740287412874228743287442874528746287472874828749287502875128752287532875428755287562875728758287592876028761287622876328764287652876628767287682876928770287712877228773287742877528776287772877828779287802878128782287832878428785287862878728788287892879028791287922879328794287952879628797287982879928800288012880228803288042880528806288072880828809288102881128812288132881428815288162881728818288192882028821288222882328824288252882628827288282882928830288312883228833288342883528836288372883828839288402884128842288432884428845288462884728848288492885028851288522885328854288552885628857288582885928860288612886228863288642886528866288672886828869288702887128872288732887428875288762887728878288792888028881288822888328884288852888628887288882888928890288912889228893288942889528896288972889828899289002890128902289032890428905289062890728908289092891028911289122891328914289152891628917289182891928920289212892228923289242892528926289272892828929289302893128932289332893428935289362893728938289392894028941289422894328944289452894628947289482894928950289512895228953289542895528956289572895828959289602896128962289632896428965289662896728968289692897028971289722897328974289752897628977289782897928980289812898228983289842898528986289872898828989289902899128992289932899428995289962899728998289992900029001290022900329004290052900629007290082900929010290112901229013290142901529016290172901829019290202902129022290232902429025290262902729028290292903029031290322903329034290352903629037290382903929040290412904229043290442904529046290472904829049290502905129052290532905429055290562905729058290592906029061290622906329064290652906629067290682906929070290712907229073290742907529076290772907829079290802908129082290832908429085290862908729088290892909029091290922909329094290952909629097290982909929100291012910229103291042910529106291072910829109291102911129112291132911429115291162911729118291192912029121291222912329124291252912629127291282912929130291312913229133291342913529136291372913829139291402914129142291432914429145291462914729148291492915029151291522915329154291552915629157291582915929160291612916229163291642916529166291672916829169291702917129172291732917429175291762917729178291792918029181291822918329184291852918629187291882918929190291912919229193291942919529196291972919829199292002920129202292032920429205292062920729208292092921029211292122921329214292152921629217292182921929220292212922229223292242922529226292272922829229292302923129232292332923429235292362923729238292392924029241292422924329244292452924629247292482924929250292512925229253292542925529256292572925829259292602926129262292632926429265292662926729268292692927029271292722927329274292752927629277292782927929280292812928229283292842928529286292872928829289292902929129292292932929429295292962929729298292992930029301293022930329304293052930629307293082930929310293112931229313293142931529316293172931829319293202932129322293232932429325293262932729328293292933029331293322933329334293352933629337293382933929340293412934229343293442934529346293472934829349293502935129352293532935429355293562935729358293592936029361293622936329364293652936629367293682936929370293712937229373293742937529376293772937829379293802938129382293832938429385293862938729388293892939029391293922939329394293952939629397293982939929400294012940229403294042940529406294072940829409294102941129412294132941429415294162941729418294192942029421294222942329424294252942629427294282942929430294312943229433294342943529436294372943829439294402944129442294432944429445294462944729448294492945029451294522945329454294552945629457294582945929460294612946229463294642946529466294672946829469294702947129472294732947429475294762947729478294792948029481294822948329484294852948629487294882948929490294912949229493294942949529496294972949829499295002950129502295032950429505295062950729508295092951029511295122951329514295152951629517295182951929520295212952229523295242952529526295272952829529295302953129532295332953429535295362953729538295392954029541295422954329544295452954629547295482954929550295512955229553295542955529556295572955829559295602956129562295632956429565295662956729568295692957029571295722957329574295752957629577295782957929580295812958229583295842958529586295872958829589295902959129592295932959429595295962959729598295992960029601296022960329604296052960629607296082960929610296112961229613296142961529616296172961829619296202962129622296232962429625296262962729628296292963029631296322963329634296352963629637296382963929640296412964229643296442964529646296472964829649296502965129652296532965429655296562965729658296592966029661296622966329664296652966629667296682966929670296712967229673296742967529676296772967829679296802968129682296832968429685296862968729688296892969029691296922969329694296952969629697296982969929700297012970229703297042970529706297072970829709297102971129712297132971429715297162971729718297192972029721297222972329724297252972629727297282972929730297312973229733297342973529736297372973829739297402974129742297432974429745297462974729748297492975029751297522975329754297552975629757297582975929760297612976229763297642976529766297672976829769297702977129772297732977429775297762977729778297792978029781297822978329784297852978629787297882978929790297912979229793297942979529796297972979829799298002980129802298032980429805298062980729808298092981029811298122981329814298152981629817298182981929820298212982229823298242982529826298272982829829298302983129832298332983429835298362983729838298392984029841298422984329844298452984629847298482984929850298512985229853298542985529856298572985829859298602986129862298632986429865298662986729868298692987029871298722987329874298752987629877298782987929880298812988229883298842988529886298872988829889298902989129892298932989429895298962989729898298992990029901299022990329904299052990629907299082990929910299112991229913299142991529916299172991829919299202992129922299232992429925299262992729928299292993029931299322993329934299352993629937299382993929940299412994229943299442994529946299472994829949299502995129952299532995429955299562995729958299592996029961299622996329964299652996629967299682996929970299712997229973299742997529976299772997829979299802998129982299832998429985299862998729988299892999029991299922999329994299952999629997299982999930000300013000230003300043000530006300073000830009300103001130012300133001430015300163001730018300193002030021300223002330024300253002630027300283002930030300313003230033300343003530036300373003830039300403004130042300433004430045300463004730048300493005030051300523005330054300553005630057300583005930060300613006230063300643006530066300673006830069300703007130072300733007430075300763007730078300793008030081300823008330084300853008630087300883008930090300913009230093300943009530096300973009830099301003010130102301033010430105301063010730108301093011030111301123011330114301153011630117301183011930120301213012230123301243012530126301273012830129301303013130132301333013430135301363013730138301393014030141301423014330144301453014630147301483014930150301513015230153301543015530156301573015830159301603016130162301633016430165301663016730168301693017030171301723017330174301753017630177301783017930180301813018230183301843018530186301873018830189301903019130192301933019430195301963019730198301993020030201302023020330204302053020630207302083020930210302113021230213302143021530216302173021830219302203022130222302233022430225302263022730228302293023030231302323023330234302353023630237302383023930240302413024230243302443024530246302473024830249302503025130252302533025430255302563025730258302593026030261302623026330264302653026630267302683026930270302713027230273302743027530276302773027830279302803028130282302833028430285302863028730288302893029030291302923029330294302953029630297302983029930300303013030230303303043030530306303073030830309303103031130312303133031430315303163031730318303193032030321303223032330324303253032630327303283032930330303313033230333303343033530336303373033830339303403034130342303433034430345303463034730348303493035030351303523035330354303553035630357303583035930360303613036230363303643036530366303673036830369303703037130372303733037430375303763037730378303793038030381303823038330384303853038630387303883038930390303913039230393303943039530396303973039830399304003040130402304033040430405304063040730408304093041030411304123041330414304153041630417304183041930420304213042230423304243042530426304273042830429304303043130432304333043430435304363043730438304393044030441304423044330444304453044630447304483044930450304513045230453304543045530456304573045830459304603046130462304633046430465304663046730468304693047030471304723047330474304753047630477304783047930480304813048230483304843048530486304873048830489304903049130492304933049430495304963049730498304993050030501305023050330504305053050630507305083050930510305113051230513305143051530516305173051830519305203052130522305233052430525305263052730528305293053030531305323053330534305353053630537305383053930540305413054230543305443054530546305473054830549305503055130552305533055430555305563055730558305593056030561305623056330564305653056630567305683056930570305713057230573305743057530576305773057830579305803058130582305833058430585305863058730588305893059030591305923059330594305953059630597305983059930600306013060230603306043060530606306073060830609306103061130612306133061430615306163061730618306193062030621306223062330624306253062630627306283062930630306313063230633306343063530636306373063830639306403064130642306433064430645306463064730648306493065030651306523065330654306553065630657306583065930660306613066230663306643066530666306673066830669306703067130672306733067430675306763067730678306793068030681306823068330684306853068630687306883068930690306913069230693306943069530696306973069830699307003070130702307033070430705307063070730708307093071030711307123071330714307153071630717307183071930720307213072230723307243072530726307273072830729307303073130732307333073430735307363073730738307393074030741307423074330744307453074630747307483074930750307513075230753307543075530756307573075830759307603076130762307633076430765307663076730768307693077030771307723077330774307753077630777307783077930780307813078230783307843078530786307873078830789307903079130792307933079430795307963079730798307993080030801308023080330804308053080630807308083080930810308113081230813308143081530816308173081830819308203082130822308233082430825308263082730828308293083030831308323083330834308353083630837308383083930840308413084230843308443084530846308473084830849308503085130852308533085430855308563085730858308593086030861308623086330864308653086630867308683086930870308713087230873308743087530876308773087830879308803088130882308833088430885308863088730888308893089030891308923089330894308953089630897308983089930900309013090230903309043090530906309073090830909309103091130912309133091430915309163091730918309193092030921309223092330924309253092630927309283092930930309313093230933309343093530936309373093830939309403094130942309433094430945309463094730948309493095030951309523095330954309553095630957309583095930960309613096230963309643096530966309673096830969309703097130972309733097430975309763097730978309793098030981309823098330984309853098630987309883098930990309913099230993309943099530996309973099830999310003100131002310033100431005310063100731008310093101031011310123101331014310153101631017310183101931020310213102231023310243102531026310273102831029310303103131032310333103431035310363103731038310393104031041310423104331044310453104631047310483104931050310513105231053310543105531056310573105831059310603106131062310633106431065310663106731068310693107031071310723107331074310753107631077310783107931080310813108231083310843108531086310873108831089310903109131092310933109431095310963109731098310993110031101311023110331104311053110631107311083110931110311113111231113311143111531116311173111831119311203112131122311233112431125311263112731128311293113031131311323113331134311353113631137311383113931140311413114231143311443114531146311473114831149311503115131152311533115431155311563115731158311593116031161311623116331164311653116631167311683116931170311713117231173311743117531176311773117831179311803118131182311833118431185311863118731188311893119031191311923119331194311953119631197311983119931200312013120231203312043120531206312073120831209312103121131212312133121431215312163121731218312193122031221312223122331224312253122631227312283122931230312313123231233312343123531236312373123831239312403124131242312433124431245312463124731248312493125031251312523125331254312553125631257312583125931260312613126231263312643126531266312673126831269312703127131272312733127431275312763127731278312793128031281312823128331284312853128631287312883128931290312913129231293312943129531296312973129831299313003130131302313033130431305313063130731308313093131031311313123131331314313153131631317313183131931320313213132231323313243132531326313273132831329313303133131332313333133431335313363133731338313393134031341313423134331344313453134631347313483134931350313513135231353313543135531356313573135831359313603136131362313633136431365313663136731368313693137031371313723137331374313753137631377313783137931380313813138231383313843138531386313873138831389313903139131392313933139431395313963139731398313993140031401314023140331404314053140631407314083140931410314113141231413314143141531416314173141831419314203142131422314233142431425314263142731428314293143031431314323143331434314353143631437314383143931440314413144231443314443144531446314473144831449314503145131452314533145431455314563145731458314593146031461314623146331464314653146631467314683146931470314713147231473314743147531476314773147831479314803148131482314833148431485314863148731488314893149031491314923149331494314953149631497314983149931500315013150231503315043150531506315073150831509315103151131512315133151431515315163151731518315193152031521315223152331524315253152631527315283152931530315313153231533315343153531536315373153831539315403154131542315433154431545315463154731548315493155031551315523155331554315553155631557315583155931560315613156231563315643156531566315673156831569315703157131572315733157431575315763157731578315793158031581315823158331584315853158631587315883158931590315913159231593315943159531596315973159831599316003160131602316033160431605316063160731608316093161031611316123161331614316153161631617316183161931620316213162231623316243162531626316273162831629316303163131632316333163431635316363163731638316393164031641316423164331644316453164631647316483164931650316513165231653316543165531656316573165831659316603166131662316633166431665316663166731668316693167031671316723167331674316753167631677316783167931680316813168231683316843168531686316873168831689316903169131692316933169431695316963169731698316993170031701317023170331704317053170631707317083170931710317113171231713317143171531716317173171831719317203172131722317233172431725317263172731728317293173031731317323173331734317353173631737317383173931740317413174231743317443174531746317473174831749317503175131752317533175431755317563175731758317593176031761317623176331764317653176631767317683176931770317713177231773317743177531776317773177831779317803178131782317833178431785317863178731788317893179031791317923179331794317953179631797317983179931800318013180231803318043180531806318073180831809318103181131812318133181431815318163181731818318193182031821318223182331824318253182631827318283182931830318313183231833318343183531836318373183831839318403184131842318433184431845318463184731848318493185031851318523185331854318553185631857318583185931860318613186231863318643186531866318673186831869318703187131872318733187431875318763187731878318793188031881318823188331884318853188631887318883188931890318913189231893318943189531896318973189831899319003190131902319033190431905319063190731908319093191031911319123191331914319153191631917319183191931920319213192231923319243192531926319273192831929319303193131932319333193431935319363193731938319393194031941319423194331944319453194631947319483194931950319513195231953319543195531956319573195831959319603196131962319633196431965319663196731968319693197031971319723197331974319753197631977319783197931980319813198231983319843198531986319873198831989319903199131992319933199431995319963199731998319993200032001320023200332004320053200632007320083200932010320113201232013320143201532016320173201832019320203202132022320233202432025320263202732028320293203032031320323203332034320353203632037320383203932040320413204232043320443204532046320473204832049320503205132052320533205432055320563205732058320593206032061320623206332064320653206632067320683206932070320713207232073320743207532076320773207832079320803208132082320833208432085320863208732088320893209032091320923209332094320953209632097320983209932100321013210232103321043210532106321073210832109321103211132112321133211432115321163211732118321193212032121321223212332124321253212632127321283212932130321313213232133321343213532136321373213832139321403214132142321433214432145321463214732148321493215032151321523215332154321553215632157321583215932160321613216232163321643216532166321673216832169321703217132172321733217432175321763217732178321793218032181321823218332184321853218632187321883218932190321913219232193321943219532196321973219832199322003220132202322033220432205322063220732208322093221032211322123221332214322153221632217322183221932220322213222232223322243222532226322273222832229322303223132232322333223432235322363223732238322393224032241322423224332244322453224632247322483224932250322513225232253322543225532256322573225832259322603226132262322633226432265322663226732268322693227032271322723227332274322753227632277322783227932280322813228232283322843228532286322873228832289322903229132292322933229432295322963229732298322993230032301323023230332304323053230632307323083230932310323113231232313323143231532316323173231832319323203232132322323233232432325323263232732328323293233032331323323233332334323353233632337323383233932340323413234232343323443234532346323473234832349323503235132352323533235432355323563235732358323593236032361323623236332364323653236632367323683236932370323713237232373323743237532376323773237832379323803238132382323833238432385323863238732388323893239032391323923239332394323953239632397323983239932400324013240232403324043240532406324073240832409324103241132412324133241432415324163241732418324193242032421324223242332424324253242632427324283242932430324313243232433324343243532436324373243832439324403244132442324433244432445324463244732448324493245032451324523245332454324553245632457324583245932460324613246232463324643246532466324673246832469324703247132472324733247432475324763247732478324793248032481324823248332484324853248632487324883248932490324913249232493324943249532496324973249832499325003250132502325033250432505325063250732508325093251032511325123251332514325153251632517325183251932520325213252232523325243252532526325273252832529325303253132532325333253432535325363253732538325393254032541325423254332544325453254632547325483254932550325513255232553325543255532556325573255832559325603256132562325633256432565325663256732568325693257032571325723257332574325753257632577325783257932580325813258232583325843258532586325873258832589325903259132592325933259432595325963259732598325993260032601326023260332604326053260632607326083260932610326113261232613326143261532616326173261832619326203262132622326233262432625326263262732628326293263032631326323263332634326353263632637326383263932640326413264232643326443264532646326473264832649326503265132652326533265432655326563265732658326593266032661326623266332664326653266632667326683266932670326713267232673326743267532676326773267832679326803268132682326833268432685326863268732688326893269032691326923269332694326953269632697326983269932700327013270232703327043270532706327073270832709327103271132712327133271432715327163271732718327193272032721327223272332724327253272632727327283272932730327313273232733327343273532736327373273832739327403274132742327433274432745327463274732748327493275032751327523275332754327553275632757327583275932760327613276232763327643276532766327673276832769327703277132772327733277432775327763277732778327793278032781327823278332784327853278632787327883278932790327913279232793327943279532796327973279832799328003280132802328033280432805328063280732808328093281032811328123281332814328153281632817328183281932820328213282232823328243282532826328273282832829328303283132832328333283432835328363283732838328393284032841328423284332844328453284632847328483284932850328513285232853328543285532856328573285832859328603286132862328633286432865328663286732868328693287032871328723287332874328753287632877328783287932880328813288232883328843288532886328873288832889328903289132892328933289432895328963289732898328993290032901329023290332904329053290632907329083290932910329113291232913329143291532916329173291832919329203292132922329233292432925329263292732928329293293032931329323293332934329353293632937329383293932940329413294232943329443294532946329473294832949329503295132952329533295432955329563295732958329593296032961329623296332964329653296632967329683296932970329713297232973329743297532976329773297832979329803298132982329833298432985329863298732988329893299032991329923299332994329953299632997329983299933000330013300233003330043300533006330073300833009330103301133012330133301433015330163301733018330193302033021330223302333024330253302633027330283302933030330313303233033330343303533036330373303833039330403304133042330433304433045330463304733048330493305033051330523305333054330553305633057330583305933060330613306233063330643306533066330673306833069330703307133072330733307433075330763307733078330793308033081330823308333084330853308633087330883308933090330913309233093330943309533096330973309833099331003310133102331033310433105331063310733108331093311033111331123311333114331153311633117331183311933120331213312233123331243312533126331273312833129331303313133132331333313433135331363313733138331393314033141331423314333144331453314633147331483314933150331513315233153331543315533156331573315833159331603316133162331633316433165331663316733168331693317033171331723317333174331753317633177331783317933180331813318233183331843318533186331873318833189331903319133192331933319433195331963319733198331993320033201332023320333204332053320633207332083320933210332113321233213332143321533216332173321833219332203322133222332233322433225332263322733228332293323033231332323323333234332353323633237332383323933240332413324233243332443324533246332473324833249332503325133252332533325433255332563325733258332593326033261332623326333264332653326633267332683326933270332713327233273332743327533276332773327833279332803328133282332833328433285332863328733288332893329033291332923329333294332953329633297332983329933300333013330233303333043330533306333073330833309333103331133312333133331433315333163331733318333193332033321333223332333324333253332633327333283332933330333313333233333333343333533336333373333833339333403334133342333433334433345333463334733348333493335033351333523335333354333553335633357333583335933360333613336233363333643336533366333673336833369333703337133372333733337433375333763337733378333793338033381333823338333384333853338633387333883338933390333913339233393333943339533396333973339833399334003340133402334033340433405334063340733408334093341033411334123341333414334153341633417334183341933420334213342233423334243342533426334273342833429334303343133432334333343433435334363343733438334393344033441334423344333444334453344633447334483344933450334513345233453334543345533456334573345833459334603346133462334633346433465334663346733468334693347033471334723347333474334753347633477334783347933480334813348233483334843348533486334873348833489334903349133492334933349433495334963349733498334993350033501335023350333504335053350633507335083350933510335113351233513335143351533516335173351833519335203352133522335233352433525335263352733528335293353033531335323353333534335353353633537335383353933540335413354233543335443354533546335473354833549335503355133552335533355433555335563355733558335593356033561335623356333564335653356633567335683356933570335713357233573335743357533576335773357833579335803358133582335833358433585335863358733588335893359033591335923359333594335953359633597335983359933600336013360233603336043360533606336073360833609336103361133612336133361433615336163361733618336193362033621336223362333624336253362633627336283362933630336313363233633336343363533636336373363833639336403364133642336433364433645336463364733648336493365033651336523365333654336553365633657336583365933660336613366233663336643366533666336673366833669336703367133672336733367433675336763367733678336793368033681336823368333684336853368633687336883368933690336913369233693336943369533696336973369833699337003370133702337033370433705337063370733708337093371033711337123371333714337153371633717337183371933720337213372233723337243372533726337273372833729337303373133732337333373433735337363373733738337393374033741337423374333744337453374633747337483374933750337513375233753337543375533756337573375833759337603376133762337633376433765337663376733768337693377033771337723377333774337753377633777337783377933780337813378233783337843378533786337873378833789337903379133792337933379433795337963379733798337993380033801338023380333804338053380633807338083380933810338113381233813338143381533816338173381833819338203382133822338233382433825338263382733828338293383033831338323383333834338353383633837338383383933840338413384233843338443384533846338473384833849338503385133852338533385433855338563385733858338593386033861338623386333864338653386633867338683386933870338713387233873338743387533876338773387833879338803388133882338833388433885338863388733888338893389033891338923389333894338953389633897338983389933900339013390233903339043390533906339073390833909339103391133912339133391433915339163391733918339193392033921339223392333924339253392633927339283392933930339313393233933339343393533936339373393833939339403394133942339433394433945339463394733948339493395033951339523395333954339553395633957339583395933960339613396233963339643396533966339673396833969339703397133972339733397433975339763397733978339793398033981339823398333984339853398633987339883398933990339913399233993339943399533996339973399833999340003400134002340033400434005340063400734008340093401034011340123401334014340153401634017340183401934020340213402234023340243402534026340273402834029340303403134032340333403434035340363403734038340393404034041340423404334044340453404634047340483404934050340513405234053340543405534056340573405834059340603406134062340633406434065340663406734068340693407034071340723407334074340753407634077340783407934080340813408234083340843408534086340873408834089340903409134092340933409434095340963409734098340993410034101341023410334104341053410634107341083410934110341113411234113341143411534116341173411834119341203412134122341233412434125341263412734128341293413034131341323413334134341353413634137341383413934140341413414234143341443414534146341473414834149341503415134152341533415434155341563415734158341593416034161341623416334164341653416634167341683416934170341713417234173341743417534176341773417834179341803418134182341833418434185341863418734188341893419034191341923419334194341953419634197341983419934200342013420234203342043420534206342073420834209342103421134212342133421434215342163421734218342193422034221342223422334224342253422634227342283422934230342313423234233342343423534236342373423834239342403424134242342433424434245342463424734248342493425034251342523425334254342553425634257342583425934260342613426234263342643426534266342673426834269342703427134272342733427434275342763427734278342793428034281342823428334284342853428634287342883428934290342913429234293342943429534296342973429834299343003430134302343033430434305343063430734308343093431034311343123431334314343153431634317343183431934320343213432234323343243432534326343273432834329343303433134332343333433434335343363433734338343393434034341343423434334344343453434634347343483434934350343513435234353343543435534356343573435834359343603436134362343633436434365343663436734368343693437034371343723437334374343753437634377343783437934380343813438234383343843438534386343873438834389343903439134392343933439434395343963439734398343993440034401344023440334404344053440634407344083440934410344113441234413344143441534416344173441834419344203442134422344233442434425344263442734428344293443034431344323443334434344353443634437344383443934440344413444234443344443444534446344473444834449344503445134452344533445434455344563445734458344593446034461344623446334464344653446634467344683446934470344713447234473344743447534476344773447834479344803448134482344833448434485344863448734488344893449034491344923449334494344953449634497344983449934500345013450234503345043450534506345073450834509345103451134512345133451434515345163451734518345193452034521345223452334524345253452634527345283452934530345313453234533345343453534536345373453834539345403454134542345433454434545345463454734548345493455034551345523455334554345553455634557345583455934560345613456234563345643456534566345673456834569345703457134572345733457434575345763457734578345793458034581345823458334584345853458634587345883458934590345913459234593345943459534596345973459834599346003460134602346033460434605346063460734608346093461034611346123461334614346153461634617346183461934620346213462234623346243462534626346273462834629346303463134632346333463434635346363463734638346393464034641346423464334644346453464634647346483464934650346513465234653346543465534656346573465834659346603466134662346633466434665346663466734668346693467034671346723467334674346753467634677346783467934680346813468234683346843468534686346873468834689346903469134692346933469434695346963469734698346993470034701347023470334704347053470634707347083470934710347113471234713347143471534716347173471834719347203472134722347233472434725347263472734728347293473034731347323473334734347353473634737347383473934740347413474234743347443474534746347473474834749347503475134752347533475434755347563475734758347593476034761347623476334764347653476634767347683476934770347713477234773347743477534776347773477834779347803478134782347833478434785347863478734788347893479034791347923479334794347953479634797347983479934800348013480234803348043480534806348073480834809348103481134812348133481434815348163481734818348193482034821348223482334824348253482634827348283482934830348313483234833348343483534836348373483834839348403484134842348433484434845348463484734848348493485034851348523485334854348553485634857348583485934860348613486234863348643486534866348673486834869348703487134872348733487434875348763487734878348793488034881348823488334884348853488634887348883488934890348913489234893348943489534896348973489834899349003490134902349033490434905349063490734908349093491034911349123491334914349153491634917349183491934920349213492234923349243492534926349273492834929349303493134932349333493434935349363493734938349393494034941349423494334944349453494634947349483494934950349513495234953349543495534956349573495834959349603496134962349633496434965349663496734968349693497034971349723497334974349753497634977349783497934980349813498234983349843498534986349873498834989349903499134992349933499434995349963499734998349993500035001350023500335004350053500635007350083500935010350113501235013350143501535016350173501835019350203502135022350233502435025350263502735028350293503035031350323503335034350353503635037350383503935040350413504235043350443504535046350473504835049350503505135052350533505435055350563505735058350593506035061350623506335064350653506635067350683506935070350713507235073350743507535076350773507835079350803508135082350833508435085350863508735088350893509035091350923509335094350953509635097350983509935100351013510235103351043510535106351073510835109351103511135112351133511435115351163511735118351193512035121351223512335124351253512635127351283512935130351313513235133351343513535136351373513835139351403514135142351433514435145351463514735148351493515035151351523515335154351553515635157351583515935160351613516235163351643516535166351673516835169351703517135172351733517435175351763517735178351793518035181351823518335184351853518635187351883518935190351913519235193351943519535196351973519835199352003520135202352033520435205352063520735208352093521035211352123521335214352153521635217352183521935220352213522235223352243522535226352273522835229352303523135232352333523435235352363523735238352393524035241352423524335244352453524635247352483524935250352513525235253352543525535256352573525835259352603526135262352633526435265352663526735268352693527035271352723527335274352753527635277352783527935280352813528235283352843528535286352873528835289352903529135292352933529435295352963529735298352993530035301353023530335304353053530635307353083530935310353113531235313353143531535316353173531835319353203532135322353233532435325353263532735328353293533035331353323533335334353353533635337353383533935340353413534235343353443534535346353473534835349353503535135352353533535435355353563535735358353593536035361353623536335364353653536635367353683536935370353713537235373353743537535376353773537835379353803538135382353833538435385353863538735388353893539035391353923539335394353953539635397353983539935400354013540235403354043540535406354073540835409354103541135412354133541435415354163541735418354193542035421354223542335424354253542635427354283542935430354313543235433354343543535436354373543835439354403544135442354433544435445354463544735448354493545035451354523545335454354553545635457354583545935460354613546235463354643546535466354673546835469354703547135472354733547435475354763547735478354793548035481354823548335484354853548635487354883548935490354913549235493354943549535496354973549835499355003550135502355033550435505355063550735508355093551035511355123551335514355153551635517355183551935520355213552235523355243552535526355273552835529355303553135532355333553435535355363553735538355393554035541355423554335544355453554635547355483554935550355513555235553355543555535556355573555835559355603556135562355633556435565355663556735568355693557035571355723557335574355753557635577355783557935580355813558235583355843558535586355873558835589355903559135592355933559435595355963559735598355993560035601356023560335604356053560635607356083560935610356113561235613356143561535616356173561835619356203562135622356233562435625356263562735628356293563035631356323563335634356353563635637356383563935640356413564235643356443564535646356473564835649356503565135652356533565435655356563565735658356593566035661356623566335664356653566635667356683566935670356713567235673356743567535676356773567835679356803568135682356833568435685356863568735688356893569035691356923569335694356953569635697356983569935700357013570235703357043570535706357073570835709357103571135712357133571435715357163571735718357193572035721357223572335724357253572635727357283572935730357313573235733357343573535736357373573835739357403574135742357433574435745357463574735748357493575035751357523575335754357553575635757357583575935760357613576235763357643576535766357673576835769357703577135772357733577435775357763577735778357793578035781357823578335784357853578635787357883578935790357913579235793357943579535796357973579835799358003580135802358033580435805358063580735808358093581035811358123581335814358153581635817358183581935820358213582235823358243582535826358273582835829358303583135832358333583435835358363583735838358393584035841358423584335844358453584635847358483584935850358513585235853358543585535856358573585835859358603586135862358633586435865358663586735868358693587035871358723587335874358753587635877358783587935880358813588235883358843588535886358873588835889358903589135892358933589435895358963589735898358993590035901359023590335904359053590635907359083590935910359113591235913359143591535916359173591835919359203592135922359233592435925359263592735928359293593035931359323593335934359353593635937359383593935940359413594235943359443594535946359473594835949359503595135952359533595435955359563595735958359593596035961359623596335964359653596635967359683596935970359713597235973359743597535976359773597835979359803598135982359833598435985359863598735988359893599035991359923599335994359953599635997359983599936000360013600236003360043600536006360073600836009360103601136012360133601436015360163601736018360193602036021360223602336024360253602636027360283602936030360313603236033360343603536036360373603836039360403604136042360433604436045360463604736048360493605036051360523605336054360553605636057360583605936060360613606236063360643606536066360673606836069360703607136072360733607436075360763607736078360793608036081360823608336084360853608636087360883608936090360913609236093360943609536096360973609836099361003610136102361033610436105361063610736108361093611036111361123611336114361153611636117361183611936120361213612236123361243612536126361273612836129361303613136132361333613436135361363613736138361393614036141361423614336144361453614636147361483614936150361513615236153361543615536156361573615836159361603616136162361633616436165361663616736168361693617036171361723617336174361753617636177361783617936180361813618236183361843618536186361873618836189361903619136192361933619436195361963619736198361993620036201362023620336204362053620636207362083620936210362113621236213362143621536216362173621836219362203622136222362233622436225362263622736228362293623036231362323623336234362353623636237362383623936240362413624236243362443624536246362473624836249362503625136252362533625436255362563625736258362593626036261362623626336264362653626636267362683626936270362713627236273362743627536276362773627836279362803628136282362833628436285362863628736288362893629036291362923629336294362953629636297362983629936300363013630236303363043630536306363073630836309363103631136312363133631436315363163631736318363193632036321363223632336324363253632636327363283632936330363313633236333363343633536336363373633836339363403634136342363433634436345363463634736348363493635036351363523635336354363553635636357363583635936360363613636236363363643636536366363673636836369363703637136372363733637436375363763637736378363793638036381363823638336384363853638636387363883638936390363913639236393363943639536396363973639836399364003640136402364033640436405364063640736408364093641036411364123641336414364153641636417364183641936420364213642236423364243642536426364273642836429364303643136432364333643436435364363643736438364393644036441364423644336444364453644636447364483644936450364513645236453364543645536456364573645836459364603646136462364633646436465364663646736468364693647036471364723647336474364753647636477364783647936480364813648236483364843648536486364873648836489364903649136492364933649436495364963649736498364993650036501365023650336504365053650636507365083650936510365113651236513365143651536516365173651836519365203652136522365233652436525365263652736528365293653036531365323653336534365353653636537365383653936540365413654236543365443654536546365473654836549365503655136552365533655436555365563655736558365593656036561365623656336564365653656636567365683656936570365713657236573365743657536576365773657836579365803658136582365833658436585365863658736588365893659036591365923659336594365953659636597365983659936600366013660236603366043660536606366073660836609366103661136612366133661436615366163661736618366193662036621366223662336624366253662636627366283662936630366313663236633366343663536636366373663836639366403664136642366433664436645366463664736648366493665036651366523665336654366553665636657366583665936660366613666236663366643666536666366673666836669366703667136672366733667436675366763667736678366793668036681366823668336684366853668636687366883668936690366913669236693366943669536696366973669836699367003670136702367033670436705367063670736708367093671036711367123671336714367153671636717367183671936720367213672236723367243672536726367273672836729367303673136732367333673436735367363673736738367393674036741367423674336744367453674636747367483674936750367513675236753367543675536756367573675836759367603676136762367633676436765367663676736768367693677036771367723677336774367753677636777367783677936780367813678236783367843678536786367873678836789367903679136792367933679436795367963679736798367993680036801368023680336804368053680636807368083680936810368113681236813368143681536816368173681836819368203682136822368233682436825368263682736828368293683036831368323683336834368353683636837368383683936840368413684236843368443684536846368473684836849368503685136852368533685436855368563685736858368593686036861368623686336864368653686636867368683686936870368713687236873368743687536876368773687836879368803688136882368833688436885368863688736888368893689036891368923689336894368953689636897368983689936900369013690236903369043690536906369073690836909369103691136912369133691436915369163691736918369193692036921369223692336924369253692636927369283692936930369313693236933369343693536936369373693836939369403694136942369433694436945369463694736948369493695036951369523695336954369553695636957369583695936960369613696236963369643696536966369673696836969369703697136972369733697436975369763697736978369793698036981369823698336984369853698636987369883698936990369913699236993369943699536996369973699836999370003700137002370033700437005370063700737008370093701037011370123701337014370153701637017370183701937020370213702237023370243702537026370273702837029370303703137032370333703437035370363703737038370393704037041370423704337044370453704637047370483704937050370513705237053370543705537056370573705837059370603706137062370633706437065370663706737068370693707037071370723707337074370753707637077370783707937080370813708237083370843708537086370873708837089370903709137092370933709437095370963709737098370993710037101371023710337104371053710637107371083710937110371113711237113371143711537116371173711837119371203712137122371233712437125371263712737128371293713037131371323713337134371353713637137371383713937140371413714237143371443714537146371473714837149371503715137152371533715437155371563715737158371593716037161371623716337164371653716637167371683716937170371713717237173371743717537176371773717837179371803718137182371833718437185371863718737188371893719037191371923719337194371953719637197371983719937200372013720237203372043720537206372073720837209372103721137212372133721437215372163721737218372193722037221372223722337224372253722637227372283722937230372313723237233372343723537236372373723837239372403724137242372433724437245372463724737248372493725037251372523725337254372553725637257372583725937260372613726237263372643726537266372673726837269372703727137272372733727437275372763727737278372793728037281372823728337284372853728637287372883728937290372913729237293372943729537296372973729837299373003730137302373033730437305373063730737308373093731037311373123731337314373153731637317373183731937320373213732237323373243732537326373273732837329373303733137332373333733437335373363733737338373393734037341373423734337344373453734637347373483734937350373513735237353373543735537356373573735837359373603736137362373633736437365373663736737368373693737037371373723737337374373753737637377373783737937380373813738237383373843738537386373873738837389373903739137392373933739437395373963739737398373993740037401374023740337404374053740637407374083740937410374113741237413374143741537416374173741837419374203742137422374233742437425374263742737428374293743037431374323743337434374353743637437374383743937440374413744237443374443744537446374473744837449374503745137452374533745437455374563745737458374593746037461374623746337464374653746637467374683746937470374713747237473374743747537476374773747837479374803748137482374833748437485374863748737488374893749037491374923749337494374953749637497374983749937500375013750237503375043750537506375073750837509375103751137512375133751437515375163751737518375193752037521375223752337524375253752637527375283752937530375313753237533375343753537536375373753837539375403754137542375433754437545375463754737548375493755037551375523755337554375553755637557375583755937560375613756237563375643756537566375673756837569375703757137572375733757437575375763757737578375793758037581375823758337584375853758637587375883758937590375913759237593375943759537596375973759837599376003760137602376033760437605376063760737608376093761037611376123761337614376153761637617376183761937620376213762237623376243762537626376273762837629376303763137632376333763437635376363763737638376393764037641376423764337644376453764637647376483764937650376513765237653376543765537656376573765837659376603766137662376633766437665376663766737668376693767037671376723767337674376753767637677376783767937680376813768237683376843768537686376873768837689376903769137692376933769437695376963769737698376993770037701377023770337704377053770637707377083770937710377113771237713377143771537716377173771837719377203772137722377233772437725377263772737728377293773037731377323773337734377353773637737377383773937740377413774237743377443774537746377473774837749377503775137752377533775437755377563775737758377593776037761377623776337764377653776637767377683776937770377713777237773377743777537776377773777837779377803778137782377833778437785377863778737788377893779037791377923779337794377953779637797377983779937800378013780237803378043780537806378073780837809378103781137812378133781437815378163781737818378193782037821378223782337824378253782637827378283782937830378313783237833378343783537836378373783837839378403784137842378433784437845378463784737848378493785037851378523785337854378553785637857378583785937860378613786237863378643786537866378673786837869378703787137872378733787437875378763787737878378793788037881378823788337884378853788637887378883788937890378913789237893378943789537896378973789837899379003790137902379033790437905379063790737908379093791037911379123791337914379153791637917379183791937920379213792237923379243792537926379273792837929379303793137932379333793437935379363793737938379393794037941379423794337944379453794637947379483794937950379513795237953379543795537956379573795837959379603796137962379633796437965379663796737968379693797037971379723797337974379753797637977379783797937980379813798237983379843798537986379873798837989379903799137992379933799437995379963799737998379993800038001380023800338004380053800638007380083800938010380113801238013380143801538016380173801838019380203802138022380233802438025380263802738028380293803038031380323803338034380353803638037380383803938040380413804238043380443804538046380473804838049380503805138052380533805438055380563805738058380593806038061380623806338064380653806638067380683806938070380713807238073380743807538076380773807838079380803808138082380833808438085380863808738088380893809038091380923809338094380953809638097380983809938100381013810238103381043810538106381073810838109381103811138112381133811438115381163811738118381193812038121381223812338124381253812638127381283812938130381313813238133381343813538136381373813838139381403814138142381433814438145381463814738148381493815038151381523815338154381553815638157381583815938160381613816238163381643816538166381673816838169381703817138172381733817438175381763817738178381793818038181381823818338184381853818638187381883818938190381913819238193381943819538196381973819838199382003820138202382033820438205382063820738208382093821038211382123821338214382153821638217382183821938220382213822238223382243822538226382273822838229382303823138232382333823438235382363823738238382393824038241382423824338244382453824638247382483824938250382513825238253382543825538256382573825838259382603826138262382633826438265382663826738268382693827038271382723827338274382753827638277382783827938280382813828238283382843828538286382873828838289382903829138292382933829438295382963829738298382993830038301383023830338304383053830638307383083830938310383113831238313383143831538316383173831838319383203832138322383233832438325383263832738328383293833038331383323833338334383353833638337383383833938340383413834238343383443834538346383473834838349383503835138352383533835438355383563835738358383593836038361383623836338364383653836638367383683836938370383713837238373383743837538376383773837838379383803838138382383833838438385383863838738388383893839038391383923839338394383953839638397383983839938400384013840238403384043840538406384073840838409384103841138412384133841438415384163841738418384193842038421384223842338424384253842638427384283842938430384313843238433384343843538436384373843838439384403844138442384433844438445384463844738448384493845038451384523845338454384553845638457384583845938460384613846238463384643846538466384673846838469384703847138472384733847438475384763847738478384793848038481384823848338484384853848638487384883848938490384913849238493384943849538496384973849838499385003850138502385033850438505385063850738508385093851038511385123851338514385153851638517385183851938520385213852238523385243852538526385273852838529385303853138532385333853438535385363853738538385393854038541385423854338544385453854638547385483854938550385513855238553385543855538556385573855838559385603856138562385633856438565385663856738568385693857038571385723857338574385753857638577385783857938580385813858238583385843858538586385873858838589385903859138592385933859438595385963859738598385993860038601386023860338604386053860638607386083860938610386113861238613386143861538616386173861838619386203862138622386233862438625386263862738628386293863038631386323863338634386353863638637386383863938640386413864238643386443864538646386473864838649386503865138652386533865438655386563865738658386593866038661386623866338664386653866638667386683866938670386713867238673386743867538676386773867838679386803868138682386833868438685386863868738688386893869038691386923869338694386953869638697386983869938700387013870238703387043870538706387073870838709387103871138712387133871438715387163871738718387193872038721387223872338724387253872638727387283872938730387313873238733387343873538736387373873838739387403874138742387433874438745387463874738748387493875038751387523875338754387553875638757387583875938760387613876238763387643876538766387673876838769387703877138772387733877438775387763877738778387793878038781387823878338784387853878638787387883878938790387913879238793387943879538796387973879838799388003880138802388033880438805388063880738808388093881038811388123881338814388153881638817388183881938820388213882238823388243882538826388273882838829388303883138832388333883438835388363883738838388393884038841388423884338844388453884638847388483884938850388513885238853388543885538856388573885838859388603886138862388633886438865388663886738868388693887038871388723887338874388753887638877388783887938880388813888238883388843888538886388873888838889388903889138892388933889438895388963889738898388993890038901389023890338904389053890638907389083890938910389113891238913389143891538916389173891838919389203892138922389233892438925389263892738928389293893038931389323893338934389353893638937389383893938940389413894238943389443894538946389473894838949389503895138952389533895438955389563895738958389593896038961389623896338964389653896638967389683896938970389713897238973389743897538976389773897838979389803898138982389833898438985389863898738988389893899038991389923899338994389953899638997389983899939000390013900239003390043900539006390073900839009390103901139012390133901439015390163901739018390193902039021390223902339024390253902639027390283902939030390313903239033390343903539036390373903839039390403904139042390433904439045390463904739048390493905039051390523905339054390553905639057390583905939060390613906239063390643906539066390673906839069390703907139072390733907439075390763907739078390793908039081390823908339084390853908639087390883908939090390913909239093390943909539096390973909839099391003910139102391033910439105391063910739108391093911039111391123911339114391153911639117391183911939120391213912239123391243912539126391273912839129391303913139132391333913439135391363913739138391393914039141391423914339144391453914639147391483914939150391513915239153391543915539156391573915839159391603916139162391633916439165391663916739168391693917039171391723917339174391753917639177391783917939180391813918239183391843918539186391873918839189391903919139192391933919439195391963919739198391993920039201392023920339204392053920639207392083920939210392113921239213392143921539216392173921839219392203922139222392233922439225392263922739228392293923039231392323923339234392353923639237392383923939240392413924239243392443924539246392473924839249392503925139252392533925439255392563925739258392593926039261392623926339264392653926639267392683926939270392713927239273392743927539276392773927839279392803928139282392833928439285392863928739288392893929039291392923929339294392953929639297392983929939300393013930239303393043930539306393073930839309393103931139312393133931439315393163931739318393193932039321393223932339324393253932639327393283932939330393313933239333393343933539336393373933839339393403934139342393433934439345393463934739348393493935039351393523935339354393553935639357393583935939360393613936239363393643936539366393673936839369393703937139372393733937439375393763937739378393793938039381393823938339384393853938639387393883938939390393913939239393393943939539396393973939839399394003940139402394033940439405394063940739408394093941039411394123941339414394153941639417394183941939420394213942239423394243942539426394273942839429394303943139432394333943439435394363943739438394393944039441394423944339444394453944639447394483944939450394513945239453394543945539456394573945839459394603946139462394633946439465394663946739468394693947039471394723947339474394753947639477394783947939480394813948239483394843948539486394873948839489394903949139492394933949439495394963949739498394993950039501395023950339504395053950639507395083950939510395113951239513395143951539516395173951839519395203952139522395233952439525395263952739528395293953039531395323953339534395353953639537395383953939540395413954239543395443954539546395473954839549395503955139552395533955439555395563955739558395593956039561395623956339564395653956639567395683956939570395713957239573395743957539576395773957839579395803958139582395833958439585395863958739588395893959039591395923959339594395953959639597395983959939600396013960239603396043960539606396073960839609396103961139612396133961439615396163961739618396193962039621396223962339624396253962639627396283962939630396313963239633396343963539636396373963839639396403964139642396433964439645396463964739648396493965039651396523965339654396553965639657396583965939660396613966239663396643966539666396673966839669396703967139672396733967439675396763967739678396793968039681396823968339684396853968639687396883968939690396913969239693396943969539696396973969839699397003970139702397033970439705397063970739708397093971039711397123971339714397153971639717397183971939720397213972239723397243972539726397273972839729397303973139732397333973439735397363973739738397393974039741397423974339744397453974639747397483974939750397513975239753397543975539756397573975839759397603976139762397633976439765397663976739768397693977039771397723977339774397753977639777397783977939780397813978239783397843978539786397873978839789397903979139792397933979439795397963979739798397993980039801398023980339804398053980639807398083980939810398113981239813398143981539816398173981839819398203982139822398233982439825398263982739828398293983039831398323983339834398353983639837398383983939840398413984239843398443984539846398473984839849398503985139852398533985439855398563985739858398593986039861398623986339864398653986639867398683986939870398713987239873398743987539876398773987839879398803988139882398833988439885398863988739888398893989039891398923989339894398953989639897398983989939900399013990239903399043990539906399073990839909399103991139912399133991439915399163991739918399193992039921399223992339924399253992639927399283992939930399313993239933399343993539936399373993839939399403994139942399433994439945399463994739948399493995039951399523995339954399553995639957399583995939960399613996239963399643996539966399673996839969399703997139972399733997439975399763997739978399793998039981399823998339984399853998639987399883998939990399913999239993399943999539996399973999839999400004000140002400034000440005400064000740008400094001040011400124001340014400154001640017400184001940020400214002240023400244002540026400274002840029400304003140032400334003440035400364003740038400394004040041400424004340044400454004640047400484004940050400514005240053400544005540056400574005840059400604006140062400634006440065400664006740068400694007040071400724007340074400754007640077400784007940080400814008240083400844008540086400874008840089400904009140092400934009440095400964009740098400994010040101401024010340104401054010640107401084010940110401114011240113401144011540116401174011840119401204012140122401234012440125401264012740128401294013040131401324013340134401354013640137401384013940140401414014240143401444014540146401474014840149401504015140152401534015440155401564015740158401594016040161401624016340164401654016640167401684016940170401714017240173401744017540176401774017840179401804018140182401834018440185401864018740188401894019040191401924019340194401954019640197401984019940200402014020240203402044020540206402074020840209402104021140212402134021440215402164021740218402194022040221402224022340224402254022640227402284022940230402314023240233402344023540236402374023840239402404024140242402434024440245402464024740248402494025040251402524025340254402554025640257402584025940260402614026240263402644026540266402674026840269402704027140272402734027440275402764027740278402794028040281402824028340284402854028640287402884028940290402914029240293402944029540296402974029840299403004030140302403034030440305403064030740308403094031040311403124031340314403154031640317403184031940320403214032240323403244032540326403274032840329403304033140332403334033440335403364033740338403394034040341403424034340344403454034640347403484034940350403514035240353403544035540356403574035840359403604036140362403634036440365403664036740368403694037040371403724037340374403754037640377403784037940380403814038240383403844038540386403874038840389403904039140392403934039440395403964039740398403994040040401404024040340404404054040640407404084040940410404114041240413404144041540416404174041840419404204042140422404234042440425404264042740428404294043040431404324043340434404354043640437404384043940440404414044240443404444044540446404474044840449404504045140452404534045440455404564045740458404594046040461404624046340464404654046640467404684046940470404714047240473404744047540476404774047840479404804048140482404834048440485404864048740488404894049040491404924049340494404954049640497404984049940500405014050240503405044050540506405074050840509405104051140512405134051440515405164051740518405194052040521405224052340524405254052640527405284052940530405314053240533405344053540536405374053840539405404054140542405434054440545405464054740548405494055040551405524055340554405554055640557405584055940560405614056240563405644056540566405674056840569405704057140572405734057440575405764057740578405794058040581405824058340584405854058640587405884058940590405914059240593405944059540596405974059840599406004060140602406034060440605406064060740608406094061040611406124061340614406154061640617406184061940620406214062240623406244062540626406274062840629406304063140632406334063440635406364063740638406394064040641406424064340644406454064640647406484064940650406514065240653406544065540656406574065840659406604066140662406634066440665406664066740668406694067040671406724067340674406754067640677406784067940680406814068240683406844068540686406874068840689406904069140692406934069440695406964069740698406994070040701407024070340704407054070640707407084070940710407114071240713407144071540716407174071840719407204072140722407234072440725407264072740728407294073040731407324073340734407354073640737407384073940740407414074240743407444074540746407474074840749407504075140752407534075440755407564075740758407594076040761407624076340764407654076640767407684076940770407714077240773407744077540776407774077840779407804078140782407834078440785407864078740788407894079040791407924079340794407954079640797407984079940800408014080240803408044080540806408074080840809408104081140812408134081440815408164081740818408194082040821408224082340824408254082640827408284082940830408314083240833408344083540836408374083840839408404084140842408434084440845408464084740848408494085040851408524085340854408554085640857408584085940860408614086240863408644086540866408674086840869408704087140872408734087440875408764087740878408794088040881408824088340884408854088640887408884088940890408914089240893408944089540896408974089840899409004090140902409034090440905409064090740908409094091040911409124091340914409154091640917409184091940920409214092240923409244092540926409274092840929409304093140932409334093440935409364093740938409394094040941409424094340944409454094640947409484094940950409514095240953409544095540956409574095840959409604096140962409634096440965409664096740968409694097040971409724097340974409754097640977409784097940980409814098240983409844098540986409874098840989409904099140992409934099440995409964099740998409994100041001410024100341004410054100641007410084100941010410114101241013410144101541016410174101841019410204102141022410234102441025410264102741028410294103041031410324103341034410354103641037410384103941040410414104241043410444104541046410474104841049410504105141052410534105441055410564105741058410594106041061410624106341064410654106641067410684106941070410714107241073410744107541076410774107841079410804108141082410834108441085410864108741088410894109041091410924109341094410954109641097410984109941100411014110241103411044110541106411074110841109411104111141112411134111441115411164111741118411194112041121411224112341124411254112641127411284112941130411314113241133411344113541136411374113841139411404114141142411434114441145411464114741148411494115041151411524115341154411554115641157411584115941160411614116241163411644116541166411674116841169411704117141172411734117441175411764117741178411794118041181411824118341184411854118641187411884118941190411914119241193411944119541196411974119841199412004120141202412034120441205412064120741208412094121041211412124121341214412154121641217412184121941220412214122241223412244122541226412274122841229412304123141232412334123441235412364123741238412394124041241412424124341244412454124641247412484124941250412514125241253412544125541256412574125841259412604126141262412634126441265412664126741268412694127041271412724127341274412754127641277412784127941280412814128241283412844128541286412874128841289412904129141292412934129441295412964129741298412994130041301413024130341304413054130641307413084130941310413114131241313413144131541316413174131841319413204132141322413234132441325413264132741328413294133041331413324133341334413354133641337413384133941340413414134241343413444134541346413474134841349413504135141352413534135441355413564135741358413594136041361413624136341364413654136641367413684136941370413714137241373413744137541376413774137841379413804138141382413834138441385413864138741388413894139041391413924139341394413954139641397413984139941400414014140241403414044140541406414074140841409414104141141412414134141441415414164141741418414194142041421414224142341424414254142641427414284142941430414314143241433414344143541436414374143841439414404144141442414434144441445414464144741448414494145041451414524145341454414554145641457414584145941460414614146241463414644146541466414674146841469414704147141472414734147441475414764147741478414794148041481414824148341484414854148641487414884148941490414914149241493414944149541496414974149841499415004150141502415034150441505415064150741508415094151041511415124151341514415154151641517415184151941520415214152241523415244152541526415274152841529415304153141532415334153441535415364153741538415394154041541415424154341544415454154641547415484154941550415514155241553415544155541556415574155841559415604156141562415634156441565415664156741568415694157041571415724157341574415754157641577415784157941580415814158241583415844158541586415874158841589415904159141592415934159441595415964159741598415994160041601416024160341604416054160641607416084160941610416114161241613416144161541616416174161841619416204162141622416234162441625416264162741628416294163041631416324163341634416354163641637416384163941640416414164241643416444164541646416474164841649416504165141652416534165441655416564165741658416594166041661416624166341664416654166641667416684166941670416714167241673416744167541676416774167841679416804168141682416834168441685416864168741688416894169041691416924169341694416954169641697416984169941700417014170241703417044170541706417074170841709417104171141712417134171441715417164171741718417194172041721417224172341724417254172641727417284172941730417314173241733417344173541736417374173841739417404174141742417434174441745417464174741748417494175041751417524175341754417554175641757417584175941760417614176241763417644176541766417674176841769417704177141772417734177441775417764177741778417794178041781417824178341784417854178641787417884178941790417914179241793417944179541796417974179841799418004180141802418034180441805418064180741808418094181041811418124181341814418154181641817418184181941820418214182241823418244182541826418274182841829418304183141832418334183441835418364183741838418394184041841418424184341844418454184641847418484184941850418514185241853418544185541856418574185841859418604186141862418634186441865418664186741868418694187041871418724187341874418754187641877418784187941880418814188241883418844188541886418874188841889418904189141892418934189441895418964189741898418994190041901419024190341904419054190641907419084190941910419114191241913419144191541916419174191841919419204192141922419234192441925419264192741928419294193041931419324193341934419354193641937419384193941940419414194241943419444194541946419474194841949419504195141952419534195441955419564195741958419594196041961419624196341964419654196641967419684196941970419714197241973419744197541976419774197841979419804198141982419834198441985419864198741988419894199041991419924199341994419954199641997419984199942000420014200242003420044200542006420074200842009420104201142012420134201442015420164201742018420194202042021420224202342024420254202642027420284202942030420314203242033420344203542036420374203842039420404204142042420434204442045420464204742048420494205042051420524205342054420554205642057420584205942060420614206242063420644206542066420674206842069420704207142072420734207442075420764207742078420794208042081420824208342084420854208642087420884208942090420914209242093420944209542096420974209842099421004210142102421034210442105421064210742108421094211042111421124211342114421154211642117421184211942120421214212242123421244212542126421274212842129421304213142132421334213442135421364213742138421394214042141421424214342144421454214642147421484214942150421514215242153421544215542156421574215842159421604216142162421634216442165421664216742168421694217042171421724217342174421754217642177421784217942180421814218242183421844218542186421874218842189421904219142192421934219442195421964219742198421994220042201422024220342204422054220642207422084220942210422114221242213422144221542216422174221842219422204222142222422234222442225422264222742228422294223042231422324223342234422354223642237422384223942240422414224242243422444224542246422474224842249422504225142252422534225442255422564225742258422594226042261422624226342264422654226642267422684226942270422714227242273422744227542276422774227842279422804228142282422834228442285422864228742288422894229042291422924229342294422954229642297422984229942300423014230242303423044230542306423074230842309423104231142312423134231442315423164231742318423194232042321423224232342324423254232642327423284232942330423314233242333423344233542336423374233842339423404234142342423434234442345423464234742348423494235042351423524235342354423554235642357423584235942360423614236242363423644236542366423674236842369423704237142372423734237442375423764237742378423794238042381423824238342384423854238642387423884238942390423914239242393423944239542396423974239842399424004240142402424034240442405424064240742408424094241042411424124241342414424154241642417424184241942420424214242242423424244242542426424274242842429424304243142432424334243442435424364243742438424394244042441424424244342444424454244642447424484244942450424514245242453424544245542456424574245842459424604246142462424634246442465424664246742468424694247042471424724247342474424754247642477424784247942480424814248242483424844248542486424874248842489424904249142492424934249442495424964249742498424994250042501425024250342504425054250642507425084250942510425114251242513425144251542516425174251842519425204252142522425234252442525425264252742528425294253042531425324253342534425354253642537425384253942540425414254242543425444254542546425474254842549425504255142552425534255442555425564255742558425594256042561425624256342564425654256642567425684256942570425714257242573425744257542576425774257842579425804258142582425834258442585425864258742588425894259042591425924259342594425954259642597425984259942600426014260242603426044260542606426074260842609426104261142612426134261442615426164261742618426194262042621426224262342624426254262642627426284262942630426314263242633426344263542636426374263842639426404264142642426434264442645426464264742648426494265042651426524265342654426554265642657426584265942660426614266242663426644266542666426674266842669426704267142672426734267442675426764267742678426794268042681426824268342684426854268642687426884268942690426914269242693426944269542696426974269842699427004270142702427034270442705427064270742708427094271042711427124271342714427154271642717427184271942720427214272242723427244272542726427274272842729427304273142732427334273442735427364273742738427394274042741427424274342744427454274642747427484274942750427514275242753427544275542756427574275842759427604276142762427634276442765427664276742768427694277042771427724277342774427754277642777427784277942780427814278242783427844278542786427874278842789427904279142792427934279442795427964279742798427994280042801428024280342804428054280642807428084280942810428114281242813428144281542816428174281842819428204282142822428234282442825428264282742828428294283042831428324283342834428354283642837428384283942840428414284242843428444284542846428474284842849428504285142852428534285442855428564285742858428594286042861428624286342864428654286642867428684286942870428714287242873428744287542876428774287842879428804288142882428834288442885428864288742888428894289042891428924289342894428954289642897428984289942900429014290242903429044290542906429074290842909429104291142912429134291442915429164291742918429194292042921429224292342924429254292642927429284292942930429314293242933429344293542936429374293842939429404294142942429434294442945429464294742948429494295042951429524295342954429554295642957429584295942960429614296242963429644296542966429674296842969429704297142972429734297442975429764297742978429794298042981429824298342984429854298642987429884298942990429914299242993429944299542996429974299842999430004300143002430034300443005430064300743008430094301043011430124301343014430154301643017430184301943020430214302243023430244302543026430274302843029430304303143032430334303443035430364303743038430394304043041430424304343044430454304643047430484304943050430514305243053430544305543056430574305843059430604306143062430634306443065430664306743068430694307043071430724307343074430754307643077430784307943080430814308243083430844308543086430874308843089430904309143092430934309443095430964309743098430994310043101431024310343104431054310643107431084310943110431114311243113431144311543116431174311843119431204312143122431234312443125431264312743128431294313043131431324313343134431354313643137431384313943140431414314243143431444314543146431474314843149431504315143152431534315443155431564315743158431594316043161431624316343164431654316643167431684316943170431714317243173431744317543176431774317843179431804318143182431834318443185431864318743188431894319043191431924319343194431954319643197431984319943200432014320243203432044320543206432074320843209432104321143212432134321443215432164321743218432194322043221432224322343224432254322643227432284322943230432314323243233432344323543236432374323843239432404324143242432434324443245432464324743248432494325043251432524325343254432554325643257432584325943260432614326243263432644326543266432674326843269432704327143272432734327443275432764327743278432794328043281432824328343284432854328643287432884328943290432914329243293432944329543296432974329843299433004330143302433034330443305433064330743308433094331043311433124331343314433154331643317433184331943320433214332243323433244332543326433274332843329433304333143332433334333443335433364333743338433394334043341433424334343344433454334643347433484334943350433514335243353433544335543356433574335843359433604336143362433634336443365433664336743368433694337043371433724337343374433754337643377433784337943380433814338243383433844338543386433874338843389433904339143392433934339443395433964339743398433994340043401434024340343404434054340643407434084340943410434114341243413434144341543416434174341843419434204342143422434234342443425434264342743428434294343043431434324343343434434354343643437434384343943440434414344243443434444344543446434474344843449434504345143452434534345443455434564345743458434594346043461434624346343464434654346643467434684346943470434714347243473434744347543476434774347843479434804348143482434834348443485434864348743488434894349043491434924349343494434954349643497434984349943500435014350243503435044350543506435074350843509435104351143512435134351443515435164351743518435194352043521435224352343524435254352643527435284352943530435314353243533435344353543536435374353843539435404354143542435434354443545435464354743548435494355043551435524355343554435554355643557435584355943560435614356243563435644356543566435674356843569435704357143572435734357443575435764357743578435794358043581435824358343584435854358643587435884358943590435914359243593435944359543596435974359843599436004360143602436034360443605436064360743608436094361043611436124361343614436154361643617436184361943620436214362243623436244362543626436274362843629436304363143632436334363443635436364363743638436394364043641436424364343644436454364643647436484364943650436514365243653436544365543656436574365843659436604366143662436634366443665436664366743668436694367043671436724367343674436754367643677436784367943680436814368243683436844368543686436874368843689436904369143692436934369443695436964369743698436994370043701437024370343704437054370643707437084370943710437114371243713437144371543716437174371843719437204372143722437234372443725437264372743728437294373043731437324373343734437354373643737437384373943740437414374243743437444374543746437474374843749437504375143752437534375443755437564375743758437594376043761437624376343764437654376643767437684376943770437714377243773437744377543776437774377843779437804378143782437834378443785437864378743788437894379043791437924379343794437954379643797437984379943800438014380243803438044380543806438074380843809438104381143812438134381443815438164381743818438194382043821438224382343824438254382643827438284382943830438314383243833438344383543836438374383843839438404384143842438434384443845438464384743848438494385043851438524385343854438554385643857438584385943860438614386243863438644386543866438674386843869438704387143872438734387443875438764387743878438794388043881438824388343884438854388643887438884388943890438914389243893438944389543896438974389843899439004390143902439034390443905439064390743908439094391043911439124391343914439154391643917439184391943920439214392243923439244392543926439274392843929439304393143932439334393443935439364393743938439394394043941439424394343944439454394643947439484394943950439514395243953439544395543956439574395843959439604396143962439634396443965439664396743968439694397043971439724397343974439754397643977439784397943980439814398243983439844398543986439874398843989439904399143992439934399443995439964399743998439994400044001440024400344004440054400644007440084400944010440114401244013440144401544016440174401844019440204402144022440234402444025440264402744028440294403044031440324403344034440354403644037440384403944040440414404244043440444404544046440474404844049440504405144052440534405444055440564405744058440594406044061440624406344064440654406644067440684406944070440714407244073440744407544076440774407844079440804408144082440834408444085440864408744088440894409044091440924409344094440954409644097440984409944100441014410244103441044410544106441074410844109441104411144112441134411444115441164411744118441194412044121441224412344124441254412644127441284412944130441314413244133441344413544136441374413844139441404414144142441434414444145441464414744148441494415044151441524415344154441554415644157441584415944160441614416244163441644416544166441674416844169441704417144172441734417444175441764417744178441794418044181441824418344184441854418644187441884418944190441914419244193441944419544196441974419844199442004420144202442034420444205442064420744208442094421044211442124421344214442154421644217442184421944220442214422244223442244422544226442274422844229442304423144232442334423444235442364423744238442394424044241442424424344244442454424644247442484424944250442514425244253442544425544256442574425844259442604426144262442634426444265442664426744268442694427044271442724427344274442754427644277442784427944280442814428244283442844428544286442874428844289442904429144292442934429444295442964429744298442994430044301443024430344304443054430644307443084430944310443114431244313443144431544316443174431844319443204432144322443234432444325443264432744328443294433044331443324433344334443354433644337443384433944340443414434244343443444434544346443474434844349443504435144352443534435444355443564435744358443594436044361443624436344364443654436644367443684436944370443714437244373443744437544376443774437844379443804438144382443834438444385443864438744388443894439044391443924439344394443954439644397443984439944400444014440244403444044440544406444074440844409444104441144412444134441444415444164441744418444194442044421444224442344424444254442644427444284442944430444314443244433444344443544436444374443844439444404444144442444434444444445444464444744448444494445044451444524445344454444554445644457444584445944460444614446244463444644446544466444674446844469444704447144472444734447444475444764447744478444794448044481444824448344484444854448644487444884448944490444914449244493444944449544496444974449844499445004450144502445034450444505445064450744508445094451044511445124451344514445154451644517445184451944520445214452244523445244452544526445274452844529445304453144532445334453444535445364453744538445394454044541445424454344544445454454644547445484454944550445514455244553445544455544556445574455844559445604456144562445634456444565445664456744568445694457044571445724457344574445754457644577445784457944580445814458244583445844458544586445874458844589445904459144592445934459444595445964459744598445994460044601446024460344604446054460644607446084460944610446114461244613446144461544616446174461844619446204462144622446234462444625446264462744628446294463044631446324463344634446354463644637446384463944640446414464244643446444464544646446474464844649446504465144652446534465444655446564465744658446594466044661446624466344664446654466644667446684466944670446714467244673446744467544676446774467844679446804468144682446834468444685446864468744688446894469044691446924469344694446954469644697446984469944700447014470244703447044470544706447074470844709447104471144712447134471444715447164471744718447194472044721447224472344724447254472644727447284472944730447314473244733447344473544736447374473844739447404474144742447434474444745447464474744748447494475044751447524475344754447554475644757447584475944760447614476244763447644476544766447674476844769447704477144772447734477444775447764477744778447794478044781447824478344784447854478644787447884478944790447914479244793447944479544796447974479844799448004480144802448034480444805448064480744808448094481044811448124481344814448154481644817448184481944820448214482244823448244482544826448274482844829448304483144832448334483444835448364483744838448394484044841448424484344844448454484644847448484484944850448514485244853448544485544856448574485844859448604486144862448634486444865448664486744868448694487044871448724487344874448754487644877448784487944880448814488244883448844488544886448874488844889448904489144892448934489444895448964489744898448994490044901449024490344904449054490644907449084490944910449114491244913449144491544916449174491844919449204492144922449234492444925449264492744928449294493044931449324493344934449354493644937449384493944940449414494244943449444494544946449474494844949449504495144952449534495444955449564495744958449594496044961449624496344964449654496644967449684496944970449714497244973449744497544976449774497844979449804498144982449834498444985449864498744988449894499044991449924499344994449954499644997449984499945000450014500245003450044500545006450074500845009450104501145012450134501445015450164501745018450194502045021450224502345024450254502645027450284502945030450314503245033450344503545036450374503845039450404504145042450434504445045450464504745048450494505045051450524505345054450554505645057450584505945060450614506245063450644506545066450674506845069450704507145072450734507445075450764507745078450794508045081450824508345084450854508645087450884508945090450914509245093450944509545096450974509845099451004510145102451034510445105451064510745108451094511045111451124511345114451154511645117451184511945120451214512245123451244512545126451274512845129451304513145132451334513445135451364513745138451394514045141451424514345144451454514645147451484514945150451514515245153451544515545156451574515845159451604516145162451634516445165451664516745168451694517045171451724517345174451754517645177451784517945180451814518245183451844518545186451874518845189451904519145192451934519445195451964519745198451994520045201452024520345204452054520645207452084520945210452114521245213452144521545216452174521845219452204522145222452234522445225452264522745228452294523045231452324523345234452354523645237452384523945240452414524245243452444524545246452474524845249452504525145252452534525445255452564525745258452594526045261452624526345264452654526645267452684526945270452714527245273452744527545276452774527845279452804528145282452834528445285452864528745288452894529045291452924529345294452954529645297452984529945300453014530245303453044530545306453074530845309453104531145312453134531445315453164531745318453194532045321453224532345324453254532645327453284532945330453314533245333453344533545336453374533845339453404534145342453434534445345453464534745348453494535045351453524535345354453554535645357453584535945360453614536245363453644536545366453674536845369453704537145372453734537445375453764537745378453794538045381453824538345384453854538645387453884538945390453914539245393453944539545396453974539845399454004540145402454034540445405454064540745408454094541045411454124541345414454154541645417454184541945420454214542245423454244542545426454274542845429454304543145432454334543445435454364543745438454394544045441454424544345444454454544645447454484544945450454514545245453454544545545456454574545845459454604546145462454634546445465454664546745468454694547045471454724547345474454754547645477454784547945480454814548245483454844548545486454874548845489454904549145492454934549445495454964549745498454994550045501455024550345504455054550645507455084550945510455114551245513455144551545516455174551845519455204552145522455234552445525455264552745528455294553045531455324553345534455354553645537455384553945540455414554245543455444554545546455474554845549455504555145552455534555445555455564555745558455594556045561455624556345564455654556645567455684556945570455714557245573455744557545576455774557845579455804558145582455834558445585455864558745588455894559045591455924559345594455954559645597455984559945600456014560245603456044560545606456074560845609456104561145612456134561445615456164561745618456194562045621456224562345624456254562645627456284562945630456314563245633456344563545636456374563845639456404564145642456434564445645456464564745648456494565045651456524565345654456554565645657456584565945660456614566245663456644566545666456674566845669456704567145672456734567445675456764567745678456794568045681456824568345684456854568645687456884568945690456914569245693456944569545696456974569845699457004570145702457034570445705457064570745708457094571045711457124571345714457154571645717457184571945720457214572245723457244572545726457274572845729457304573145732457334573445735457364573745738457394574045741457424574345744457454574645747457484574945750457514575245753457544575545756457574575845759457604576145762457634576445765457664576745768457694577045771457724577345774457754577645777457784577945780457814578245783457844578545786457874578845789457904579145792457934579445795457964579745798457994580045801458024580345804458054580645807458084580945810458114581245813458144581545816458174581845819458204582145822458234582445825458264582745828458294583045831458324583345834458354583645837458384583945840458414584245843458444584545846458474584845849458504585145852458534585445855458564585745858458594586045861458624586345864458654586645867458684586945870458714587245873458744587545876458774587845879458804588145882458834588445885458864588745888458894589045891458924589345894458954589645897458984589945900459014590245903459044590545906459074590845909459104591145912459134591445915459164591745918459194592045921459224592345924459254592645927459284592945930459314593245933459344593545936459374593845939459404594145942459434594445945459464594745948459494595045951459524595345954459554595645957459584595945960459614596245963459644596545966459674596845969459704597145972459734597445975459764597745978459794598045981459824598345984459854598645987459884598945990459914599245993459944599545996459974599845999460004600146002460034600446005460064600746008460094601046011460124601346014460154601646017460184601946020460214602246023460244602546026460274602846029460304603146032460334603446035460364603746038460394604046041460424604346044460454604646047460484604946050460514605246053460544605546056460574605846059460604606146062460634606446065460664606746068460694607046071460724607346074460754607646077460784607946080460814608246083460844608546086460874608846089460904609146092460934609446095460964609746098460994610046101461024610346104461054610646107461084610946110461114611246113461144611546116461174611846119461204612146122461234612446125461264612746128461294613046131461324613346134461354613646137461384613946140461414614246143461444614546146461474614846149461504615146152461534615446155461564615746158461594616046161461624616346164461654616646167461684616946170461714617246173461744617546176461774617846179461804618146182461834618446185461864618746188461894619046191461924619346194461954619646197461984619946200462014620246203462044620546206462074620846209462104621146212462134621446215462164621746218462194622046221462224622346224462254622646227462284622946230462314623246233462344623546236462374623846239462404624146242462434624446245462464624746248462494625046251462524625346254462554625646257462584625946260462614626246263462644626546266462674626846269462704627146272462734627446275462764627746278462794628046281462824628346284462854628646287462884628946290462914629246293462944629546296462974629846299463004630146302463034630446305463064630746308463094631046311463124631346314463154631646317463184631946320463214632246323463244632546326463274632846329463304633146332463334633446335463364633746338463394634046341463424634346344463454634646347463484634946350463514635246353463544635546356463574635846359463604636146362463634636446365463664636746368463694637046371463724637346374463754637646377463784637946380463814638246383463844638546386463874638846389463904639146392463934639446395463964639746398463994640046401464024640346404464054640646407464084640946410464114641246413464144641546416464174641846419464204642146422464234642446425464264642746428464294643046431464324643346434464354643646437464384643946440464414644246443464444644546446464474644846449464504645146452464534645446455464564645746458464594646046461464624646346464464654646646467464684646946470464714647246473464744647546476464774647846479464804648146482464834648446485464864648746488464894649046491464924649346494464954649646497464984649946500465014650246503465044650546506465074650846509465104651146512465134651446515465164651746518465194652046521465224652346524465254652646527465284652946530465314653246533465344653546536465374653846539465404654146542465434654446545465464654746548465494655046551465524655346554465554655646557465584655946560465614656246563465644656546566465674656846569465704657146572465734657446575465764657746578465794658046581465824658346584465854658646587465884658946590465914659246593465944659546596465974659846599466004660146602466034660446605466064660746608466094661046611466124661346614466154661646617466184661946620466214662246623466244662546626466274662846629466304663146632466334663446635466364663746638466394664046641466424664346644466454664646647466484664946650466514665246653466544665546656466574665846659466604666146662466634666446665466664666746668466694667046671466724667346674466754667646677466784667946680466814668246683466844668546686466874668846689466904669146692466934669446695466964669746698466994670046701467024670346704467054670646707467084670946710467114671246713467144671546716467174671846719467204672146722467234672446725467264672746728467294673046731467324673346734467354673646737467384673946740467414674246743467444674546746467474674846749467504675146752467534675446755467564675746758467594676046761467624676346764467654676646767467684676946770467714677246773467744677546776467774677846779467804678146782467834678446785467864678746788467894679046791467924679346794467954679646797467984679946800468014680246803468044680546806468074680846809468104681146812468134681446815468164681746818468194682046821468224682346824468254682646827468284682946830468314683246833468344683546836468374683846839468404684146842468434684446845468464684746848468494685046851468524685346854468554685646857468584685946860468614686246863468644686546866468674686846869468704687146872468734687446875468764687746878468794688046881468824688346884468854688646887468884688946890468914689246893468944689546896468974689846899469004690146902469034690446905469064690746908469094691046911469124691346914469154691646917469184691946920469214692246923469244692546926469274692846929469304693146932469334693446935469364693746938469394694046941469424694346944469454694646947469484694946950469514695246953469544695546956469574695846959469604696146962469634696446965469664696746968469694697046971469724697346974469754697646977469784697946980469814698246983469844698546986469874698846989469904699146992469934699446995469964699746998469994700047001470024700347004470054700647007470084700947010470114701247013470144701547016470174701847019470204702147022470234702447025470264702747028470294703047031470324703347034470354703647037470384703947040470414704247043470444704547046470474704847049470504705147052470534705447055470564705747058470594706047061470624706347064470654706647067470684706947070470714707247073470744707547076470774707847079470804708147082470834708447085470864708747088470894709047091470924709347094470954709647097470984709947100471014710247103471044710547106471074710847109471104711147112471134711447115471164711747118471194712047121471224712347124471254712647127471284712947130471314713247133471344713547136471374713847139471404714147142471434714447145471464714747148471494715047151471524715347154471554715647157471584715947160471614716247163471644716547166471674716847169471704717147172471734717447175471764717747178471794718047181471824718347184471854718647187471884718947190471914719247193471944719547196471974719847199472004720147202472034720447205472064720747208472094721047211472124721347214472154721647217472184721947220472214722247223472244722547226472274722847229472304723147232472334723447235472364723747238472394724047241472424724347244472454724647247472484724947250472514725247253472544725547256472574725847259472604726147262472634726447265472664726747268472694727047271472724727347274472754727647277472784727947280472814728247283472844728547286472874728847289472904729147292472934729447295472964729747298472994730047301473024730347304473054730647307473084730947310473114731247313473144731547316473174731847319473204732147322473234732447325473264732747328473294733047331473324733347334473354733647337473384733947340473414734247343473444734547346473474734847349473504735147352473534735447355473564735747358473594736047361473624736347364473654736647367473684736947370473714737247373473744737547376473774737847379473804738147382473834738447385473864738747388473894739047391473924739347394473954739647397473984739947400474014740247403474044740547406474074740847409474104741147412474134741447415474164741747418474194742047421474224742347424474254742647427474284742947430474314743247433474344743547436474374743847439474404744147442474434744447445474464744747448474494745047451474524745347454474554745647457474584745947460474614746247463474644746547466474674746847469474704747147472474734747447475474764747747478474794748047481474824748347484474854748647487474884748947490474914749247493474944749547496474974749847499475004750147502475034750447505475064750747508475094751047511475124751347514475154751647517475184751947520475214752247523475244752547526475274752847529475304753147532475334753447535475364753747538475394754047541475424754347544475454754647547475484754947550475514755247553475544755547556475574755847559475604756147562475634756447565475664756747568475694757047571475724757347574475754757647577475784757947580475814758247583475844758547586475874758847589475904759147592475934759447595475964759747598475994760047601476024760347604476054760647607476084760947610476114761247613476144761547616476174761847619476204762147622476234762447625476264762747628476294763047631476324763347634476354763647637476384763947640476414764247643476444764547646476474764847649476504765147652476534765447655476564765747658476594766047661476624766347664476654766647667476684766947670476714767247673476744767547676476774767847679476804768147682476834768447685476864768747688476894769047691476924769347694476954769647697476984769947700477014770247703477044770547706477074770847709477104771147712477134771447715477164771747718477194772047721477224772347724477254772647727477284772947730477314773247733477344773547736477374773847739477404774147742477434774447745477464774747748477494775047751477524775347754477554775647757477584775947760477614776247763477644776547766477674776847769477704777147772477734777447775477764777747778477794778047781477824778347784477854778647787477884778947790477914779247793477944779547796477974779847799478004780147802478034780447805478064780747808478094781047811478124781347814478154781647817478184781947820478214782247823478244782547826478274782847829478304783147832478334783447835478364783747838478394784047841478424784347844478454784647847478484784947850478514785247853478544785547856478574785847859478604786147862478634786447865478664786747868478694787047871478724787347874478754787647877478784787947880478814788247883478844788547886478874788847889478904789147892478934789447895478964789747898478994790047901479024790347904479054790647907479084790947910479114791247913479144791547916479174791847919479204792147922479234792447925479264792747928479294793047931479324793347934479354793647937479384793947940479414794247943479444794547946479474794847949479504795147952479534795447955479564795747958479594796047961479624796347964479654796647967479684796947970479714797247973479744797547976479774797847979479804798147982479834798447985479864798747988479894799047991479924799347994479954799647997479984799948000480014800248003480044800548006480074800848009480104801148012480134801448015480164801748018480194802048021480224802348024480254802648027480284802948030480314803248033480344803548036480374803848039480404804148042480434804448045480464804748048480494805048051480524805348054480554805648057480584805948060480614806248063480644806548066480674806848069480704807148072480734807448075480764807748078480794808048081480824808348084480854808648087480884808948090480914809248093480944809548096480974809848099481004810148102481034810448105481064810748108481094811048111481124811348114481154811648117481184811948120481214812248123481244812548126481274812848129481304813148132481334813448135481364813748138481394814048141481424814348144481454814648147481484814948150481514815248153481544815548156481574815848159481604816148162481634816448165481664816748168481694817048171481724817348174481754817648177481784817948180481814818248183481844818548186481874818848189481904819148192481934819448195481964819748198481994820048201482024820348204482054820648207482084820948210482114821248213482144821548216482174821848219482204822148222482234822448225482264822748228482294823048231482324823348234482354823648237482384823948240482414824248243482444824548246482474824848249482504825148252482534825448255482564825748258482594826048261482624826348264482654826648267482684826948270482714827248273482744827548276482774827848279482804828148282482834828448285482864828748288482894829048291482924829348294482954829648297482984829948300483014830248303483044830548306483074830848309483104831148312483134831448315483164831748318483194832048321483224832348324483254832648327483284832948330483314833248333483344833548336483374833848339483404834148342483434834448345483464834748348483494835048351483524835348354483554835648357483584835948360483614836248363483644836548366483674836848369483704837148372483734837448375483764837748378483794838048381483824838348384483854838648387483884838948390483914839248393483944839548396483974839848399484004840148402484034840448405484064840748408484094841048411484124841348414484154841648417484184841948420484214842248423484244842548426484274842848429484304843148432484334843448435484364843748438484394844048441484424844348444484454844648447484484844948450484514845248453484544845548456484574845848459484604846148462484634846448465484664846748468484694847048471484724847348474484754847648477484784847948480484814848248483484844848548486484874848848489484904849148492484934849448495484964849748498484994850048501485024850348504485054850648507485084850948510485114851248513485144851548516485174851848519485204852148522485234852448525485264852748528485294853048531485324853348534485354853648537485384853948540485414854248543485444854548546485474854848549485504855148552485534855448555485564855748558485594856048561485624856348564485654856648567485684856948570485714857248573485744857548576485774857848579485804858148582485834858448585485864858748588485894859048591485924859348594485954859648597485984859948600486014860248603486044860548606486074860848609486104861148612486134861448615486164861748618486194862048621486224862348624486254862648627486284862948630486314863248633486344863548636486374863848639486404864148642486434864448645486464864748648486494865048651486524865348654486554865648657486584865948660486614866248663486644866548666486674866848669486704867148672486734867448675486764867748678486794868048681486824868348684486854868648687486884868948690486914869248693486944869548696486974869848699487004870148702487034870448705487064870748708487094871048711487124871348714487154871648717487184871948720487214872248723487244872548726487274872848729487304873148732487334873448735487364873748738487394874048741487424874348744487454874648747487484874948750487514875248753487544875548756487574875848759487604876148762487634876448765487664876748768487694877048771487724877348774487754877648777487784877948780487814878248783487844878548786487874878848789487904879148792487934879448795487964879748798487994880048801488024880348804488054880648807488084880948810488114881248813488144881548816488174881848819488204882148822488234882448825488264882748828488294883048831488324883348834488354883648837488384883948840488414884248843488444884548846488474884848849488504885148852488534885448855488564885748858488594886048861488624886348864488654886648867488684886948870488714887248873488744887548876488774887848879488804888148882488834888448885488864888748888488894889048891488924889348894488954889648897488984889948900489014890248903489044890548906489074890848909489104891148912489134891448915489164891748918489194892048921489224892348924489254892648927489284892948930489314893248933489344893548936489374893848939489404894148942489434894448945489464894748948489494895048951489524895348954489554895648957489584895948960489614896248963489644896548966489674896848969489704897148972489734897448975489764897748978489794898048981489824898348984489854898648987489884898948990489914899248993489944899548996489974899848999490004900149002490034900449005490064900749008490094901049011490124901349014490154901649017490184901949020490214902249023490244902549026490274902849029490304903149032490334903449035490364903749038490394904049041490424904349044490454904649047490484904949050490514905249053490544905549056490574905849059490604906149062490634906449065490664906749068490694907049071490724907349074490754907649077490784907949080490814908249083490844908549086490874908849089490904909149092490934909449095490964909749098490994910049101491024910349104491054910649107491084910949110491114911249113491144911549116491174911849119491204912149122491234912449125491264912749128491294913049131491324913349134491354913649137491384913949140491414914249143491444914549146491474914849149491504915149152491534915449155491564915749158491594916049161491624916349164491654916649167491684916949170491714917249173491744917549176491774917849179491804918149182491834918449185491864918749188491894919049191491924919349194491954919649197491984919949200492014920249203492044920549206492074920849209492104921149212492134921449215492164921749218492194922049221492224922349224492254922649227492284922949230492314923249233492344923549236492374923849239492404924149242492434924449245492464924749248492494925049251492524925349254492554925649257492584925949260492614926249263492644926549266492674926849269492704927149272492734927449275492764927749278492794928049281492824928349284492854928649287492884928949290492914929249293492944929549296492974929849299493004930149302493034930449305493064930749308493094931049311493124931349314493154931649317493184931949320493214932249323493244932549326493274932849329493304933149332493334933449335493364933749338493394934049341493424934349344493454934649347493484934949350493514935249353493544935549356493574935849359493604936149362493634936449365493664936749368493694937049371493724937349374493754937649377493784937949380493814938249383493844938549386493874938849389493904939149392493934939449395493964939749398493994940049401494024940349404494054940649407494084940949410494114941249413494144941549416494174941849419494204942149422494234942449425494264942749428494294943049431494324943349434494354943649437494384943949440494414944249443494444944549446494474944849449494504945149452494534945449455494564945749458494594946049461494624946349464494654946649467494684946949470494714947249473494744947549476494774947849479494804948149482494834948449485494864948749488494894949049491494924949349494494954949649497494984949949500495014950249503495044950549506495074950849509495104951149512495134951449515495164951749518495194952049521495224952349524495254952649527495284952949530495314953249533495344953549536495374953849539495404954149542495434954449545495464954749548495494955049551495524955349554495554955649557495584955949560495614956249563495644956549566495674956849569495704957149572495734957449575495764957749578495794958049581495824958349584495854958649587495884958949590495914959249593495944959549596495974959849599496004960149602496034960449605496064960749608496094961049611496124961349614496154961649617496184961949620496214962249623496244962549626496274962849629496304963149632496334963449635496364963749638496394964049641496424964349644496454964649647496484964949650496514965249653496544965549656496574965849659496604966149662496634966449665496664966749668496694967049671496724967349674496754967649677496784967949680496814968249683496844968549686496874968849689496904969149692496934969449695496964969749698496994970049701497024970349704497054970649707497084970949710497114971249713497144971549716497174971849719497204972149722497234972449725497264972749728497294973049731497324973349734497354973649737497384973949740497414974249743497444974549746497474974849749497504975149752497534975449755497564975749758497594976049761497624976349764497654976649767497684976949770497714977249773497744977549776497774977849779497804978149782497834978449785497864978749788497894979049791497924979349794497954979649797497984979949800498014980249803498044980549806498074980849809498104981149812498134981449815498164981749818498194982049821498224982349824498254982649827498284982949830498314983249833498344983549836498374983849839498404984149842498434984449845498464984749848498494985049851498524985349854498554985649857498584985949860498614986249863498644986549866498674986849869498704987149872498734987449875498764987749878498794988049881498824988349884498854988649887498884988949890498914989249893498944989549896498974989849899499004990149902499034990449905499064990749908499094991049911499124991349914499154991649917499184991949920499214992249923499244992549926499274992849929499304993149932499334993449935499364993749938499394994049941499424994349944499454994649947499484994949950499514995249953499544995549956499574995849959499604996149962499634996449965499664996749968499694997049971499724997349974499754997649977499784997949980499814998249983499844998549986499874998849989499904999149992499934999449995499964999749998499995000050001500025000350004500055000650007500085000950010500115001250013500145001550016500175001850019500205002150022500235002450025500265002750028500295003050031500325003350034500355003650037500385003950040500415004250043500445004550046500475004850049500505005150052500535005450055500565005750058500595006050061500625006350064500655006650067500685006950070500715007250073500745007550076500775007850079500805008150082500835008450085500865008750088500895009050091500925009350094500955009650097500985009950100501015010250103501045010550106501075010850109501105011150112501135011450115501165011750118501195012050121501225012350124501255012650127501285012950130501315013250133501345013550136501375013850139501405014150142501435014450145501465014750148501495015050151501525015350154501555015650157501585015950160501615016250163501645016550166501675016850169501705017150172501735017450175501765017750178501795018050181501825018350184501855018650187501885018950190501915019250193501945019550196501975019850199502005020150202502035020450205502065020750208502095021050211502125021350214502155021650217502185021950220502215022250223502245022550226502275022850229502305023150232502335023450235502365023750238502395024050241502425024350244502455024650247502485024950250502515025250253502545025550256502575025850259502605026150262502635026450265502665026750268502695027050271502725027350274502755027650277502785027950280502815028250283502845028550286502875028850289502905029150292502935029450295502965029750298502995030050301503025030350304503055030650307503085030950310503115031250313503145031550316503175031850319503205032150322503235032450325503265032750328503295033050331503325033350334503355033650337503385033950340503415034250343503445034550346503475034850349503505035150352503535035450355503565035750358503595036050361503625036350364503655036650367503685036950370503715037250373503745037550376503775037850379503805038150382503835038450385503865038750388503895039050391503925039350394503955039650397503985039950400504015040250403504045040550406504075040850409504105041150412504135041450415504165041750418504195042050421504225042350424504255042650427504285042950430504315043250433504345043550436504375043850439504405044150442504435044450445504465044750448504495045050451504525045350454504555045650457504585045950460504615046250463504645046550466504675046850469504705047150472504735047450475504765047750478504795048050481504825048350484504855048650487504885048950490504915049250493504945049550496504975049850499505005050150502505035050450505505065050750508505095051050511505125051350514505155051650517505185051950520505215052250523505245052550526505275052850529505305053150532505335053450535505365053750538505395054050541505425054350544505455054650547505485054950550505515055250553505545055550556505575055850559505605056150562505635056450565505665056750568505695057050571505725057350574505755057650577505785057950580505815058250583505845058550586505875058850589505905059150592505935059450595505965059750598505995060050601506025060350604506055060650607506085060950610506115061250613506145061550616506175061850619506205062150622506235062450625506265062750628506295063050631506325063350634506355063650637506385063950640506415064250643506445064550646506475064850649506505065150652506535065450655506565065750658506595066050661506625066350664506655066650667506685066950670506715067250673506745067550676506775067850679506805068150682506835068450685506865068750688506895069050691506925069350694506955069650697506985069950700507015070250703507045070550706507075070850709507105071150712507135071450715507165071750718507195072050721507225072350724507255072650727507285072950730507315073250733507345073550736507375073850739507405074150742507435074450745507465074750748507495075050751507525075350754507555075650757507585075950760507615076250763507645076550766507675076850769507705077150772507735077450775507765077750778507795078050781507825078350784507855078650787507885078950790507915079250793507945079550796507975079850799508005080150802508035080450805508065080750808508095081050811508125081350814508155081650817508185081950820508215082250823508245082550826508275082850829508305083150832508335083450835508365083750838508395084050841508425084350844508455084650847508485084950850508515085250853508545085550856508575085850859508605086150862508635086450865508665086750868508695087050871508725087350874508755087650877508785087950880508815088250883508845088550886508875088850889508905089150892508935089450895508965089750898508995090050901509025090350904509055090650907509085090950910509115091250913509145091550916509175091850919509205092150922509235092450925509265092750928509295093050931509325093350934509355093650937509385093950940509415094250943509445094550946509475094850949509505095150952509535095450955509565095750958509595096050961509625096350964509655096650967509685096950970509715097250973509745097550976509775097850979509805098150982509835098450985509865098750988509895099050991509925099350994509955099650997509985099951000510015100251003510045100551006510075100851009510105101151012510135101451015510165101751018510195102051021510225102351024510255102651027510285102951030510315103251033510345103551036510375103851039510405104151042510435104451045510465104751048510495105051051510525105351054510555105651057510585105951060510615106251063510645106551066510675106851069510705107151072510735107451075510765107751078510795108051081510825108351084510855108651087510885108951090510915109251093510945109551096510975109851099511005110151102511035110451105511065110751108511095111051111511125111351114511155111651117511185111951120511215112251123511245112551126511275112851129511305113151132511335113451135511365113751138511395114051141511425114351144511455114651147511485114951150511515115251153511545115551156511575115851159511605116151162511635116451165511665116751168511695117051171511725117351174511755117651177511785117951180511815118251183511845118551186511875118851189511905119151192511935119451195511965119751198511995120051201512025120351204512055120651207512085120951210512115121251213512145121551216512175121851219512205122151222512235122451225512265122751228512295123051231512325123351234512355123651237512385123951240512415124251243512445124551246512475124851249512505125151252512535125451255512565125751258512595126051261512625126351264512655126651267512685126951270512715127251273512745127551276512775127851279512805128151282512835128451285512865128751288512895129051291512925129351294512955129651297512985129951300513015130251303513045130551306513075130851309513105131151312513135131451315513165131751318513195132051321513225132351324513255132651327513285132951330513315133251333513345133551336513375133851339513405134151342513435134451345513465134751348513495135051351513525135351354513555135651357513585135951360513615136251363513645136551366513675136851369513705137151372513735137451375513765137751378513795138051381513825138351384513855138651387513885138951390513915139251393513945139551396513975139851399514005140151402514035140451405514065140751408514095141051411514125141351414514155141651417514185141951420514215142251423514245142551426514275142851429514305143151432514335143451435514365143751438514395144051441514425144351444514455144651447514485144951450514515145251453514545145551456514575145851459514605146151462514635146451465514665146751468514695147051471514725147351474514755147651477514785147951480514815148251483514845148551486514875148851489514905149151492514935149451495514965149751498514995150051501515025150351504515055150651507515085150951510515115151251513515145151551516515175151851519515205152151522515235152451525515265152751528515295153051531515325153351534515355153651537515385153951540515415154251543515445154551546515475154851549515505155151552515535155451555515565155751558515595156051561515625156351564515655156651567515685156951570515715157251573515745157551576515775157851579515805158151582515835158451585515865158751588515895159051591515925159351594515955159651597515985159951600516015160251603516045160551606516075160851609516105161151612516135161451615516165161751618516195162051621516225162351624516255162651627516285162951630516315163251633516345163551636516375163851639516405164151642516435164451645516465164751648516495165051651516525165351654516555165651657516585165951660516615166251663516645166551666516675166851669516705167151672516735167451675516765167751678516795168051681516825168351684516855168651687516885168951690516915169251693516945169551696516975169851699517005170151702517035170451705517065170751708517095171051711517125171351714517155171651717517185171951720517215172251723517245172551726517275172851729517305173151732517335173451735517365173751738517395174051741517425174351744517455174651747517485174951750517515175251753517545175551756517575175851759517605176151762517635176451765517665176751768517695177051771517725177351774517755177651777517785177951780517815178251783517845178551786517875178851789517905179151792517935179451795517965179751798517995180051801518025180351804518055180651807518085180951810518115181251813518145181551816518175181851819518205182151822518235182451825518265182751828518295183051831518325183351834518355183651837518385183951840518415184251843518445184551846518475184851849518505185151852518535185451855518565185751858518595186051861518625186351864518655186651867518685186951870518715187251873518745187551876518775187851879518805188151882518835188451885518865188751888518895189051891518925189351894518955189651897518985189951900519015190251903519045190551906519075190851909519105191151912519135191451915519165191751918519195192051921519225192351924519255192651927519285192951930519315193251933519345193551936519375193851939519405194151942519435194451945519465194751948519495195051951519525195351954519555195651957519585195951960519615196251963519645196551966519675196851969519705197151972519735197451975519765197751978519795198051981519825198351984519855198651987519885198951990519915199251993519945199551996519975199851999520005200152002520035200452005520065200752008520095201052011520125201352014520155201652017520185201952020520215202252023520245202552026520275202852029520305203152032520335203452035520365203752038520395204052041520425204352044520455204652047520485204952050520515205252053520545205552056520575205852059520605206152062520635206452065520665206752068520695207052071520725207352074520755207652077520785207952080520815208252083520845208552086520875208852089520905209152092520935209452095520965209752098520995210052101521025210352104521055210652107521085210952110521115211252113521145211552116521175211852119521205212152122521235212452125521265212752128521295213052131521325213352134521355213652137521385213952140521415214252143521445214552146521475214852149521505215152152521535215452155521565215752158521595216052161521625216352164521655216652167521685216952170521715217252173521745217552176521775217852179521805218152182521835218452185521865218752188521895219052191521925219352194521955219652197521985219952200522015220252203522045220552206522075220852209522105221152212522135221452215522165221752218522195222052221522225222352224522255222652227522285222952230522315223252233522345223552236522375223852239522405224152242522435224452245522465224752248522495225052251522525225352254522555225652257522585225952260522615226252263522645226552266522675226852269522705227152272522735227452275522765227752278522795228052281522825228352284522855228652287522885228952290522915229252293522945229552296522975229852299523005230152302523035230452305523065230752308523095231052311523125231352314523155231652317523185231952320523215232252323523245232552326523275232852329523305233152332523335233452335523365233752338523395234052341523425234352344523455234652347523485234952350523515235252353523545235552356523575235852359523605236152362523635236452365523665236752368523695237052371523725237352374523755237652377523785237952380523815238252383523845238552386523875238852389523905239152392523935239452395523965239752398523995240052401524025240352404524055240652407524085240952410524115241252413524145241552416524175241852419524205242152422524235242452425524265242752428524295243052431524325243352434524355243652437524385243952440524415244252443524445244552446524475244852449524505245152452524535245452455524565245752458524595246052461524625246352464524655246652467524685246952470524715247252473524745247552476524775247852479524805248152482524835248452485524865248752488524895249052491524925249352494524955249652497524985249952500525015250252503525045250552506525075250852509525105251152512525135251452515525165251752518525195252052521525225252352524525255252652527525285252952530525315253252533525345253552536525375253852539525405254152542525435254452545525465254752548525495255052551525525255352554525555255652557525585255952560525615256252563525645256552566525675256852569525705257152572525735257452575525765257752578525795258052581525825258352584525855258652587525885258952590525915259252593525945259552596525975259852599526005260152602526035260452605526065260752608526095261052611526125261352614526155261652617526185261952620526215262252623526245262552626526275262852629526305263152632526335263452635526365263752638526395264052641526425264352644526455264652647526485264952650526515265252653526545265552656526575265852659526605266152662526635266452665526665266752668526695267052671526725267352674526755267652677526785267952680526815268252683526845268552686526875268852689526905269152692526935269452695526965269752698526995270052701527025270352704527055270652707527085270952710527115271252713527145271552716527175271852719527205272152722527235272452725527265272752728527295273052731527325273352734527355273652737527385273952740527415274252743527445274552746527475274852749527505275152752527535275452755527565275752758527595276052761527625276352764527655276652767527685276952770527715277252773527745277552776527775277852779527805278152782527835278452785527865278752788527895279052791527925279352794527955279652797527985279952800528015280252803528045280552806528075280852809528105281152812528135281452815528165281752818528195282052821528225282352824528255282652827528285282952830528315283252833528345283552836528375283852839528405284152842528435284452845528465284752848528495285052851528525285352854528555285652857528585285952860528615286252863528645286552866528675286852869528705287152872528735287452875528765287752878528795288052881528825288352884528855288652887528885288952890528915289252893528945289552896528975289852899529005290152902529035290452905529065290752908529095291052911529125291352914529155291652917529185291952920529215292252923529245292552926529275292852929529305293152932529335293452935529365293752938529395294052941529425294352944529455294652947529485294952950529515295252953529545295552956529575295852959529605296152962529635296452965529665296752968529695297052971529725297352974529755297652977529785297952980529815298252983529845298552986529875298852989529905299152992529935299452995529965299752998529995300053001530025300353004530055300653007530085300953010530115301253013530145301553016530175301853019530205302153022530235302453025530265302753028530295303053031530325303353034530355303653037530385303953040530415304253043530445304553046530475304853049530505305153052530535305453055530565305753058530595306053061530625306353064530655306653067530685306953070530715307253073530745307553076530775307853079530805308153082530835308453085530865308753088530895309053091530925309353094530955309653097530985309953100531015310253103531045310553106531075310853109531105311153112531135311453115531165311753118531195312053121531225312353124531255312653127531285312953130531315313253133531345313553136531375313853139531405314153142531435314453145531465314753148531495315053151531525315353154531555315653157531585315953160531615316253163531645316553166531675316853169531705317153172531735317453175531765317753178531795318053181531825318353184531855318653187531885318953190531915319253193531945319553196531975319853199532005320153202532035320453205532065320753208532095321053211532125321353214532155321653217532185321953220532215322253223532245322553226532275322853229532305323153232532335323453235532365323753238532395324053241532425324353244532455324653247532485324953250532515325253253532545325553256532575325853259532605326153262532635326453265532665326753268532695327053271532725327353274532755327653277532785327953280532815328253283532845328553286532875328853289532905329153292532935329453295532965329753298532995330053301533025330353304533055330653307533085330953310533115331253313533145331553316533175331853319533205332153322533235332453325533265332753328533295333053331533325333353334533355333653337533385333953340533415334253343533445334553346533475334853349533505335153352533535335453355533565335753358533595336053361533625336353364533655336653367533685336953370533715337253373533745337553376533775337853379533805338153382533835338453385533865338753388533895339053391533925339353394533955339653397533985339953400534015340253403534045340553406534075340853409534105341153412534135341453415534165341753418534195342053421534225342353424534255342653427534285342953430534315343253433534345343553436534375343853439534405344153442534435344453445534465344753448534495345053451534525345353454534555345653457534585345953460534615346253463534645346553466534675346853469534705347153472534735347453475534765347753478534795348053481534825348353484534855348653487534885348953490534915349253493534945349553496534975349853499535005350153502535035350453505535065350753508535095351053511535125351353514535155351653517535185351953520535215352253523535245352553526535275352853529535305353153532535335353453535535365353753538535395354053541535425354353544535455354653547535485354953550535515355253553535545355553556535575355853559535605356153562535635356453565535665356753568535695357053571535725357353574535755357653577535785357953580535815358253583535845358553586535875358853589535905359153592535935359453595535965359753598535995360053601536025360353604536055360653607536085360953610536115361253613536145361553616536175361853619536205362153622536235362453625536265362753628536295363053631536325363353634536355363653637536385363953640536415364253643536445364553646536475364853649536505365153652536535365453655536565365753658536595366053661536625366353664536655366653667536685366953670536715367253673536745367553676536775367853679536805368153682536835368453685536865368753688536895369053691536925369353694536955369653697536985369953700537015370253703537045370553706537075370853709537105371153712537135371453715537165371753718537195372053721537225372353724537255372653727537285372953730537315373253733537345373553736537375373853739537405374153742537435374453745537465374753748537495375053751537525375353754537555375653757537585375953760537615376253763537645376553766537675376853769537705377153772537735377453775537765377753778537795378053781537825378353784537855378653787537885378953790537915379253793537945379553796537975379853799538005380153802538035380453805538065380753808538095381053811538125381353814538155381653817538185381953820538215382253823538245382553826538275382853829538305383153832538335383453835538365383753838538395384053841538425384353844538455384653847538485384953850538515385253853538545385553856538575385853859538605386153862538635386453865538665386753868538695387053871538725387353874538755387653877538785387953880538815388253883538845388553886538875388853889538905389153892538935389453895538965389753898538995390053901539025390353904539055390653907539085390953910539115391253913539145391553916539175391853919539205392153922539235392453925539265392753928539295393053931539325393353934539355393653937539385393953940539415394253943539445394553946539475394853949539505395153952539535395453955539565395753958539595396053961539625396353964539655396653967539685396953970539715397253973539745397553976539775397853979539805398153982539835398453985539865398753988539895399053991539925399353994539955399653997539985399954000540015400254003540045400554006540075400854009540105401154012540135401454015540165401754018540195402054021540225402354024540255402654027540285402954030540315403254033540345403554036540375403854039540405404154042540435404454045540465404754048540495405054051540525405354054540555405654057540585405954060540615406254063540645406554066540675406854069540705407154072540735407454075540765407754078540795408054081540825408354084540855408654087540885408954090540915409254093540945409554096540975409854099541005410154102541035410454105541065410754108541095411054111541125411354114541155411654117541185411954120541215412254123541245412554126541275412854129541305413154132541335413454135541365413754138541395414054141541425414354144541455414654147541485414954150541515415254153541545415554156541575415854159541605416154162541635416454165541665416754168541695417054171541725417354174541755417654177541785417954180541815418254183541845418554186541875418854189541905419154192541935419454195541965419754198541995420054201542025420354204542055420654207542085420954210542115421254213542145421554216542175421854219542205422154222542235422454225542265422754228542295423054231542325423354234542355423654237542385423954240542415424254243542445424554246542475424854249542505425154252542535425454255542565425754258542595426054261542625426354264542655426654267542685426954270542715427254273542745427554276542775427854279542805428154282542835428454285542865428754288542895429054291542925429354294542955429654297542985429954300543015430254303543045430554306543075430854309543105431154312543135431454315543165431754318543195432054321543225432354324543255432654327543285432954330543315433254333543345433554336543375433854339543405434154342543435434454345543465434754348543495435054351543525435354354543555435654357543585435954360543615436254363543645436554366543675436854369543705437154372543735437454375543765437754378543795438054381543825438354384543855438654387543885438954390543915439254393543945439554396543975439854399544005440154402544035440454405544065440754408544095441054411544125441354414544155441654417544185441954420544215442254423544245442554426544275442854429544305443154432544335443454435544365443754438544395444054441544425444354444544455444654447544485444954450544515445254453544545445554456544575445854459544605446154462544635446454465544665446754468544695447054471544725447354474544755447654477544785447954480544815448254483544845448554486544875448854489544905449154492544935449454495544965449754498544995450054501545025450354504545055450654507545085450954510545115451254513545145451554516545175451854519545205452154522545235452454525545265452754528545295453054531545325453354534545355453654537545385453954540545415454254543545445454554546545475454854549545505455154552545535455454555545565455754558545595456054561545625456354564545655456654567545685456954570545715457254573545745457554576545775457854579545805458154582545835458454585545865458754588545895459054591545925459354594545955459654597545985459954600546015460254603546045460554606546075460854609546105461154612546135461454615546165461754618546195462054621546225462354624546255462654627546285462954630546315463254633546345463554636546375463854639546405464154642546435464454645546465464754648546495465054651546525465354654546555465654657546585465954660546615466254663546645466554666546675466854669546705467154672546735467454675546765467754678546795468054681546825468354684546855468654687546885468954690546915469254693546945469554696546975469854699547005470154702547035470454705547065470754708547095471054711547125471354714547155471654717547185471954720547215472254723547245472554726547275472854729547305473154732547335473454735547365473754738547395474054741547425474354744547455474654747547485474954750547515475254753547545475554756547575475854759547605476154762547635476454765547665476754768547695477054771547725477354774547755477654777547785477954780547815478254783547845478554786547875478854789547905479154792547935479454795547965479754798547995480054801548025480354804548055480654807548085480954810548115481254813548145481554816548175481854819548205482154822548235482454825548265482754828548295483054831548325483354834548355483654837548385483954840548415484254843548445484554846548475484854849548505485154852548535485454855548565485754858548595486054861548625486354864548655486654867548685486954870548715487254873548745487554876548775487854879548805488154882548835488454885548865488754888548895489054891548925489354894548955489654897548985489954900549015490254903549045490554906549075490854909549105491154912549135491454915549165491754918549195492054921549225492354924549255492654927549285492954930549315493254933549345493554936549375493854939549405494154942549435494454945549465494754948549495495054951549525495354954549555495654957549585495954960549615496254963549645496554966549675496854969549705497154972549735497454975549765497754978549795498054981549825498354984549855498654987549885498954990549915499254993549945499554996549975499854999550005500155002550035500455005550065500755008550095501055011550125501355014550155501655017550185501955020550215502255023550245502555026550275502855029550305503155032550335503455035550365503755038550395504055041550425504355044550455504655047550485504955050550515505255053550545505555056550575505855059550605506155062550635506455065550665506755068550695507055071550725507355074550755507655077550785507955080550815508255083550845508555086550875508855089550905509155092550935509455095550965509755098550995510055101551025510355104551055510655107551085510955110551115511255113551145511555116551175511855119551205512155122551235512455125551265512755128551295513055131551325513355134551355513655137551385513955140551415514255143551445514555146551475514855149551505515155152551535515455155551565515755158551595516055161551625516355164551655516655167551685516955170551715517255173551745517555176551775517855179551805518155182551835518455185551865518755188551895519055191551925519355194551955519655197551985519955200552015520255203552045520555206552075520855209552105521155212552135521455215552165521755218552195522055221552225522355224552255522655227552285522955230552315523255233552345523555236552375523855239552405524155242552435524455245552465524755248552495525055251552525525355254552555525655257552585525955260552615526255263552645526555266552675526855269552705527155272552735527455275552765527755278552795528055281552825528355284552855528655287552885528955290552915529255293552945529555296552975529855299553005530155302553035530455305553065530755308553095531055311553125531355314553155531655317553185531955320553215532255323553245532555326553275532855329553305533155332553335533455335553365533755338553395534055341553425534355344553455534655347553485534955350553515535255353553545535555356553575535855359553605536155362553635536455365553665536755368553695537055371553725537355374553755537655377553785537955380553815538255383553845538555386553875538855389553905539155392553935539455395553965539755398553995540055401554025540355404554055540655407554085540955410554115541255413554145541555416554175541855419554205542155422554235542455425554265542755428554295543055431554325543355434554355543655437554385543955440554415544255443554445544555446554475544855449554505545155452554535545455455554565545755458554595546055461554625546355464554655546655467554685546955470554715547255473554745547555476554775547855479554805548155482554835548455485554865548755488554895549055491554925549355494554955549655497554985549955500555015550255503555045550555506555075550855509555105551155512555135551455515555165551755518555195552055521555225552355524555255552655527555285552955530555315553255533555345553555536555375553855539555405554155542555435554455545555465554755548555495555055551555525555355554555555555655557555585555955560555615556255563555645556555566555675556855569555705557155572555735557455575555765557755578555795558055581555825558355584555855558655587555885558955590555915559255593555945559555596555975559855599556005560155602556035560455605556065560755608556095561055611556125561355614556155561655617556185561955620556215562255623556245562555626556275562855629556305563155632556335563455635556365563755638556395564055641556425564355644556455564655647556485564955650556515565255653556545565555656556575565855659556605566155662556635566455665556665566755668556695567055671556725567355674556755567655677556785567955680556815568255683556845568555686556875568855689556905569155692556935569455695556965569755698556995570055701557025570355704557055570655707557085570955710557115571255713557145571555716557175571855719557205572155722557235572455725557265572755728557295573055731557325573355734557355573655737557385573955740557415574255743557445574555746557475574855749557505575155752557535575455755557565575755758557595576055761557625576355764557655576655767557685576955770557715577255773557745577555776557775577855779557805578155782557835578455785557865578755788557895579055791557925579355794557955579655797557985579955800558015580255803558045580555806558075580855809558105581155812558135581455815558165581755818558195582055821558225582355824558255582655827558285582955830558315583255833558345583555836558375583855839558405584155842558435584455845558465584755848558495585055851558525585355854558555585655857558585585955860558615586255863558645586555866558675586855869558705587155872558735587455875558765587755878558795588055881558825588355884558855588655887558885588955890558915589255893558945589555896558975589855899559005590155902559035590455905559065590755908559095591055911559125591355914559155591655917559185591955920559215592255923559245592555926559275592855929559305593155932559335593455935559365593755938559395594055941559425594355944559455594655947559485594955950559515595255953559545595555956559575595855959559605596155962559635596455965559665596755968559695597055971559725597355974559755597655977559785597955980559815598255983559845598555986559875598855989559905599155992559935599455995559965599755998559995600056001560025600356004560055600656007560085600956010560115601256013560145601556016560175601856019560205602156022560235602456025560265602756028560295603056031560325603356034560355603656037560385603956040560415604256043560445604556046560475604856049560505605156052560535605456055560565605756058560595606056061560625606356064560655606656067560685606956070560715607256073560745607556076560775607856079560805608156082560835608456085560865608756088560895609056091560925609356094560955609656097560985609956100561015610256103561045610556106561075610856109561105611156112561135611456115561165611756118561195612056121561225612356124561255612656127561285612956130561315613256133561345613556136561375613856139561405614156142561435614456145561465614756148561495615056151561525615356154561555615656157561585615956160561615616256163561645616556166561675616856169561705617156172561735617456175561765617756178561795618056181561825618356184561855618656187561885618956190561915619256193561945619556196561975619856199562005620156202562035620456205562065620756208562095621056211562125621356214562155621656217562185621956220562215622256223562245622556226562275622856229562305623156232562335623456235562365623756238562395624056241562425624356244562455624656247562485624956250562515625256253562545625556256562575625856259562605626156262562635626456265562665626756268562695627056271562725627356274562755627656277562785627956280562815628256283562845628556286562875628856289562905629156292562935629456295562965629756298562995630056301563025630356304563055630656307563085630956310563115631256313563145631556316563175631856319563205632156322563235632456325563265632756328563295633056331563325633356334563355633656337563385633956340563415634256343563445634556346563475634856349563505635156352563535635456355563565635756358563595636056361563625636356364563655636656367563685636956370563715637256373563745637556376563775637856379563805638156382563835638456385563865638756388563895639056391563925639356394563955639656397563985639956400564015640256403564045640556406564075640856409564105641156412564135641456415564165641756418564195642056421564225642356424564255642656427564285642956430564315643256433564345643556436564375643856439564405644156442564435644456445564465644756448564495645056451564525645356454564555645656457564585645956460564615646256463564645646556466564675646856469564705647156472564735647456475564765647756478564795648056481564825648356484564855648656487564885648956490564915649256493564945649556496564975649856499565005650156502565035650456505565065650756508565095651056511565125651356514565155651656517565185651956520565215652256523565245652556526565275652856529565305653156532565335653456535565365653756538565395654056541565425654356544565455654656547565485654956550565515655256553565545655556556565575655856559565605656156562565635656456565565665656756568565695657056571565725657356574565755657656577565785657956580565815658256583565845658556586565875658856589565905659156592565935659456595565965659756598565995660056601566025660356604566055660656607566085660956610566115661256613566145661556616566175661856619566205662156622566235662456625566265662756628566295663056631566325663356634566355663656637566385663956640566415664256643566445664556646566475664856649566505665156652566535665456655566565665756658566595666056661566625666356664566655666656667566685666956670566715667256673566745667556676566775667856679566805668156682566835668456685566865668756688566895669056691566925669356694566955669656697566985669956700567015670256703567045670556706567075670856709567105671156712567135671456715567165671756718567195672056721567225672356724567255672656727567285672956730567315673256733567345673556736567375673856739567405674156742567435674456745567465674756748567495675056751567525675356754567555675656757567585675956760567615676256763567645676556766567675676856769567705677156772567735677456775567765677756778567795678056781567825678356784567855678656787567885678956790567915679256793567945679556796567975679856799568005680156802568035680456805568065680756808568095681056811568125681356814568155681656817568185681956820568215682256823568245682556826568275682856829568305683156832568335683456835568365683756838568395684056841568425684356844568455684656847568485684956850568515685256853568545685556856568575685856859568605686156862568635686456865568665686756868568695687056871568725687356874568755687656877568785687956880568815688256883568845688556886568875688856889568905689156892568935689456895568965689756898568995690056901569025690356904569055690656907569085690956910569115691256913569145691556916569175691856919569205692156922569235692456925569265692756928569295693056931569325693356934569355693656937569385693956940569415694256943569445694556946569475694856949569505695156952569535695456955569565695756958569595696056961569625696356964569655696656967569685696956970569715697256973569745697556976569775697856979569805698156982569835698456985569865698756988569895699056991569925699356994569955699656997569985699957000570015700257003570045700557006570075700857009570105701157012570135701457015570165701757018570195702057021570225702357024570255702657027570285702957030570315703257033570345703557036570375703857039570405704157042570435704457045570465704757048570495705057051570525705357054570555705657057570585705957060570615706257063570645706557066570675706857069570705707157072570735707457075570765707757078570795708057081570825708357084570855708657087570885708957090570915709257093570945709557096570975709857099571005710157102571035710457105571065710757108571095711057111571125711357114571155711657117571185711957120571215712257123571245712557126571275712857129571305713157132571335713457135571365713757138571395714057141571425714357144571455714657147571485714957150571515715257153571545715557156571575715857159571605716157162571635716457165571665716757168571695717057171571725717357174571755717657177571785717957180571815718257183571845718557186571875718857189571905719157192571935719457195571965719757198571995720057201572025720357204572055720657207572085720957210572115721257213572145721557216572175721857219572205722157222572235722457225572265722757228572295723057231572325723357234572355723657237572385723957240572415724257243572445724557246572475724857249572505725157252572535725457255572565725757258572595726057261572625726357264572655726657267572685726957270572715727257273572745727557276572775727857279572805728157282572835728457285572865728757288572895729057291572925729357294572955729657297572985729957300573015730257303573045730557306573075730857309573105731157312573135731457315573165731757318573195732057321573225732357324573255732657327573285732957330573315733257333573345733557336573375733857339573405734157342573435734457345573465734757348573495735057351573525735357354573555735657357573585735957360573615736257363573645736557366573675736857369573705737157372573735737457375573765737757378573795738057381573825738357384573855738657387573885738957390573915739257393573945739557396573975739857399574005740157402574035740457405574065740757408574095741057411574125741357414574155741657417574185741957420574215742257423574245742557426574275742857429574305743157432574335743457435574365743757438574395744057441574425744357444574455744657447574485744957450574515745257453574545745557456574575745857459574605746157462574635746457465574665746757468574695747057471574725747357474574755747657477574785747957480574815748257483574845748557486574875748857489574905749157492574935749457495574965749757498574995750057501575025750357504575055750657507575085750957510575115751257513575145751557516575175751857519575205752157522575235752457525575265752757528575295753057531575325753357534575355753657537575385753957540575415754257543575445754557546575475754857549575505755157552575535755457555575565755757558575595756057561575625756357564575655756657567575685756957570575715757257573575745757557576575775757857579575805758157582575835758457585575865758757588575895759057591575925759357594575955759657597575985759957600576015760257603576045760557606576075760857609576105761157612576135761457615576165761757618576195762057621576225762357624576255762657627576285762957630576315763257633576345763557636576375763857639576405764157642576435764457645576465764757648576495765057651576525765357654576555765657657576585765957660576615766257663576645766557666576675766857669576705767157672576735767457675576765767757678576795768057681576825768357684576855768657687576885768957690576915769257693576945769557696576975769857699577005770157702577035770457705577065770757708577095771057711577125771357714577155771657717577185771957720577215772257723577245772557726577275772857729577305773157732577335773457735577365773757738577395774057741577425774357744577455774657747577485774957750577515775257753577545775557756577575775857759577605776157762577635776457765577665776757768577695777057771577725777357774577755777657777577785777957780577815778257783577845778557786577875778857789577905779157792577935779457795577965779757798577995780057801578025780357804578055780657807578085780957810578115781257813578145781557816578175781857819578205782157822578235782457825578265782757828578295783057831578325783357834578355783657837578385783957840578415784257843578445784557846578475784857849578505785157852578535785457855578565785757858578595786057861578625786357864578655786657867578685786957870578715787257873578745787557876578775787857879578805788157882578835788457885578865788757888578895789057891578925789357894578955789657897578985789957900579015790257903579045790557906579075790857909579105791157912579135791457915579165791757918579195792057921579225792357924579255792657927579285792957930579315793257933579345793557936579375793857939579405794157942579435794457945579465794757948579495795057951579525795357954579555795657957579585795957960579615796257963579645796557966579675796857969579705797157972579735797457975579765797757978579795798057981579825798357984579855798657987579885798957990579915799257993579945799557996579975799857999580005800158002580035800458005580065800758008580095801058011580125801358014580155801658017580185801958020580215802258023580245802558026580275802858029580305803158032580335803458035580365803758038580395804058041580425804358044580455804658047580485804958050580515805258053580545805558056580575805858059580605806158062580635806458065580665806758068580695807058071580725807358074580755807658077580785807958080580815808258083580845808558086580875808858089580905809158092580935809458095580965809758098580995810058101581025810358104581055810658107581085810958110581115811258113581145811558116581175811858119581205812158122581235812458125581265812758128581295813058131581325813358134581355813658137581385813958140581415814258143581445814558146581475814858149581505815158152581535815458155581565815758158581595816058161581625816358164581655816658167581685816958170581715817258173581745817558176581775817858179581805818158182581835818458185581865818758188581895819058191581925819358194581955819658197581985819958200582015820258203582045820558206582075820858209582105821158212582135821458215582165821758218582195822058221582225822358224582255822658227582285822958230582315823258233582345823558236582375823858239582405824158242582435824458245582465824758248582495825058251582525825358254582555825658257582585825958260582615826258263582645826558266582675826858269582705827158272582735827458275582765827758278582795828058281582825828358284582855828658287582885828958290582915829258293582945829558296582975829858299583005830158302583035830458305583065830758308583095831058311583125831358314583155831658317583185831958320583215832258323583245832558326583275832858329583305833158332583335833458335583365833758338583395834058341583425834358344583455834658347583485834958350583515835258353583545835558356583575835858359583605836158362583635836458365583665836758368583695837058371583725837358374583755837658377583785837958380583815838258383583845838558386583875838858389583905839158392583935839458395583965839758398583995840058401584025840358404584055840658407584085840958410584115841258413584145841558416584175841858419584205842158422584235842458425584265842758428584295843058431584325843358434584355843658437584385843958440584415844258443584445844558446584475844858449584505845158452584535845458455584565845758458584595846058461584625846358464584655846658467584685846958470584715847258473584745847558476584775847858479584805848158482584835848458485584865848758488584895849058491584925849358494584955849658497584985849958500585015850258503585045850558506585075850858509585105851158512585135851458515585165851758518585195852058521585225852358524585255852658527585285852958530585315853258533585345853558536585375853858539585405854158542585435854458545585465854758548585495855058551585525855358554585555855658557585585855958560585615856258563585645856558566585675856858569585705857158572585735857458575585765857758578585795858058581585825858358584585855858658587585885858958590585915859258593585945859558596585975859858599586005860158602586035860458605586065860758608586095861058611586125861358614586155861658617586185861958620586215862258623586245862558626586275862858629586305863158632586335863458635586365863758638586395864058641586425864358644586455864658647586485864958650586515865258653586545865558656586575865858659586605866158662586635866458665586665866758668586695867058671586725867358674586755867658677586785867958680586815868258683586845868558686586875868858689586905869158692586935869458695586965869758698586995870058701587025870358704587055870658707587085870958710587115871258713587145871558716587175871858719587205872158722587235872458725587265872758728587295873058731587325873358734587355873658737587385873958740587415874258743587445874558746587475874858749587505875158752587535875458755587565875758758587595876058761587625876358764587655876658767587685876958770587715877258773587745877558776587775877858779587805878158782587835878458785587865878758788587895879058791587925879358794587955879658797587985879958800588015880258803588045880558806588075880858809588105881158812588135881458815588165881758818588195882058821588225882358824588255882658827588285882958830588315883258833588345883558836588375883858839588405884158842588435884458845588465884758848588495885058851588525885358854588555885658857588585885958860588615886258863588645886558866588675886858869588705887158872588735887458875588765887758878588795888058881588825888358884588855888658887588885888958890588915889258893588945889558896588975889858899589005890158902589035890458905589065890758908589095891058911589125891358914589155891658917589185891958920589215892258923589245892558926589275892858929589305893158932589335893458935589365893758938589395894058941589425894358944589455894658947589485894958950589515895258953589545895558956589575895858959589605896158962589635896458965589665896758968589695897058971589725897358974589755897658977589785897958980589815898258983589845898558986589875898858989589905899158992589935899458995589965899758998589995900059001590025900359004590055900659007590085900959010590115901259013590145901559016590175901859019590205902159022590235902459025590265902759028590295903059031590325903359034590355903659037590385903959040590415904259043590445904559046590475904859049590505905159052590535905459055590565905759058590595906059061590625906359064590655906659067590685906959070590715907259073590745907559076590775907859079590805908159082590835908459085590865908759088590895909059091590925909359094590955909659097590985909959100591015910259103591045910559106591075910859109591105911159112591135911459115591165911759118591195912059121591225912359124591255912659127591285912959130591315913259133591345913559136591375913859139591405914159142591435914459145591465914759148591495915059151591525915359154591555915659157591585915959160591615916259163591645916559166591675916859169591705917159172591735917459175591765917759178591795918059181591825918359184591855918659187591885918959190591915919259193591945919559196591975919859199592005920159202592035920459205592065920759208592095921059211592125921359214592155921659217592185921959220592215922259223592245922559226592275922859229592305923159232592335923459235592365923759238592395924059241592425924359244592455924659247592485924959250592515925259253592545925559256592575925859259592605926159262592635926459265592665926759268592695927059271592725927359274592755927659277592785927959280592815928259283592845928559286592875928859289592905929159292592935929459295592965929759298592995930059301593025930359304593055930659307593085930959310593115931259313593145931559316593175931859319593205932159322593235932459325593265932759328593295933059331593325933359334593355933659337593385933959340593415934259343593445934559346593475934859349593505935159352593535935459355593565935759358593595936059361593625936359364593655936659367593685936959370593715937259373593745937559376593775937859379593805938159382593835938459385593865938759388593895939059391593925939359394593955939659397593985939959400594015940259403594045940559406594075940859409594105941159412594135941459415594165941759418594195942059421594225942359424594255942659427594285942959430594315943259433594345943559436594375943859439594405944159442594435944459445594465944759448594495945059451594525945359454594555945659457594585945959460594615946259463594645946559466594675946859469594705947159472594735947459475594765947759478594795948059481594825948359484594855948659487594885948959490594915949259493594945949559496594975949859499595005950159502595035950459505595065950759508595095951059511595125951359514595155951659517595185951959520595215952259523595245952559526595275952859529595305953159532595335953459535595365953759538595395954059541595425954359544595455954659547595485954959550595515955259553595545955559556595575955859559595605956159562595635956459565595665956759568595695957059571595725957359574595755957659577595785957959580595815958259583595845958559586595875958859589595905959159592595935959459595595965959759598595995960059601596025960359604596055960659607596085960959610596115961259613596145961559616596175961859619596205962159622596235962459625596265962759628596295963059631596325963359634596355963659637596385963959640596415964259643596445964559646596475964859649596505965159652596535965459655596565965759658596595966059661596625966359664596655966659667596685966959670596715967259673596745967559676596775967859679596805968159682596835968459685596865968759688596895969059691596925969359694596955969659697596985969959700597015970259703597045970559706597075970859709597105971159712597135971459715597165971759718597195972059721597225972359724597255972659727597285972959730597315973259733597345973559736597375973859739597405974159742597435974459745597465974759748597495975059751597525975359754597555975659757597585975959760597615976259763597645976559766597675976859769597705977159772597735977459775597765977759778597795978059781597825978359784597855978659787597885978959790597915979259793597945979559796597975979859799598005980159802598035980459805598065980759808598095981059811598125981359814598155981659817598185981959820598215982259823598245982559826598275982859829598305983159832598335983459835598365983759838598395984059841598425984359844598455984659847598485984959850598515985259853598545985559856598575985859859598605986159862598635986459865598665986759868598695987059871598725987359874598755987659877598785987959880598815988259883598845988559886598875988859889598905989159892598935989459895598965989759898598995990059901599025990359904599055990659907599085990959910599115991259913599145991559916599175991859919599205992159922599235992459925599265992759928599295993059931599325993359934599355993659937599385993959940599415994259943599445994559946599475994859949599505995159952599535995459955599565995759958599595996059961599625996359964599655996659967599685996959970599715997259973599745997559976599775997859979599805998159982599835998459985599865998759988599895999059991599925999359994599955999659997599985999960000600016000260003600046000560006600076000860009600106001160012600136001460015600166001760018600196002060021600226002360024600256002660027600286002960030600316003260033600346003560036600376003860039600406004160042600436004460045600466004760048600496005060051600526005360054600556005660057600586005960060600616006260063600646006560066600676006860069600706007160072600736007460075600766007760078600796008060081600826008360084600856008660087600886008960090600916009260093600946009560096600976009860099601006010160102601036010460105601066010760108601096011060111601126011360114601156011660117601186011960120601216012260123601246012560126601276012860129601306013160132601336013460135601366013760138601396014060141601426014360144601456014660147601486014960150601516015260153601546015560156601576015860159601606016160162601636016460165601666016760168601696017060171601726017360174601756017660177601786017960180601816018260183601846018560186601876018860189601906019160192601936019460195601966019760198601996020060201602026020360204602056020660207602086020960210602116021260213602146021560216602176021860219602206022160222602236022460225602266022760228602296023060231602326023360234602356023660237602386023960240602416024260243602446024560246602476024860249602506025160252602536025460255602566025760258602596026060261602626026360264602656026660267602686026960270602716027260273602746027560276602776027860279602806028160282602836028460285602866028760288602896029060291602926029360294602956029660297602986029960300603016030260303603046030560306603076030860309603106031160312603136031460315603166031760318603196032060321603226032360324603256032660327603286032960330603316033260333603346033560336603376033860339603406034160342603436034460345603466034760348603496035060351603526035360354603556035660357603586035960360603616036260363603646036560366603676036860369603706037160372603736037460375603766037760378603796038060381603826038360384603856038660387603886038960390603916039260393603946039560396603976039860399604006040160402604036040460405604066040760408604096041060411604126041360414604156041660417604186041960420604216042260423604246042560426604276042860429604306043160432604336043460435604366043760438604396044060441604426044360444604456044660447604486044960450604516045260453604546045560456604576045860459604606046160462604636046460465604666046760468604696047060471604726047360474604756047660477604786047960480604816048260483604846048560486604876048860489604906049160492604936049460495604966049760498604996050060501605026050360504605056050660507605086050960510605116051260513605146051560516605176051860519605206052160522605236052460525605266052760528605296053060531605326053360534605356053660537605386053960540605416054260543605446054560546605476054860549605506055160552605536055460555605566055760558605596056060561605626056360564605656056660567605686056960570605716057260573605746057560576605776057860579605806058160582605836058460585605866058760588605896059060591605926059360594605956059660597605986059960600606016060260603606046060560606606076060860609606106061160612606136061460615606166061760618606196062060621606226062360624606256062660627606286062960630606316063260633606346063560636606376063860639606406064160642606436064460645606466064760648606496065060651606526065360654606556065660657606586065960660606616066260663606646066560666606676066860669
  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>MailKit</name>
  5. </assembly>
  6. <members>
  7. <member name="T:MailKit.Net.Imap.ImapClient">
  8. <summary>
  9. An IMAP client that can be used to retrieve messages from a server.
  10. </summary>
  11. <remarks>
  12. The <see cref="T:MailKit.Net.Imap.ImapClient"/> class supports both the "imap" and "imaps"
  13. protocols. The "imap" protocol makes a clear-text connection to the IMAP
  14. server and does not use SSL or TLS unless the IMAP server supports the
  15. <a href="https://tools.ietf.org/html/rfc3501#section-6.2.1">STARTTLS</a> extension.
  16. The "imaps" protocol, however, connects to the IMAP server using an
  17. SSL-wrapped connection.
  18. </remarks>
  19. <example>
  20. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadMessages"/>
  21. </example>
  22. <example>
  23. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  24. </example>
  25. </member>
  26. <member name="M:MailKit.Net.Imap.ImapClient.CompressAsync(System.Threading.CancellationToken)">
  27. <summary>
  28. Asynchronously enable compression over the IMAP connection.
  29. </summary>
  30. <remarks>
  31. <para>Asynchronously enables compression over the IMAP connection.</para>
  32. <para>If the IMAP server supports the <see cref="F:MailKit.Net.Imap.ImapCapabilities.Compress"/> extension,
  33. it is possible at any point after connecting to enable compression to reduce network
  34. bandwidth usage. Ideally, this method should be called before authenticating.</para>
  35. </remarks>
  36. <returns>An asynchronous task context.</returns>
  37. <param name="cancellationToken">The cancellation token.</param>
  38. <exception cref="T:System.ObjectDisposedException">
  39. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  40. </exception>
  41. <exception cref="T:MailKit.ServiceNotConnectedException">
  42. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  43. </exception>
  44. <exception cref="T:System.InvalidOperationException">
  45. Compression must be enabled before a folder has been selected.
  46. </exception>
  47. <exception cref="T:System.NotSupportedException">
  48. The IMAP server does not support the COMPRESS extension.
  49. </exception>
  50. <exception cref="T:System.OperationCanceledException">
  51. The operation was canceled via the cancellation token.
  52. </exception>
  53. <exception cref="T:System.IO.IOException">
  54. An I/O error occurred.
  55. </exception>
  56. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  57. The server replied to the COMPRESS command with a NO or BAD response.
  58. </exception>
  59. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  60. An IMAP protocol error occurred.
  61. </exception>
  62. </member>
  63. <member name="M:MailKit.Net.Imap.ImapClient.EnableQuickResyncAsync(System.Threading.CancellationToken)">
  64. <summary>
  65. Asynchronously enable the QRESYNC feature.
  66. </summary>
  67. <remarks>
  68. <para>Enables the <a href="https://tools.ietf.org/html/rfc5162">QRESYNC</a> feature.</para>
  69. <para>The QRESYNC extension improves resynchronization performance of folders by
  70. querying the IMAP server for a list of changes when the folder is opened using the
  71. <see cref="M:MailKit.Net.Imap.ImapFolder.Open(MailKit.FolderAccess,System.UInt32,System.UInt64,System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)"/>
  72. method.</para>
  73. <para>If this feature is enabled, the <see cref="E:MailKit.MailFolder.MessageExpunged"/> event is replaced
  74. with the <see cref="E:MailKit.MailFolder.MessagesVanished"/> event.</para>
  75. <para>This method needs to be called immediately after calling one of the
  76. <a href="Overload_MailKit_Net_Imap_ImapClient_Authenticate.htm">Authenticate</a> methods, before
  77. opening any folders.</para>
  78. </remarks>
  79. <returns>An asynchronous task context.</returns>
  80. <param name="cancellationToken">The cancellation token.</param>
  81. <exception cref="T:System.ObjectDisposedException">
  82. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  83. </exception>
  84. <exception cref="T:MailKit.ServiceNotConnectedException">
  85. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  86. </exception>
  87. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  88. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  89. </exception>
  90. <exception cref="T:System.InvalidOperationException">
  91. Quick resynchronization needs to be enabled before selecting a folder.
  92. </exception>
  93. <exception cref="T:System.NotSupportedException">
  94. The IMAP server does not support the QRESYNC extension.
  95. </exception>
  96. <exception cref="T:System.OperationCanceledException">
  97. The operation was canceled via the cancellation token.
  98. </exception>
  99. <exception cref="T:System.IO.IOException">
  100. An I/O error occurred.
  101. </exception>
  102. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  103. The server replied to the ENABLE command with a NO or BAD response.
  104. </exception>
  105. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  106. An IMAP protocol error occurred.
  107. </exception>
  108. </member>
  109. <member name="M:MailKit.Net.Imap.ImapClient.EnableUTF8Async(System.Threading.CancellationToken)">
  110. <summary>
  111. Asynchronously enable the UTF8=ACCEPT extension.
  112. </summary>
  113. <remarks>
  114. Enables the <a href="https://tools.ietf.org/html/rfc6855">UTF8=ACCEPT</a> extension.
  115. </remarks>
  116. <returns>An asynchronous task context.</returns>
  117. <param name="cancellationToken">The cancellation token.</param>
  118. <exception cref="T:System.ObjectDisposedException">
  119. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  120. </exception>
  121. <exception cref="T:MailKit.ServiceNotConnectedException">
  122. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  123. </exception>
  124. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  125. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  126. </exception>
  127. <exception cref="T:System.InvalidOperationException">
  128. UTF8=ACCEPT needs to be enabled before selecting a folder.
  129. </exception>
  130. <exception cref="T:System.NotSupportedException">
  131. The IMAP server does not support the UTF8=ACCEPT extension.
  132. </exception>
  133. <exception cref="T:System.OperationCanceledException">
  134. The operation was canceled via the cancellation token.
  135. </exception>
  136. <exception cref="T:System.IO.IOException">
  137. An I/O error occurred.
  138. </exception>
  139. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  140. The server replied to the ENABLE command with a NO or BAD response.
  141. </exception>
  142. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  143. An IMAP protocol error occurred.
  144. </exception>
  145. </member>
  146. <member name="M:MailKit.Net.Imap.ImapClient.IdentifyAsync(MailKit.Net.Imap.ImapImplementation,System.Threading.CancellationToken)">
  147. <summary>
  148. Asynchronously identify the client implementation to the server and obtain the server implementation details.
  149. </summary>
  150. <remarks>
  151. <para>Passes along the client implementation details to the server while also obtaining implementation
  152. details from the server.</para>
  153. <para>If the <paramref name="clientImplementation"/> is <c>null</c> or no properties have been set, no
  154. identifying information will be sent to the server.</para>
  155. <note type="security">
  156. <para>Security Implications</para>
  157. <para>This command has the danger of violating the privacy of users if misused. Clients should
  158. notify users that they send the ID command.</para>
  159. <para>It is highly desirable that implementations provide a method of disabling ID support, perhaps by
  160. not calling this method at all, or by passing <c>null</c> as the <paramref name="clientImplementation"/>
  161. argument.</para>
  162. <para>Implementors must exercise extreme care in adding properties to the <paramref name="clientImplementation"/>.
  163. Some properties, such as a processor ID number, Ethernet address, or other unique (or mostly unique) identifier
  164. would allow tracking of users in ways that violate user privacy expectations and may also make it easier for
  165. attackers to exploit security holes in the client.</para>
  166. </note>
  167. </remarks>
  168. <returns>The implementation details of the server if available; otherwise, <c>null</c>.</returns>
  169. <param name="clientImplementation">The client implementation.</param>
  170. <param name="cancellationToken">The cancellation token.</param>
  171. <exception cref="T:System.ObjectDisposedException">
  172. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  173. </exception>
  174. <exception cref="T:MailKit.ServiceNotConnectedException">
  175. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  176. </exception>
  177. <exception cref="T:System.NotSupportedException">
  178. The IMAP server does not support the ID extension.
  179. </exception>
  180. <exception cref="T:System.OperationCanceledException">
  181. The operation was canceled via the cancellation token.
  182. </exception>
  183. <exception cref="T:System.IO.IOException">
  184. An I/O error occurred.
  185. </exception>
  186. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  187. The server replied to the ID command with a NO or BAD response.
  188. </exception>
  189. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  190. An IMAP protocol error occurred.
  191. </exception>
  192. </member>
  193. <member name="M:MailKit.Net.Imap.ImapClient.AuthenticateAsync(MailKit.Security.SaslMechanism,System.Threading.CancellationToken)">
  194. <summary>
  195. Asynchronously authenticate using the specified SASL mechanism.
  196. </summary>
  197. <remarks>
  198. <para>Authenticates using the specified SASL mechanism.</para>
  199. <para>For a list of available SASL authentication mechanisms supported by the server,
  200. check the <see cref="P:MailKit.Net.Imap.ImapClient.AuthenticationMechanisms"/> property after the service has been
  201. connected.</para>
  202. </remarks>
  203. <returns>An asynchronous task context.</returns>
  204. <param name="mechanism">The SASL mechanism.</param>
  205. <param name="cancellationToken">The cancellation token.</param>
  206. <exception cref="T:System.ArgumentNullException">
  207. <paramref name="mechanism"/> is <c>null</c>.
  208. </exception>
  209. <exception cref="T:System.ObjectDisposedException">
  210. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  211. </exception>
  212. <exception cref="T:MailKit.ServiceNotConnectedException">
  213. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  214. </exception>
  215. <exception cref="T:System.InvalidOperationException">
  216. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is already authenticated.
  217. </exception>
  218. <exception cref="T:System.OperationCanceledException">
  219. The operation was canceled via the cancellation token.
  220. </exception>
  221. <exception cref="T:MailKit.Security.AuthenticationException">
  222. Authentication using the supplied credentials has failed.
  223. </exception>
  224. <exception cref="T:MailKit.Security.SaslException">
  225. A SASL authentication error occurred.
  226. </exception>
  227. <exception cref="T:System.IO.IOException">
  228. An I/O error occurred.
  229. </exception>
  230. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  231. An IMAP command failed.
  232. </exception>
  233. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  234. An IMAP protocol error occurred.
  235. </exception>
  236. </member>
  237. <member name="M:MailKit.Net.Imap.ImapClient.AuthenticateAsync(System.Text.Encoding,System.Net.ICredentials,System.Threading.CancellationToken)">
  238. <summary>
  239. Asynchronously authenticate using the supplied credentials.
  240. </summary>
  241. <remarks>
  242. <para>If the IMAP server supports one or more SASL authentication mechanisms,
  243. then the SASL mechanisms that both the client and server support are tried
  244. in order of greatest security to weakest security. Once a SASL
  245. authentication mechanism is found that both client and server support,
  246. the credentials are used to authenticate.</para>
  247. <para>If the server does not support SASL or if no common SASL mechanisms
  248. can be found, then LOGIN command is used as a fallback.</para>
  249. <note type="tip">To prevent the usage of certain authentication mechanisms,
  250. simply remove them from the <see cref="P:MailKit.Net.Imap.ImapClient.AuthenticationMechanisms"/> hash set
  251. before calling this method.</note>
  252. </remarks>
  253. <returns>An asynchronous task context.</returns>
  254. <param name="encoding">The text encoding to use for the user's credentials.</param>
  255. <param name="credentials">The user's credentials.</param>
  256. <param name="cancellationToken">The cancellation token.</param>
  257. <exception cref="T:System.ArgumentNullException">
  258. <para><paramref name="encoding"/> is <c>null</c>.</para>
  259. <para>-or-</para>
  260. <para><paramref name="credentials"/> is <c>null</c>.</para>
  261. </exception>
  262. <exception cref="T:System.ObjectDisposedException">
  263. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  264. </exception>
  265. <exception cref="T:MailKit.ServiceNotConnectedException">
  266. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  267. </exception>
  268. <exception cref="T:System.InvalidOperationException">
  269. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is already authenticated.
  270. </exception>
  271. <exception cref="T:System.OperationCanceledException">
  272. The operation was canceled via the cancellation token.
  273. </exception>
  274. <exception cref="T:MailKit.Security.AuthenticationException">
  275. Authentication using the supplied credentials has failed.
  276. </exception>
  277. <exception cref="T:MailKit.Security.SaslException">
  278. A SASL authentication error occurred.
  279. </exception>
  280. <exception cref="T:System.IO.IOException">
  281. An I/O error occurred.
  282. </exception>
  283. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  284. An IMAP command failed.
  285. </exception>
  286. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  287. An IMAP protocol error occurred.
  288. </exception>
  289. </member>
  290. <member name="M:MailKit.Net.Imap.ImapClient.ConnectAsync(System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  291. <summary>
  292. Asynchronously establish a connection to the specified IMAP server.
  293. </summary>
  294. <remarks>
  295. <para>Establishes a connection to the specified IMAP or IMAP/S server.</para>
  296. <para>If the <paramref name="port"/> has a value of <c>0</c>, then the
  297. <paramref name="options"/> parameter is used to determine the default port to
  298. connect to. The default port used with <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>
  299. is <c>993</c>. All other values will use a default port of <c>143</c>.</para>
  300. <para>If the <paramref name="options"/> has a value of
  301. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  302. to determine the default security options. If the <paramref name="port"/> has a value
  303. of <c>993</c>, then the default options used will be
  304. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  305. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  306. <para>Once a connection is established, properties such as
  307. <see cref="P:MailKit.Net.Imap.ImapClient.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Imap.ImapClient.Capabilities"/> will be
  308. populated.</para>
  309. </remarks>
  310. <example>
  311. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadMessages"/>
  312. </example>
  313. <returns>An asynchronous task context.</returns>
  314. <param name="host">The host name to connect to.</param>
  315. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  316. <param name="options">The secure socket options to when connecting.</param>
  317. <param name="cancellationToken">The cancellation token.</param>
  318. <exception cref="T:System.ArgumentNullException">
  319. <paramref name="host"/> is <c>null</c>.
  320. </exception>
  321. <exception cref="T:System.ArgumentOutOfRangeException">
  322. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  323. </exception>
  324. <exception cref="T:System.ArgumentException">
  325. The <paramref name="host"/> is a zero-length string.
  326. </exception>
  327. <exception cref="T:System.ObjectDisposedException">
  328. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  329. </exception>
  330. <exception cref="T:System.InvalidOperationException">
  331. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is already connected.
  332. </exception>
  333. <exception cref="T:System.NotSupportedException">
  334. <paramref name="options"/> was set to
  335. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  336. and the IMAP server does not support the STARTTLS extension.
  337. </exception>
  338. <exception cref="T:System.OperationCanceledException">
  339. The operation was canceled via the cancellation token.
  340. </exception>
  341. <exception cref="T:System.Net.Sockets.SocketException">
  342. A socket error occurred trying to connect to the remote host.
  343. </exception>
  344. <exception cref="T:MailKit.Security.SslHandshakeException">
  345. An error occurred during the SSL/TLS negotiations.
  346. </exception>
  347. <exception cref="T:System.IO.IOException">
  348. An I/O error occurred.
  349. </exception>
  350. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  351. An IMAP command failed.
  352. </exception>
  353. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  354. An IMAP protocol error occurred.
  355. </exception>
  356. </member>
  357. <member name="M:MailKit.Net.Imap.ImapClient.ConnectAsync(System.Net.Sockets.Socket,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  358. <summary>
  359. Asynchronously establish a connection to the specified IMAP or IMAP/S server using the provided socket.
  360. </summary>
  361. <remarks>
  362. <para>Establishes a connection to the specified IMAP or IMAP/S server using
  363. the provided socket.</para>
  364. <para>If the <paramref name="options"/> has a value of
  365. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  366. to determine the default security options. If the <paramref name="port"/> has a value
  367. of <c>993</c>, then the default options used will be
  368. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  369. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  370. <para>Once a connection is established, properties such as
  371. <see cref="P:MailKit.Net.Imap.ImapClient.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Imap.ImapClient.Capabilities"/> will be
  372. populated.</para>
  373. <note type="info">With the exception of using the <paramref name="port"/> to determine the
  374. default <see cref="T:MailKit.Security.SecureSocketOptions"/> to use when the <paramref name="options"/> value
  375. is <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, the <paramref name="host"/> and
  376. <paramref name="port"/> parameters are only used for logging purposes.</note>
  377. </remarks>
  378. <returns>An asynchronous task context.</returns>
  379. <param name="socket">The socket to use for the connection.</param>
  380. <param name="host">The host name to connect to.</param>
  381. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  382. <param name="options">The secure socket options to when connecting.</param>
  383. <param name="cancellationToken">The cancellation token.</param>
  384. <exception cref="T:System.ArgumentNullException">
  385. <para><paramref name="socket"/> is <c>null</c>.</para>
  386. <para>-or-</para>
  387. <para><paramref name="host"/> is <c>null</c>.</para>
  388. </exception>
  389. <exception cref="T:System.ArgumentOutOfRangeException">
  390. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  391. </exception>
  392. <exception cref="T:System.ArgumentException">
  393. <para><paramref name="socket"/> is not connected.</para>
  394. <para>-or-</para>
  395. The <paramref name="host"/> is a zero-length string.
  396. </exception>
  397. <exception cref="T:System.ObjectDisposedException">
  398. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  399. </exception>
  400. <exception cref="T:System.InvalidOperationException">
  401. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is already connected.
  402. </exception>
  403. <exception cref="T:System.NotSupportedException">
  404. <paramref name="options"/> was set to
  405. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  406. and the IMAP server does not support the STARTTLS extension.
  407. </exception>
  408. <exception cref="T:System.OperationCanceledException">
  409. The operation was canceled via the cancellation token.
  410. </exception>
  411. <exception cref="T:MailKit.Security.SslHandshakeException">
  412. An error occurred during the SSL/TLS negotiations.
  413. </exception>
  414. <exception cref="T:System.IO.IOException">
  415. An I/O error occurred.
  416. </exception>
  417. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  418. An IMAP command failed.
  419. </exception>
  420. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  421. An IMAP protocol error occurred.
  422. </exception>
  423. </member>
  424. <member name="M:MailKit.Net.Imap.ImapClient.ConnectAsync(System.IO.Stream,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  425. <summary>
  426. Asynchronously establish a connection to the specified IMAP or IMAP/S server using the provided stream.
  427. </summary>
  428. <remarks>
  429. <para>Establishes a connection to the specified IMAP or IMAP/S server using
  430. the provided stream.</para>
  431. <para>If the <paramref name="options"/> has a value of
  432. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  433. to determine the default security options. If the <paramref name="port"/> has a value
  434. of <c>993</c>, then the default options used will be
  435. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  436. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  437. <para>Once a connection is established, properties such as
  438. <see cref="P:MailKit.Net.Imap.ImapClient.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Imap.ImapClient.Capabilities"/> will be
  439. populated.</para>
  440. <note type="info">With the exception of using the <paramref name="port"/> to determine the
  441. default <see cref="T:MailKit.Security.SecureSocketOptions"/> to use when the <paramref name="options"/> value
  442. is <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, the <paramref name="host"/> and
  443. <paramref name="port"/> parameters are only used for logging purposes.</note>
  444. </remarks>
  445. <returns>An asynchronous task context.</returns>
  446. <param name="stream">The stream to use for the connection.</param>
  447. <param name="host">The host name to connect to.</param>
  448. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  449. <param name="options">The secure socket options to when connecting.</param>
  450. <param name="cancellationToken">The cancellation token.</param>
  451. <exception cref="T:System.ArgumentNullException">
  452. <para><paramref name="stream"/> is <c>null</c>.</para>
  453. <para>-or-</para>
  454. <para><paramref name="host"/> is <c>null</c>.</para>
  455. </exception>
  456. <exception cref="T:System.ArgumentOutOfRangeException">
  457. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  458. </exception>
  459. <exception cref="T:System.ArgumentException">
  460. The <paramref name="host"/> is a zero-length string.
  461. </exception>
  462. <exception cref="T:System.ObjectDisposedException">
  463. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  464. </exception>
  465. <exception cref="T:System.InvalidOperationException">
  466. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is already connected.
  467. </exception>
  468. <exception cref="T:System.NotSupportedException">
  469. <paramref name="options"/> was set to
  470. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  471. and the IMAP server does not support the STARTTLS extension.
  472. </exception>
  473. <exception cref="T:System.OperationCanceledException">
  474. The operation was canceled via the cancellation token.
  475. </exception>
  476. <exception cref="T:MailKit.Security.SslHandshakeException">
  477. An error occurred during the SSL/TLS negotiations.
  478. </exception>
  479. <exception cref="T:System.IO.IOException">
  480. An I/O error occurred.
  481. </exception>
  482. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  483. An IMAP command failed.
  484. </exception>
  485. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  486. An IMAP protocol error occurred.
  487. </exception>
  488. </member>
  489. <member name="M:MailKit.Net.Imap.ImapClient.DisconnectAsync(System.Boolean,System.Threading.CancellationToken)">
  490. <summary>
  491. Asynchronously disconnect the service.
  492. </summary>
  493. <remarks>
  494. If <paramref name="quit"/> is <c>true</c>, a <c>LOGOUT</c> command will be issued in order to disconnect cleanly.
  495. </remarks>
  496. <example>
  497. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadMessages"/>
  498. </example>
  499. <returns>An asynchronous task context.</returns>
  500. <param name="quit">If set to <c>true</c>, a <c>LOGOUT</c> command will be issued in order to disconnect cleanly.</param>
  501. <param name="cancellationToken">The cancellation token.</param>
  502. <exception cref="T:System.ObjectDisposedException">
  503. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  504. </exception>
  505. </member>
  506. <member name="M:MailKit.Net.Imap.ImapClient.NoOpAsync(System.Threading.CancellationToken)">
  507. <summary>
  508. Asynchronously ping the IMAP server to keep the connection alive.
  509. </summary>
  510. <remarks>
  511. <para>The <c>NOOP</c> command is typically used to keep the connection with the IMAP server
  512. alive. When a client goes too long (typically 30 minutes) without sending any commands to the
  513. IMAP server, the IMAP server will close the connection with the client, forcing the client to
  514. reconnect before it can send any more commands.</para>
  515. <para>The <c>NOOP</c> command also provides a great way for a client to check for new
  516. messages.</para>
  517. <para>When the IMAP server receives a <c>NOOP</c> command, it will reply to the client with a
  518. list of pending updates such as <c>EXISTS</c> and <c>RECENT</c> counts on the currently
  519. selected folder. To receive these notifications, subscribe to the
  520. <see cref="E:MailKit.MailFolder.CountChanged"/> and <see cref="E:MailKit.MailFolder.RecentChanged"/> events,
  521. respectively.</para>
  522. <para>For more information about the <c>NOOP</c> command, see
  523. <a href="https://tools.ietf.org/html/rfc3501#section-6.1.2">rfc3501</a>.</para>
  524. </remarks>
  525. <example>
  526. <code language="c#" source="Examples\ImapIdleExample.cs"/>
  527. </example>
  528. <returns>An asynchronous task context.</returns>
  529. <param name="cancellationToken">The cancellation token.</param>
  530. <exception cref="T:System.ObjectDisposedException">
  531. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  532. </exception>
  533. <exception cref="T:MailKit.ServiceNotConnectedException">
  534. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  535. </exception>
  536. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  537. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  538. </exception>
  539. <exception cref="T:System.OperationCanceledException">
  540. The operation was canceled via the cancellation token.
  541. </exception>
  542. <exception cref="T:System.IO.IOException">
  543. An I/O error occurred.
  544. </exception>
  545. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  546. The server replied to the NOOP command with a NO or BAD response.
  547. </exception>
  548. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  549. The server responded with an unexpected token.
  550. </exception>
  551. </member>
  552. <member name="M:MailKit.Net.Imap.ImapClient.IdleAsync(System.Threading.CancellationToken,System.Threading.CancellationToken)">
  553. <summary>
  554. Asynchronously toggle the <see cref="T:MailKit.Net.Imap.ImapClient"/> into the IDLE state.
  555. </summary>
  556. <remarks>
  557. <para>When a client enters the IDLE state, the IMAP server will send
  558. events to the client as they occur on the selected folder. These events
  559. may include notifications of new messages arriving, expunge notifications,
  560. flag changes, etc.</para>
  561. <para>Due to the nature of the IDLE command, a folder must be selected
  562. before a client can enter into the IDLE state. This can be done by
  563. opening a folder using
  564. <see cref="M:MailKit.MailFolder.Open(MailKit.FolderAccess,System.Threading.CancellationToken)"/>
  565. or any of the other variants.</para>
  566. <para>While the IDLE command is running, no other commands may be issued until the
  567. <paramref name="doneToken"/> is cancelled.</para>
  568. <note type="note">It is especially important to cancel the <paramref name="doneToken"/>
  569. before cancelling the <paramref name="cancellationToken"/> when using SSL or TLS due to
  570. the fact that <see cref="T:System.Net.Security.SslStream"/> cannot be polled.</note>
  571. </remarks>
  572. <returns>An asynchronous task context.</returns>
  573. <param name="doneToken">The cancellation token used to return to the non-idle state.</param>
  574. <param name="cancellationToken">The cancellation token.</param>
  575. <exception cref="T:System.ArgumentException">
  576. <paramref name="doneToken"/> must be cancellable (i.e. <see cref="P:System.Threading.CancellationToken.None"/> cannot be used).
  577. </exception>
  578. <exception cref="T:System.ObjectDisposedException">
  579. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  580. </exception>
  581. <exception cref="T:MailKit.ServiceNotConnectedException">
  582. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  583. </exception>
  584. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  585. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  586. </exception>
  587. <exception cref="T:System.InvalidOperationException">
  588. A <see cref="T:MailKit.Net.Imap.ImapFolder"/> has not been opened.
  589. </exception>
  590. <exception cref="T:System.NotSupportedException">
  591. The IMAP server does not support the IDLE extension.
  592. </exception>
  593. <exception cref="T:System.OperationCanceledException">
  594. The operation was canceled via the cancellation token.
  595. </exception>
  596. <exception cref="T:System.IO.IOException">
  597. An I/O error occurred.
  598. </exception>
  599. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  600. The server replied to the IDLE command with a NO or BAD response.
  601. </exception>
  602. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  603. The server responded with an unexpected token.
  604. </exception>
  605. </member>
  606. <member name="M:MailKit.Net.Imap.ImapClient.NotifyAsync(System.Boolean,System.Collections.Generic.IList{MailKit.Net.Imap.ImapEventGroup},System.Threading.CancellationToken)">
  607. <summary>
  608. Asynchronously request the specified notification events from the IMAP server.
  609. </summary>
  610. <remarks>
  611. <para>The <a href="https://tools.ietf.org/html/rfc5465">NOTIFY</a> command is used to expand
  612. which notifications the client wishes to be notified about, including status notifications
  613. about folders other than the currently selected folder. It can also be used to automatically
  614. FETCH information about new messages that have arrived in the currently selected folder.</para>
  615. <para>This, combined with <see cref="M:MailKit.Net.Imap.ImapClient.IdleAsync(System.Threading.CancellationToken,System.Threading.CancellationToken)"/>,
  616. can be used to get instant notifications for changes to any of the specified folders.</para>
  617. </remarks>
  618. <returns>An asynchronous task context.</returns>
  619. <param name="status"><c>true</c> if the server should immediately notify the client of the
  620. selected folder's status; otherwise, <c>false</c>.</param>
  621. <param name="eventGroups">The specific event groups that the client would like to receive notifications for.</param>
  622. <param name="cancellationToken">The cancellation token.</param>
  623. <exception cref="T:System.ArgumentNullException">
  624. <paramref name="eventGroups"/> is <c>null</c>.
  625. </exception>
  626. <exception cref="T:System.ArgumentException">
  627. <paramref name="eventGroups"/> is empty.
  628. </exception>
  629. <exception cref="T:System.ObjectDisposedException">
  630. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  631. </exception>
  632. <exception cref="T:MailKit.ServiceNotConnectedException">
  633. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  634. </exception>
  635. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  636. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  637. </exception>
  638. <exception cref="T:System.InvalidOperationException">
  639. One or more <see cref="T:MailKit.Net.Imap.ImapEventGroup"/> is invalid.
  640. </exception>
  641. <exception cref="T:System.NotSupportedException">
  642. The IMAP server does not support the NOTIFY extension.
  643. </exception>
  644. <exception cref="T:System.OperationCanceledException">
  645. The operation was canceled via the cancellation token.
  646. </exception>
  647. <exception cref="T:System.IO.IOException">
  648. An I/O error occurred.
  649. </exception>
  650. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  651. The server replied to the NOTIFY command with a NO or BAD response.
  652. </exception>
  653. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  654. The server responded with an unexpected token.
  655. </exception>
  656. </member>
  657. <member name="M:MailKit.Net.Imap.ImapClient.DisableNotifyAsync(System.Threading.CancellationToken)">
  658. <summary>
  659. Asynchronously disable any previously requested notification events from the IMAP server.
  660. </summary>
  661. <remarks>
  662. Disables any notification events requested in a prior call to
  663. <see cref="M:MailKit.Net.Imap.ImapClient.NotifyAsync(System.Boolean,System.Collections.Generic.IList{MailKit.Net.Imap.ImapEventGroup},System.Threading.CancellationToken)"/>.
  664. request.
  665. </remarks>
  666. <returns>An asynchronous task context.</returns>
  667. <param name="cancellationToken">The cancellation token.</param>
  668. <exception cref="T:System.ObjectDisposedException">
  669. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  670. </exception>
  671. <exception cref="T:MailKit.ServiceNotConnectedException">
  672. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  673. </exception>
  674. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  675. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  676. </exception>
  677. <exception cref="T:System.NotSupportedException">
  678. The IMAP server does not support the NOTIFY extension.
  679. </exception>
  680. <exception cref="T:System.OperationCanceledException">
  681. The operation was canceled via the cancellation token.
  682. </exception>
  683. <exception cref="T:System.IO.IOException">
  684. An I/O error occurred.
  685. </exception>
  686. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  687. The server replied to the NOTIFY command with a NO or BAD response.
  688. </exception>
  689. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  690. The server responded with an unexpected token.
  691. </exception>
  692. </member>
  693. <member name="M:MailKit.Net.Imap.ImapClient.GetFoldersAsync(MailKit.FolderNamespace,MailKit.StatusItems,System.Boolean,System.Threading.CancellationToken)">
  694. <summary>
  695. Asynchronously get all of the folders within the specified namespace.
  696. </summary>
  697. <remarks>
  698. Gets all of the folders within the specified namespace.
  699. </remarks>
  700. <returns>The folders.</returns>
  701. <param name="namespace">The namespace.</param>
  702. <param name="items">The status items to pre-populate.</param>
  703. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  704. <param name="cancellationToken">The cancellation token.</param>
  705. <exception cref="T:System.ArgumentNullException">
  706. <paramref name="namespace"/> is <c>null</c>.
  707. </exception>
  708. <exception cref="T:System.ObjectDisposedException">
  709. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  710. </exception>
  711. <exception cref="T:MailKit.ServiceNotConnectedException">
  712. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  713. </exception>
  714. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  715. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  716. </exception>
  717. <exception cref="T:System.OperationCanceledException">
  718. The operation was canceled via the cancellation token.
  719. </exception>
  720. <exception cref="T:MailKit.FolderNotFoundException">
  721. The namespace folder could not be found.
  722. </exception>
  723. <exception cref="T:System.IO.IOException">
  724. An I/O error occurred.
  725. </exception>
  726. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  727. The server replied to the LIST or LSUB command with a NO or BAD response.
  728. </exception>
  729. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  730. The server responded with an unexpected token.
  731. </exception>
  732. </member>
  733. <member name="M:MailKit.Net.Imap.ImapClient.GetFolderAsync(System.String,System.Threading.CancellationToken)">
  734. <summary>
  735. Asynchronously get the folder for the specified path.
  736. </summary>
  737. <remarks>
  738. Gets the folder for the specified path.
  739. </remarks>
  740. <returns>The folder.</returns>
  741. <param name="path">The folder path.</param>
  742. <param name="cancellationToken">The cancellation token.</param>
  743. <exception cref="T:System.ArgumentNullException">
  744. <paramref name="path"/> is <c>null</c>.
  745. </exception>
  746. <exception cref="T:System.ObjectDisposedException">
  747. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  748. </exception>
  749. <exception cref="T:MailKit.ServiceNotConnectedException">
  750. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  751. </exception>
  752. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  753. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  754. </exception>
  755. <exception cref="T:System.OperationCanceledException">
  756. The operation was canceled via the cancellation token.
  757. </exception>
  758. <exception cref="T:MailKit.FolderNotFoundException">
  759. The folder could not be found.
  760. </exception>
  761. <exception cref="T:System.IO.IOException">
  762. An I/O error occurred.
  763. </exception>
  764. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  765. The server replied to the IDLE command with a NO or BAD response.
  766. </exception>
  767. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  768. The server responded with an unexpected token.
  769. </exception>
  770. </member>
  771. <member name="M:MailKit.Net.Imap.ImapClient.GetMetadataAsync(MailKit.MetadataTag,System.Threading.CancellationToken)">
  772. <summary>
  773. Asynchronously gets the specified metadata.
  774. </summary>
  775. <remarks>
  776. Gets the specified metadata.
  777. </remarks>
  778. <returns>The requested metadata value.</returns>
  779. <param name="tag">The metadata tag.</param>
  780. <param name="cancellationToken">The cancellation token.</param>
  781. <exception cref="T:System.ObjectDisposedException">
  782. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  783. </exception>
  784. <exception cref="T:MailKit.ServiceNotConnectedException">
  785. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  786. </exception>
  787. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  788. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  789. </exception>
  790. <exception cref="T:System.NotSupportedException">
  791. The IMAP server does not support the METADATA or METADATA-SERVER extension.
  792. </exception>
  793. <exception cref="T:System.OperationCanceledException">
  794. The operation was canceled via the cancellation token.
  795. </exception>
  796. <exception cref="T:System.IO.IOException">
  797. An I/O error occurred.
  798. </exception>
  799. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  800. The server's response contained unexpected tokens.
  801. </exception>
  802. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  803. The server replied with a NO or BAD response.
  804. </exception>
  805. </member>
  806. <member name="M:MailKit.Net.Imap.ImapClient.GetMetadataAsync(MailKit.MetadataOptions,System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  807. <summary>
  808. Asynchronously gets the specified metadata.
  809. </summary>
  810. <remarks>
  811. Gets the specified metadata.
  812. </remarks>
  813. <returns>The requested metadata.</returns>
  814. <param name="options">The metadata options.</param>
  815. <param name="tags">The metadata tags.</param>
  816. <param name="cancellationToken">The cancellation token.</param>
  817. <exception cref="T:System.ArgumentNullException">
  818. <para><paramref name="options"/> is <c>null</c>.</para>
  819. <para>-or-</para>
  820. <para><paramref name="tags"/> is <c>null</c>.</para>
  821. </exception>
  822. <exception cref="T:System.ObjectDisposedException">
  823. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  824. </exception>
  825. <exception cref="T:MailKit.ServiceNotConnectedException">
  826. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  827. </exception>
  828. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  829. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  830. </exception>
  831. <exception cref="T:System.NotSupportedException">
  832. The IMAP server does not support the METADATA or METADATA-SERVER extension.
  833. </exception>
  834. <exception cref="T:System.OperationCanceledException">
  835. The operation was canceled via the cancellation token.
  836. </exception>
  837. <exception cref="T:System.IO.IOException">
  838. An I/O error occurred.
  839. </exception>
  840. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  841. The server's response contained unexpected tokens.
  842. </exception>
  843. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  844. The server replied with a NO or BAD response.
  845. </exception>
  846. </member>
  847. <member name="M:MailKit.Net.Imap.ImapClient.SetMetadataAsync(MailKit.MetadataCollection,System.Threading.CancellationToken)">
  848. <summary>
  849. Asynchronously gets the specified metadata.
  850. </summary>
  851. <remarks>
  852. Sets the specified metadata.
  853. </remarks>
  854. <returns>An asynchronous task context.</returns>
  855. <param name="metadata">The metadata.</param>
  856. <param name="cancellationToken">The cancellation token.</param>
  857. <exception cref="T:System.ArgumentNullException">
  858. <paramref name="metadata"/> is <c>null</c>.
  859. </exception>
  860. <exception cref="T:System.ObjectDisposedException">
  861. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  862. </exception>
  863. <exception cref="T:MailKit.ServiceNotConnectedException">
  864. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  865. </exception>
  866. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  867. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  868. </exception>
  869. <exception cref="T:System.NotSupportedException">
  870. The IMAP server does not support the METADATA or METADATA-SERVER extension.
  871. </exception>
  872. <exception cref="T:System.OperationCanceledException">
  873. The operation was canceled via the cancellation token.
  874. </exception>
  875. <exception cref="T:System.IO.IOException">
  876. An I/O error occurred.
  877. </exception>
  878. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  879. The server's response contained unexpected tokens.
  880. </exception>
  881. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  882. The server replied with a NO or BAD response.
  883. </exception>
  884. </member>
  885. <member name="M:MailKit.Net.Imap.ImapClient.#ctor">
  886. <summary>
  887. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapClient"/> class.
  888. </summary>
  889. <remarks>
  890. Before you can retrieve messages with the <see cref="T:MailKit.Net.Imap.ImapClient"/>, you must first
  891. call one of the <a href="Overload_MailKit_Net_Imap_ImapClient_Connect.htm">Connect</a>
  892. methods and then authenticate with the one of the
  893. <a href="Overload_MailKit_Net_Imap_ImapClient_Authenticate.htm">Authenticate</a>
  894. methods.
  895. </remarks>
  896. <example>
  897. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadMessages"/>
  898. </example>
  899. </member>
  900. <member name="M:MailKit.Net.Imap.ImapClient.#ctor(MailKit.IProtocolLogger)">
  901. <summary>
  902. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapClient"/> class.
  903. </summary>
  904. <remarks>
  905. Before you can retrieve messages with the <see cref="T:MailKit.Net.Imap.ImapClient"/>, you must first
  906. call one of the <a href="Overload_MailKit_Net_Imap_ImapClient_Connect.htm">Connect</a>
  907. methods and then authenticate with the one of the
  908. <a href="Overload_MailKit_Net_Imap_ImapClient_Authenticate.htm">Authenticate</a>
  909. methods.
  910. </remarks>
  911. <example>
  912. <code language="c#" source="Examples\ImapExamples.cs" region="ProtocolLogger"/>
  913. </example>
  914. <param name="protocolLogger">The protocol logger.</param>
  915. <exception cref="T:System.ArgumentNullException">
  916. <paramref name="protocolLogger"/> is <c>null</c>.
  917. </exception>
  918. </member>
  919. <member name="P:MailKit.Net.Imap.ImapClient.SyncRoot">
  920. <summary>
  921. Gets an object that can be used to synchronize access to the IMAP server.
  922. </summary>
  923. <remarks>
  924. <para>Gets an object that can be used to synchronize access to the IMAP server.</para>
  925. <para>When using the non-Async methods from multiple threads, it is important to lock the
  926. <see cref="P:MailKit.Net.Imap.ImapClient.SyncRoot"/> object for thread safety when using the synchronous methods.</para>
  927. </remarks>
  928. <value>The lock object.</value>
  929. </member>
  930. <member name="P:MailKit.Net.Imap.ImapClient.Protocol">
  931. <summary>
  932. Get the protocol supported by the message service.
  933. </summary>
  934. <remarks>
  935. Gets the protocol supported by the message service.
  936. </remarks>
  937. <value>The protocol.</value>
  938. </member>
  939. <member name="P:MailKit.Net.Imap.ImapClient.Capabilities">
  940. <summary>
  941. Get the capabilities supported by the IMAP server.
  942. </summary>
  943. <remarks>
  944. The capabilities will not be known until a successful connection has been made via one of
  945. the <a href="Overload_MailKit_Net_Imap_ImapClient_Connect.htm">Connect</a> methods and may
  946. change as a side-effect of calling one of the
  947. <a href="Overload_MailKit_Net_Imap_ImapClient_Authenticate.htm">Authenticate</a>
  948. methods.
  949. </remarks>
  950. <example>
  951. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  952. </example>
  953. <value>The capabilities.</value>
  954. <exception cref="T:System.ArgumentException">
  955. Capabilities cannot be enabled, they may only be disabled.
  956. </exception>
  957. </member>
  958. <member name="P:MailKit.Net.Imap.ImapClient.AppendLimit">
  959. <summary>
  960. Gets the maximum size of a message that can be appended to a folder.
  961. </summary>
  962. <remarks>
  963. <para>Gets the maximum size of a message, in bytes, that can be appended to a folder.</para>
  964. <note type="note">If the value is not set, then the limit is unspecified.</note>
  965. </remarks>
  966. <value>The append limit.</value>
  967. </member>
  968. <member name="P:MailKit.Net.Imap.ImapClient.InternationalizationLevel">
  969. <summary>
  970. Gets the internationalization level supported by the IMAP server.
  971. </summary>
  972. <remarks>
  973. <para>Gets the internationalization level supported by the IMAP server.</para>
  974. <para>For more information, see
  975. <a href="https://tools.ietf.org/html/rfc5255#section-4">section 4 of rfc5255</a>.</para>
  976. </remarks>
  977. <value>The internationalization level.</value>
  978. </member>
  979. <member name="P:MailKit.Net.Imap.ImapClient.Rights">
  980. <summary>
  981. Get the access rights supported by the IMAP server.
  982. </summary>
  983. <remarks>
  984. These rights are additional rights supported by the IMAP server beyond the standard rights
  985. defined in <a href="https://tools.ietf.org/html/rfc4314#section-2.1">section 2.1 of rfc4314</a>
  986. and will not be populated until the client is successfully connected.
  987. </remarks>
  988. <example>
  989. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  990. </example>
  991. <value>The rights.</value>
  992. </member>
  993. <member name="M:MailKit.Net.Imap.ImapClient.CreateImapFolder(MailKit.Net.Imap.ImapFolderConstructorArgs)">
  994. <summary>
  995. Instantiate a new <see cref="T:MailKit.Net.Imap.ImapFolder"/>.
  996. </summary>
  997. <remarks>
  998. <para>Creates a new <see cref="T:MailKit.Net.Imap.ImapFolder"/> instance.</para>
  999. <note type="note">This method's purpose is to allow subclassing <see cref="T:MailKit.Net.Imap.ImapFolder"/>.</note>
  1000. </remarks>
  1001. <returns>The IMAP folder instance.</returns>
  1002. <param name="args">The constructior arguments.</param>
  1003. <exception cref="T:System.ArgumentNullException">
  1004. <paramref name="args"/> is <c>null</c>.
  1005. </exception>
  1006. </member>
  1007. <member name="M:MailKit.Net.Imap.ImapClient.Compress(System.Threading.CancellationToken)">
  1008. <summary>
  1009. Enable compression over the IMAP connection.
  1010. </summary>
  1011. <remarks>
  1012. <para>Enables compression over the IMAP connection.</para>
  1013. <para>If the IMAP server supports the <see cref="F:MailKit.Net.Imap.ImapCapabilities.Compress"/> extension,
  1014. it is possible at any point after connecting to enable compression to reduce network
  1015. bandwidth usage. Ideally, this method should be called before authenticating.</para>
  1016. </remarks>
  1017. <param name="cancellationToken">The cancellation token.</param>
  1018. <exception cref="T:System.ObjectDisposedException">
  1019. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1020. </exception>
  1021. <exception cref="T:MailKit.ServiceNotConnectedException">
  1022. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1023. </exception>
  1024. <exception cref="T:System.InvalidOperationException">
  1025. Compression must be enabled before a folder has been selected.
  1026. </exception>
  1027. <exception cref="T:System.NotSupportedException">
  1028. The IMAP server does not support the <see cref="F:MailKit.Net.Imap.ImapCapabilities.Compress"/> extension.
  1029. </exception>
  1030. <exception cref="T:System.OperationCanceledException">
  1031. The operation was canceled via the cancellation token.
  1032. </exception>
  1033. <exception cref="T:System.IO.IOException">
  1034. An I/O error occurred.
  1035. </exception>
  1036. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1037. The server replied to the COMPRESS command with a NO or BAD response.
  1038. </exception>
  1039. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1040. An IMAP protocol error occurred.
  1041. </exception>
  1042. </member>
  1043. <member name="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)">
  1044. <summary>
  1045. Enable the QRESYNC feature.
  1046. </summary>
  1047. <remarks>
  1048. <para>Enables the <a href="https://tools.ietf.org/html/rfc5162">QRESYNC</a> feature.</para>
  1049. <para>The QRESYNC extension improves resynchronization performance of folders by
  1050. querying the IMAP server for a list of changes when the folder is opened using the
  1051. <see cref="M:MailKit.Net.Imap.ImapFolder.Open(MailKit.FolderAccess,System.UInt32,System.UInt64,System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)"/>
  1052. method.</para>
  1053. <para>If this feature is enabled, the <see cref="E:MailKit.MailFolder.MessageExpunged"/> event is replaced
  1054. with the <see cref="E:MailKit.MailFolder.MessagesVanished"/> event.</para>
  1055. <para>This method needs to be called immediately after calling one of the
  1056. <a href="Overload_MailKit_Net_Imap_ImapClient_Authenticate.htm">Authenticate</a> methods, before
  1057. opening any folders.</para>
  1058. </remarks>
  1059. <param name="cancellationToken">The cancellation token.</param>
  1060. <exception cref="T:System.ObjectDisposedException">
  1061. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1062. </exception>
  1063. <exception cref="T:MailKit.ServiceNotConnectedException">
  1064. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1065. </exception>
  1066. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  1067. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  1068. </exception>
  1069. <exception cref="T:System.InvalidOperationException">
  1070. Quick resynchronization needs to be enabled before selecting a folder.
  1071. </exception>
  1072. <exception cref="T:System.NotSupportedException">
  1073. The IMAP server does not support the QRESYNC extension.
  1074. </exception>
  1075. <exception cref="T:System.OperationCanceledException">
  1076. The operation was canceled via the cancellation token.
  1077. </exception>
  1078. <exception cref="T:System.IO.IOException">
  1079. An I/O error occurred.
  1080. </exception>
  1081. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1082. The server replied to the ENABLE command with a NO or BAD response.
  1083. </exception>
  1084. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1085. An IMAP protocol error occurred.
  1086. </exception>
  1087. </member>
  1088. <member name="M:MailKit.Net.Imap.ImapClient.EnableUTF8(System.Threading.CancellationToken)">
  1089. <summary>
  1090. Enable the UTF8=ACCEPT extension.
  1091. </summary>
  1092. <remarks>
  1093. Enables the <a href="https://tools.ietf.org/html/rfc6855">UTF8=ACCEPT</a> extension.
  1094. </remarks>
  1095. <param name="cancellationToken">The cancellation token.</param>
  1096. <exception cref="T:System.ObjectDisposedException">
  1097. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1098. </exception>
  1099. <exception cref="T:MailKit.ServiceNotConnectedException">
  1100. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1101. </exception>
  1102. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  1103. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  1104. </exception>
  1105. <exception cref="T:System.InvalidOperationException">
  1106. UTF8=ACCEPT needs to be enabled before selecting a folder.
  1107. </exception>
  1108. <exception cref="T:System.NotSupportedException">
  1109. The IMAP server does not support the UTF8=ACCEPT extension.
  1110. </exception>
  1111. <exception cref="T:System.OperationCanceledException">
  1112. The operation was canceled via the cancellation token.
  1113. </exception>
  1114. <exception cref="T:System.IO.IOException">
  1115. An I/O error occurred.
  1116. </exception>
  1117. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1118. The server replied to the ENABLE command with a NO or BAD response.
  1119. </exception>
  1120. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1121. An IMAP protocol error occurred.
  1122. </exception>
  1123. </member>
  1124. <member name="M:MailKit.Net.Imap.ImapClient.Identify(MailKit.Net.Imap.ImapImplementation,System.Threading.CancellationToken)">
  1125. <summary>
  1126. Identify the client implementation to the server and obtain the server implementation details.
  1127. </summary>
  1128. <remarks>
  1129. <para>Passes along the client implementation details to the server while also obtaining implementation
  1130. details from the server.</para>
  1131. <para>If the <paramref name="clientImplementation"/> is <c>null</c> or no properties have been set, no
  1132. identifying information will be sent to the server.</para>
  1133. <note type="security">
  1134. <para>Security Implications</para>
  1135. <para>This command has the danger of violating the privacy of users if misused. Clients should
  1136. notify users that they send the ID command.</para>
  1137. <para>It is highly desirable that implementations provide a method of disabling ID support, perhaps by
  1138. not calling this method at all, or by passing <c>null</c> as the <paramref name="clientImplementation"/>
  1139. argument.</para>
  1140. <para>Implementors must exercise extreme care in adding properties to the <paramref name="clientImplementation"/>.
  1141. Some properties, such as a processor ID number, Ethernet address, or other unique (or mostly unique) identifier
  1142. would allow tracking of users in ways that violate user privacy expectations and may also make it easier for
  1143. attackers to exploit security holes in the client.</para>
  1144. </note>
  1145. </remarks>
  1146. <example>
  1147. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  1148. </example>
  1149. <returns>The implementation details of the server if available; otherwise, <c>null</c>.</returns>
  1150. <param name="clientImplementation">The client implementation.</param>
  1151. <param name="cancellationToken">The cancellation token.</param>
  1152. <exception cref="T:System.ObjectDisposedException">
  1153. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1154. </exception>
  1155. <exception cref="T:MailKit.ServiceNotConnectedException">
  1156. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1157. </exception>
  1158. <exception cref="T:System.NotSupportedException">
  1159. The IMAP server does not support the ID extension.
  1160. </exception>
  1161. <exception cref="T:System.OperationCanceledException">
  1162. The operation was canceled via the cancellation token.
  1163. </exception>
  1164. <exception cref="T:System.IO.IOException">
  1165. An I/O error occurred.
  1166. </exception>
  1167. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1168. The server replied to the ID command with a NO or BAD response.
  1169. </exception>
  1170. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1171. An IMAP protocol error occurred.
  1172. </exception>
  1173. </member>
  1174. <member name="P:MailKit.Net.Imap.ImapClient.AuthenticationMechanisms">
  1175. <summary>
  1176. Get the authentication mechanisms supported by the IMAP server.
  1177. </summary>
  1178. <remarks>
  1179. <para>The authentication mechanisms are queried as part of the
  1180. <a href="Overload_MailKit_Net_Imap_ImapClient_Connect.htm">Connect</a>
  1181. method.</para>
  1182. <note type="tip">To prevent the usage of certain authentication mechanisms,
  1183. simply remove them from the <see cref="P:MailKit.Net.Imap.ImapClient.AuthenticationMechanisms"/> hash set
  1184. before authenticating.</note>
  1185. </remarks>
  1186. <example>
  1187. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  1188. </example>
  1189. <value>The authentication mechanisms.</value>
  1190. </member>
  1191. <member name="P:MailKit.Net.Imap.ImapClient.ThreadingAlgorithms">
  1192. <summary>
  1193. Get the threading algorithms supported by the IMAP server.
  1194. </summary>
  1195. <remarks>
  1196. The threading algorithms are queried as part of the
  1197. <a href="Overload_MailKit_Net_Imap_ImapClient_Connect.htm">Connect</a>
  1198. and <a href="Overload_MailKit_Net_Imap_ImapClient_Authenticate.htm">Authenticate</a> methods.
  1199. </remarks>
  1200. <example>
  1201. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  1202. </example>
  1203. <value>The supported threading algorithms.</value>
  1204. </member>
  1205. <member name="P:MailKit.Net.Imap.ImapClient.Timeout">
  1206. <summary>
  1207. Get or set the timeout for network streaming operations, in milliseconds.
  1208. </summary>
  1209. <remarks>
  1210. Gets or sets the underlying socket stream's <see cref="P:System.IO.Stream.ReadTimeout"/>
  1211. and <see cref="P:System.IO.Stream.WriteTimeout"/> values.
  1212. </remarks>
  1213. <value>The timeout in milliseconds.</value>
  1214. </member>
  1215. <member name="P:MailKit.Net.Imap.ImapClient.IsConnected">
  1216. <summary>
  1217. Get whether or not the client is currently connected to an IMAP server.
  1218. </summary>
  1219. <remarks>
  1220. <para>The <see cref="P:MailKit.Net.Imap.ImapClient.IsConnected"/> state is set to <c>true</c> immediately after
  1221. one of the <a href="Overload_MailKit_Net_Imap_ImapClient_Connect.htm">Connect</a>
  1222. methods succeeds and is not set back to <c>false</c> until either the client
  1223. is disconnected via <see cref="M:MailKit.Net.Imap.ImapClient.Disconnect(System.Boolean,System.Threading.CancellationToken)"/> or until an
  1224. <see cref="T:MailKit.Net.Imap.ImapProtocolException"/> is thrown while attempting to read or write to
  1225. the underlying network socket.</para>
  1226. <para>When an <see cref="T:MailKit.Net.Imap.ImapProtocolException"/> is caught, the connection state of the
  1227. <see cref="T:MailKit.Net.Imap.ImapClient"/> should be checked before continuing.</para>
  1228. </remarks>
  1229. <value><c>true</c> if the client is connected; otherwise, <c>false</c>.</value>
  1230. </member>
  1231. <member name="P:MailKit.Net.Imap.ImapClient.IsSecure">
  1232. <summary>
  1233. Get whether or not the connection is secure (typically via SSL or TLS).
  1234. </summary>
  1235. <remarks>
  1236. Gets whether or not the connection is secure (typically via SSL or TLS).
  1237. </remarks>
  1238. <value><c>true</c> if the connection is secure; otherwise, <c>false</c>.</value>
  1239. </member>
  1240. <member name="P:MailKit.Net.Imap.ImapClient.IsAuthenticated">
  1241. <summary>
  1242. Get whether or not the client is currently authenticated with the IMAP server.
  1243. </summary>
  1244. <remarks>
  1245. <para>Gets whether or not the client is currently authenticated with the IMAP server.</para>
  1246. <para>To authenticate with the IMAP server, use one of the
  1247. <a href="Overload_MailKit_Net_Imap_ImapClient_Authenticate.htm">Authenticate</a>
  1248. methods.</para>
  1249. </remarks>
  1250. <value><c>true</c> if the client is connected; otherwise, <c>false</c>.</value>
  1251. </member>
  1252. <member name="P:MailKit.Net.Imap.ImapClient.IsIdle">
  1253. <summary>
  1254. Get whether or not the client is currently in the IDLE state.
  1255. </summary>
  1256. <remarks>
  1257. Gets whether or not the client is currently in the IDLE state.
  1258. </remarks>
  1259. <value><c>true</c> if an IDLE command is active; otherwise, <c>false</c>.</value>
  1260. </member>
  1261. <member name="M:MailKit.Net.Imap.ImapClient.Authenticate(MailKit.Security.SaslMechanism,System.Threading.CancellationToken)">
  1262. <summary>
  1263. Authenticate using the specified SASL mechanism.
  1264. </summary>
  1265. <remarks>
  1266. <para>Authenticates using the specified SASL mechanism.</para>
  1267. <para>For a list of available SASL authentication mechanisms supported by the server,
  1268. check the <see cref="P:MailKit.Net.Imap.ImapClient.AuthenticationMechanisms"/> property after the service has been
  1269. connected.</para>
  1270. </remarks>
  1271. <param name="mechanism">The SASL mechanism.</param>
  1272. <param name="cancellationToken">The cancellation token.</param>
  1273. <exception cref="T:System.ArgumentNullException">
  1274. <paramref name="mechanism"/> is <c>null</c>.
  1275. </exception>
  1276. <exception cref="T:System.ObjectDisposedException">
  1277. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1278. </exception>
  1279. <exception cref="T:MailKit.ServiceNotConnectedException">
  1280. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1281. </exception>
  1282. <exception cref="T:System.InvalidOperationException">
  1283. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is already authenticated.
  1284. </exception>
  1285. <exception cref="T:System.OperationCanceledException">
  1286. The operation was canceled via the cancellation token.
  1287. </exception>
  1288. <exception cref="T:MailKit.Security.AuthenticationException">
  1289. Authentication using the supplied credentials has failed.
  1290. </exception>
  1291. <exception cref="T:MailKit.Security.SaslException">
  1292. A SASL authentication error occurred.
  1293. </exception>
  1294. <exception cref="T:System.IO.IOException">
  1295. An I/O error occurred.
  1296. </exception>
  1297. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1298. An IMAP command failed.
  1299. </exception>
  1300. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1301. An IMAP protocol error occurred.
  1302. </exception>
  1303. </member>
  1304. <member name="M:MailKit.Net.Imap.ImapClient.Authenticate(System.Text.Encoding,System.Net.ICredentials,System.Threading.CancellationToken)">
  1305. <summary>
  1306. Authenticate using the supplied credentials.
  1307. </summary>
  1308. <remarks>
  1309. <para>If the IMAP server supports one or more SASL authentication mechanisms,
  1310. then the SASL mechanisms that both the client and server support are tried
  1311. in order of greatest security to weakest security. Once a SASL
  1312. authentication mechanism is found that both client and server support,
  1313. the credentials are used to authenticate.</para>
  1314. <para>If the server does not support SASL or if no common SASL mechanisms
  1315. can be found, then LOGIN command is used as a fallback.</para>
  1316. <note type="tip">To prevent the usage of certain authentication mechanisms,
  1317. simply remove them from the <see cref="P:MailKit.Net.Imap.ImapClient.AuthenticationMechanisms"/> hash set
  1318. before calling this method.</note>
  1319. </remarks>
  1320. <param name="encoding">The text encoding to use for the user's credentials.</param>
  1321. <param name="credentials">The user's credentials.</param>
  1322. <param name="cancellationToken">The cancellation token.</param>
  1323. <exception cref="T:System.ArgumentNullException">
  1324. <para><paramref name="encoding"/> is <c>null</c>.</para>
  1325. <para>-or-</para>
  1326. <para><paramref name="credentials"/> is <c>null</c>.</para>
  1327. </exception>
  1328. <exception cref="T:System.ObjectDisposedException">
  1329. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1330. </exception>
  1331. <exception cref="T:MailKit.ServiceNotConnectedException">
  1332. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1333. </exception>
  1334. <exception cref="T:System.InvalidOperationException">
  1335. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is already authenticated.
  1336. </exception>
  1337. <exception cref="T:System.OperationCanceledException">
  1338. The operation was canceled via the cancellation token.
  1339. </exception>
  1340. <exception cref="T:MailKit.Security.AuthenticationException">
  1341. Authentication using the supplied credentials has failed.
  1342. </exception>
  1343. <exception cref="T:MailKit.Security.SaslException">
  1344. A SASL authentication error occurred.
  1345. </exception>
  1346. <exception cref="T:System.IO.IOException">
  1347. An I/O error occurred.
  1348. </exception>
  1349. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1350. An IMAP command failed.
  1351. </exception>
  1352. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1353. An IMAP protocol error occurred.
  1354. </exception>
  1355. </member>
  1356. <member name="M:MailKit.Net.Imap.ImapClient.Connect(System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  1357. <summary>
  1358. Establish a connection to the specified IMAP server.
  1359. </summary>
  1360. <remarks>
  1361. <para>Establishes a connection to the specified IMAP or IMAP/S server.</para>
  1362. <para>If the <paramref name="port"/> has a value of <c>0</c>, then the
  1363. <paramref name="options"/> parameter is used to determine the default port to
  1364. connect to. The default port used with <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>
  1365. is <c>993</c>. All other values will use a default port of <c>143</c>.</para>
  1366. <para>If the <paramref name="options"/> has a value of
  1367. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  1368. to determine the default security options. If the <paramref name="port"/> has a value
  1369. of <c>993</c>, then the default options used will be
  1370. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  1371. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  1372. <para>Once a connection is established, properties such as
  1373. <see cref="P:MailKit.Net.Imap.ImapClient.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Imap.ImapClient.Capabilities"/> will be
  1374. populated.</para>
  1375. </remarks>
  1376. <example>
  1377. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadMessages"/>
  1378. </example>
  1379. <param name="host">The host name to connect to.</param>
  1380. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  1381. <param name="options">The secure socket options to when connecting.</param>
  1382. <param name="cancellationToken">The cancellation token.</param>
  1383. <exception cref="T:System.ArgumentNullException">
  1384. <paramref name="host"/> is <c>null</c>.
  1385. </exception>
  1386. <exception cref="T:System.ArgumentOutOfRangeException">
  1387. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  1388. </exception>
  1389. <exception cref="T:System.ArgumentException">
  1390. The <paramref name="host"/> is a zero-length string.
  1391. </exception>
  1392. <exception cref="T:System.ObjectDisposedException">
  1393. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1394. </exception>
  1395. <exception cref="T:System.InvalidOperationException">
  1396. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is already connected.
  1397. </exception>
  1398. <exception cref="T:System.NotSupportedException">
  1399. <paramref name="options"/> was set to
  1400. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  1401. and the IMAP server does not support the STARTTLS extension.
  1402. </exception>
  1403. <exception cref="T:System.OperationCanceledException">
  1404. The operation was canceled via the cancellation token.
  1405. </exception>
  1406. <exception cref="T:System.Net.Sockets.SocketException">
  1407. A socket error occurred trying to connect to the remote host.
  1408. </exception>
  1409. <exception cref="T:System.IO.IOException">
  1410. An I/O error occurred.
  1411. </exception>
  1412. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1413. An IMAP command failed.
  1414. </exception>
  1415. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1416. An IMAP protocol error occurred.
  1417. </exception>
  1418. </member>
  1419. <member name="M:MailKit.Net.Imap.ImapClient.Connect(System.Net.Sockets.Socket,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  1420. <summary>
  1421. Establish a connection to the specified IMAP or IMAP/S server using the provided socket.
  1422. </summary>
  1423. <remarks>
  1424. <para>Establishes a connection to the specified IMAP or IMAP/S server using
  1425. the provided socket.</para>
  1426. <para>If the <paramref name="options"/> has a value of
  1427. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  1428. to determine the default security options. If the <paramref name="port"/> has a value
  1429. of <c>993</c>, then the default options used will be
  1430. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  1431. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  1432. <para>Once a connection is established, properties such as
  1433. <see cref="P:MailKit.Net.Imap.ImapClient.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Imap.ImapClient.Capabilities"/> will be
  1434. populated.</para>
  1435. <note type="info">With the exception of using the <paramref name="port"/> to determine the
  1436. default <see cref="T:MailKit.Security.SecureSocketOptions"/> to use when the <paramref name="options"/> value
  1437. is <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, the <paramref name="host"/> and
  1438. <paramref name="port"/> parameters are only used for logging purposes.</note>
  1439. </remarks>
  1440. <param name="socket">The socket to use for the connection.</param>
  1441. <param name="host">The host name to connect to.</param>
  1442. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  1443. <param name="options">The secure socket options to when connecting.</param>
  1444. <param name="cancellationToken">The cancellation token.</param>
  1445. <exception cref="T:System.ArgumentNullException">
  1446. <para><paramref name="socket"/> is <c>null</c>.</para>
  1447. <para>-or-</para>
  1448. <para><paramref name="host"/> is <c>null</c>.</para>
  1449. </exception>
  1450. <exception cref="T:System.ArgumentOutOfRangeException">
  1451. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  1452. </exception>
  1453. <exception cref="T:System.ArgumentException">
  1454. <para><paramref name="socket"/> is not connected.</para>
  1455. <para>-or-</para>
  1456. <para>The <paramref name="host"/> is a zero-length string.</para>
  1457. </exception>
  1458. <exception cref="T:System.ObjectDisposedException">
  1459. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1460. </exception>
  1461. <exception cref="T:System.InvalidOperationException">
  1462. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is already connected.
  1463. </exception>
  1464. <exception cref="T:System.NotSupportedException">
  1465. <paramref name="options"/> was set to
  1466. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  1467. and the IMAP server does not support the STARTTLS extension.
  1468. </exception>
  1469. <exception cref="T:System.OperationCanceledException">
  1470. The operation was canceled via the cancellation token.
  1471. </exception>
  1472. <exception cref="T:System.IO.IOException">
  1473. An I/O error occurred.
  1474. </exception>
  1475. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1476. An IMAP command failed.
  1477. </exception>
  1478. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1479. An IMAP protocol error occurred.
  1480. </exception>
  1481. </member>
  1482. <member name="M:MailKit.Net.Imap.ImapClient.Connect(System.IO.Stream,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  1483. <summary>
  1484. Establish a connection to the specified IMAP or IMAP/S server using the provided stream.
  1485. </summary>
  1486. <remarks>
  1487. <para>Establishes a connection to the specified IMAP or IMAP/S server using
  1488. the provided stream.</para>
  1489. <para>If the <paramref name="options"/> has a value of
  1490. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  1491. to determine the default security options. If the <paramref name="port"/> has a value
  1492. of <c>993</c>, then the default options used will be
  1493. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  1494. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  1495. <para>Once a connection is established, properties such as
  1496. <see cref="P:MailKit.Net.Imap.ImapClient.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Imap.ImapClient.Capabilities"/> will be
  1497. populated.</para>
  1498. <note type="info">With the exception of using the <paramref name="port"/> to determine the
  1499. default <see cref="T:MailKit.Security.SecureSocketOptions"/> to use when the <paramref name="options"/> value
  1500. is <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, the <paramref name="host"/> and
  1501. <paramref name="port"/> parameters are only used for logging purposes.</note>
  1502. </remarks>
  1503. <param name="stream">The stream to use for the connection.</param>
  1504. <param name="host">The host name to connect to.</param>
  1505. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  1506. <param name="options">The secure socket options to when connecting.</param>
  1507. <param name="cancellationToken">The cancellation token.</param>
  1508. <exception cref="T:System.ArgumentNullException">
  1509. <para><paramref name="stream"/> is <c>null</c>.</para>
  1510. <para>-or-</para>
  1511. <para><paramref name="host"/> is <c>null</c>.</para>
  1512. </exception>
  1513. <exception cref="T:System.ArgumentOutOfRangeException">
  1514. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  1515. </exception>
  1516. <exception cref="T:System.ArgumentException">
  1517. The <paramref name="host"/> is a zero-length string.
  1518. </exception>
  1519. <exception cref="T:System.ObjectDisposedException">
  1520. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1521. </exception>
  1522. <exception cref="T:System.InvalidOperationException">
  1523. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is already connected.
  1524. </exception>
  1525. <exception cref="T:System.NotSupportedException">
  1526. <paramref name="options"/> was set to
  1527. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  1528. and the IMAP server does not support the STARTTLS extension.
  1529. </exception>
  1530. <exception cref="T:System.OperationCanceledException">
  1531. The operation was canceled via the cancellation token.
  1532. </exception>
  1533. <exception cref="T:System.IO.IOException">
  1534. An I/O error occurred.
  1535. </exception>
  1536. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1537. An IMAP command failed.
  1538. </exception>
  1539. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1540. An IMAP protocol error occurred.
  1541. </exception>
  1542. </member>
  1543. <member name="M:MailKit.Net.Imap.ImapClient.Disconnect(System.Boolean,System.Threading.CancellationToken)">
  1544. <summary>
  1545. Disconnect the service.
  1546. </summary>
  1547. <remarks>
  1548. If <paramref name="quit"/> is <c>true</c>, a <c>LOGOUT</c> command will be issued in order to disconnect cleanly.
  1549. </remarks>
  1550. <example>
  1551. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadMessages"/>
  1552. </example>
  1553. <param name="quit">If set to <c>true</c>, a <c>LOGOUT</c> command will be issued in order to disconnect cleanly.</param>
  1554. <param name="cancellationToken">The cancellation token.</param>
  1555. <exception cref="T:System.ObjectDisposedException">
  1556. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1557. </exception>
  1558. </member>
  1559. <member name="M:MailKit.Net.Imap.ImapClient.NoOp(System.Threading.CancellationToken)">
  1560. <summary>
  1561. Ping the IMAP server to keep the connection alive.
  1562. </summary>
  1563. <remarks>
  1564. <para>The <c>NOOP</c> command is typically used to keep the connection with the IMAP server
  1565. alive. When a client goes too long (typically 30 minutes) without sending any commands to the
  1566. IMAP server, the IMAP server will close the connection with the client, forcing the client to
  1567. reconnect before it can send any more commands.</para>
  1568. <para>The <c>NOOP</c> command also provides a great way for a client to check for new
  1569. messages.</para>
  1570. <para>When the IMAP server receives a <c>NOOP</c> command, it will reply to the client with a
  1571. list of pending updates such as <c>EXISTS</c> and <c>RECENT</c> counts on the currently
  1572. selected folder. To receive these notifications, subscribe to the
  1573. <see cref="E:MailKit.MailFolder.CountChanged"/> and <see cref="E:MailKit.MailFolder.RecentChanged"/> events,
  1574. respectively.</para>
  1575. <para>For more information about the <c>NOOP</c> command, see
  1576. <a href="https://tools.ietf.org/html/rfc3501#section-6.1.2">rfc3501</a>.</para>
  1577. </remarks>
  1578. <example>
  1579. <code language="c#" source="Examples\ImapIdleExample.cs"/>
  1580. </example>
  1581. <param name="cancellationToken">The cancellation token.</param>
  1582. <exception cref="T:System.ObjectDisposedException">
  1583. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1584. </exception>
  1585. <exception cref="T:MailKit.ServiceNotConnectedException">
  1586. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1587. </exception>
  1588. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  1589. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  1590. </exception>
  1591. <exception cref="T:System.OperationCanceledException">
  1592. The operation was canceled via the cancellation token.
  1593. </exception>
  1594. <exception cref="T:System.IO.IOException">
  1595. An I/O error occurred.
  1596. </exception>
  1597. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1598. The server replied to the NOOP command with a NO or BAD response.
  1599. </exception>
  1600. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1601. The server responded with an unexpected token.
  1602. </exception>
  1603. </member>
  1604. <member name="M:MailKit.Net.Imap.ImapClient.Idle(System.Threading.CancellationToken,System.Threading.CancellationToken)">
  1605. <summary>
  1606. Toggle the <see cref="T:MailKit.Net.Imap.ImapClient"/> into the IDLE state.
  1607. </summary>
  1608. <remarks>
  1609. <para>When a client enters the IDLE state, the IMAP server will send
  1610. events to the client as they occur on the selected folder. These events
  1611. may include notifications of new messages arriving, expunge notifications,
  1612. flag changes, etc.</para>
  1613. <para>Due to the nature of the IDLE command, a folder must be selected
  1614. before a client can enter into the IDLE state. This can be done by
  1615. opening a folder using
  1616. <see cref="M:MailKit.MailFolder.Open(MailKit.FolderAccess,System.Threading.CancellationToken)"/>
  1617. or any of the other variants.</para>
  1618. <para>While the IDLE command is running, no other commands may be issued until the
  1619. <paramref name="doneToken"/> is cancelled.</para>
  1620. <note type="note">It is especially important to cancel the <paramref name="doneToken"/>
  1621. before cancelling the <paramref name="cancellationToken"/> when using SSL or TLS due to
  1622. the fact that <see cref="T:System.Net.Security.SslStream"/> cannot be polled.</note>
  1623. </remarks>
  1624. <example>
  1625. <code language="c#" source="Examples\ImapIdleExample.cs"/>
  1626. </example>
  1627. <param name="doneToken">The cancellation token used to return to the non-idle state.</param>
  1628. <param name="cancellationToken">The cancellation token.</param>
  1629. <exception cref="T:System.ArgumentException">
  1630. <paramref name="doneToken"/> must be cancellable (i.e. <see cref="P:System.Threading.CancellationToken.None"/> cannot be used).
  1631. </exception>
  1632. <exception cref="T:System.ObjectDisposedException">
  1633. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1634. </exception>
  1635. <exception cref="T:MailKit.ServiceNotConnectedException">
  1636. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1637. </exception>
  1638. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  1639. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  1640. </exception>
  1641. <exception cref="T:System.InvalidOperationException">
  1642. A <see cref="T:MailKit.Net.Imap.ImapFolder"/> has not been opened.
  1643. </exception>
  1644. <exception cref="T:System.NotSupportedException">
  1645. The IMAP server does not support the IDLE extension.
  1646. </exception>
  1647. <exception cref="T:System.OperationCanceledException">
  1648. The operation was canceled via the cancellation token.
  1649. </exception>
  1650. <exception cref="T:System.IO.IOException">
  1651. An I/O error occurred.
  1652. </exception>
  1653. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1654. The server replied to the IDLE command with a NO or BAD response.
  1655. </exception>
  1656. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1657. The server responded with an unexpected token.
  1658. </exception>
  1659. </member>
  1660. <member name="M:MailKit.Net.Imap.ImapClient.Notify(System.Boolean,System.Collections.Generic.IList{MailKit.Net.Imap.ImapEventGroup},System.Threading.CancellationToken)">
  1661. <summary>
  1662. Request the specified notification events from the IMAP server.
  1663. </summary>
  1664. <remarks>
  1665. <para>The <a href="https://tools.ietf.org/html/rfc5465">NOTIFY</a> command is used to expand
  1666. which notifications the client wishes to be notified about, including status notifications
  1667. about folders other than the currently selected folder. It can also be used to automatically
  1668. FETCH information about new messages that have arrived in the currently selected folder.</para>
  1669. <para>This, combined with <see cref="M:MailKit.Net.Imap.ImapClient.Idle(System.Threading.CancellationToken,System.Threading.CancellationToken)"/>,
  1670. can be used to get instant notifications for changes to any of the specified folders.</para>
  1671. </remarks>
  1672. <param name="status"><c>true</c> if the server should immediately notify the client of the
  1673. selected folder's status; otherwise, <c>false</c>.</param>
  1674. <param name="eventGroups">The specific event groups that the client would like to receive notifications for.</param>
  1675. <param name="cancellationToken">The cancellation token.</param>
  1676. <exception cref="T:System.ArgumentNullException">
  1677. <paramref name="eventGroups"/> is <c>null</c>.
  1678. </exception>
  1679. <exception cref="T:System.ArgumentException">
  1680. <paramref name="eventGroups"/> is empty.
  1681. </exception>
  1682. <exception cref="T:System.ObjectDisposedException">
  1683. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1684. </exception>
  1685. <exception cref="T:MailKit.ServiceNotConnectedException">
  1686. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1687. </exception>
  1688. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  1689. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  1690. </exception>
  1691. <exception cref="T:System.InvalidOperationException">
  1692. One or more <see cref="T:MailKit.Net.Imap.ImapEventGroup"/> is invalid.
  1693. </exception>
  1694. <exception cref="T:System.NotSupportedException">
  1695. The IMAP server does not support the NOTIFY extension.
  1696. </exception>
  1697. <exception cref="T:System.OperationCanceledException">
  1698. The operation was canceled via the cancellation token.
  1699. </exception>
  1700. <exception cref="T:System.IO.IOException">
  1701. An I/O error occurred.
  1702. </exception>
  1703. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1704. The server replied to the NOTIFY command with a NO or BAD response.
  1705. </exception>
  1706. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1707. The server responded with an unexpected token.
  1708. </exception>
  1709. </member>
  1710. <member name="M:MailKit.Net.Imap.ImapClient.DisableNotify(System.Threading.CancellationToken)">
  1711. <summary>
  1712. Disable any previously requested notification events from the IMAP server.
  1713. </summary>
  1714. <remarks>
  1715. Disables any notification events requested in a prior call to
  1716. <see cref="M:MailKit.Net.Imap.ImapClient.Notify(System.Boolean,System.Collections.Generic.IList{MailKit.Net.Imap.ImapEventGroup},System.Threading.CancellationToken)"/>.
  1717. request.
  1718. </remarks>
  1719. <param name="cancellationToken">The cancellation token.</param>
  1720. <exception cref="T:System.ObjectDisposedException">
  1721. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1722. </exception>
  1723. <exception cref="T:MailKit.ServiceNotConnectedException">
  1724. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1725. </exception>
  1726. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  1727. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  1728. </exception>
  1729. <exception cref="T:System.NotSupportedException">
  1730. The IMAP server does not support the NOTIFY extension.
  1731. </exception>
  1732. <exception cref="T:System.OperationCanceledException">
  1733. The operation was canceled via the cancellation token.
  1734. </exception>
  1735. <exception cref="T:System.IO.IOException">
  1736. An I/O error occurred.
  1737. </exception>
  1738. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1739. The server replied to the NOTIFY command with a NO or BAD response.
  1740. </exception>
  1741. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1742. The server responded with an unexpected token.
  1743. </exception>
  1744. </member>
  1745. <member name="P:MailKit.Net.Imap.ImapClient.PersonalNamespaces">
  1746. <summary>
  1747. Get the personal namespaces.
  1748. </summary>
  1749. <remarks>
  1750. The personal folder namespaces contain a user's personal mailbox folders.
  1751. </remarks>
  1752. <value>The personal namespaces.</value>
  1753. </member>
  1754. <member name="P:MailKit.Net.Imap.ImapClient.SharedNamespaces">
  1755. <summary>
  1756. Get the shared namespaces.
  1757. </summary>
  1758. <remarks>
  1759. The shared folder namespaces contain mailbox folders that are shared with the user.
  1760. </remarks>
  1761. <value>The shared namespaces.</value>
  1762. </member>
  1763. <member name="P:MailKit.Net.Imap.ImapClient.OtherNamespaces">
  1764. <summary>
  1765. Get the other namespaces.
  1766. </summary>
  1767. <remarks>
  1768. The other folder namespaces contain other mailbox folders.
  1769. </remarks>
  1770. <value>The other namespaces.</value>
  1771. </member>
  1772. <member name="P:MailKit.Net.Imap.ImapClient.SupportsQuotas">
  1773. <summary>
  1774. Get whether or not the mail store supports quotas.
  1775. </summary>
  1776. <remarks>
  1777. Gets whether or not the mail store supports quotas.
  1778. </remarks>
  1779. <value><c>true</c> if the mail store supports quotas; otherwise, <c>false</c>.</value>
  1780. </member>
  1781. <member name="P:MailKit.Net.Imap.ImapClient.Inbox">
  1782. <summary>
  1783. Get the Inbox folder.
  1784. </summary>
  1785. <remarks>
  1786. <para>The Inbox folder is the default folder and always exists on the server.</para>
  1787. <note type="note">This property will only be available after the client has been authenticated.</note>
  1788. </remarks>
  1789. <example>
  1790. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadMessages"/>
  1791. </example>
  1792. <value>The Inbox folder.</value>
  1793. <exception cref="T:System.ObjectDisposedException">
  1794. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1795. </exception>
  1796. <exception cref="T:MailKit.ServiceNotConnectedException">
  1797. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1798. </exception>
  1799. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  1800. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  1801. </exception>
  1802. </member>
  1803. <member name="M:MailKit.Net.Imap.ImapClient.GetFolder(MailKit.SpecialFolder)">
  1804. <summary>
  1805. Get the specified special folder.
  1806. </summary>
  1807. <remarks>
  1808. Not all IMAP servers support special folders. Only IMAP servers
  1809. supporting the <see cref="F:MailKit.Net.Imap.ImapCapabilities.SpecialUse"/> or
  1810. <see cref="F:MailKit.Net.Imap.ImapCapabilities.XList"/> extensions may have
  1811. special folders.
  1812. </remarks>
  1813. <returns>The folder if available; otherwise <c>null</c>.</returns>
  1814. <param name="folder">The type of special folder.</param>
  1815. <exception cref="T:System.ArgumentOutOfRangeException">
  1816. <paramref name="folder"/> is out of range.
  1817. </exception>
  1818. <exception cref="T:System.ObjectDisposedException">
  1819. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1820. </exception>
  1821. <exception cref="T:MailKit.ServiceNotConnectedException">
  1822. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1823. </exception>
  1824. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  1825. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  1826. </exception>
  1827. <exception cref="T:System.NotSupportedException">
  1828. The IMAP server does not support the SPECIAL-USE nor XLIST extensions.
  1829. </exception>
  1830. </member>
  1831. <member name="M:MailKit.Net.Imap.ImapClient.GetFolder(MailKit.FolderNamespace)">
  1832. <summary>
  1833. Get the folder for the specified namespace.
  1834. </summary>
  1835. <remarks>
  1836. Gets the folder for the specified namespace.
  1837. </remarks>
  1838. <returns>The folder.</returns>
  1839. <param name="namespace">The namespace.</param>
  1840. <exception cref="T:System.ArgumentNullException">
  1841. <paramref name="namespace"/> is <c>null</c>.
  1842. </exception>
  1843. <exception cref="T:System.ObjectDisposedException">
  1844. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1845. </exception>
  1846. <exception cref="T:MailKit.ServiceNotConnectedException">
  1847. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1848. </exception>
  1849. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  1850. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  1851. </exception>
  1852. <exception cref="T:MailKit.FolderNotFoundException">
  1853. The folder could not be found.
  1854. </exception>
  1855. </member>
  1856. <member name="M:MailKit.Net.Imap.ImapClient.GetFolders(MailKit.FolderNamespace,MailKit.StatusItems,System.Boolean,System.Threading.CancellationToken)">
  1857. <summary>
  1858. Get all of the folders within the specified namespace.
  1859. </summary>
  1860. <remarks>
  1861. Gets all of the folders within the specified namespace.
  1862. </remarks>
  1863. <returns>The folders.</returns>
  1864. <param name="namespace">The namespace.</param>
  1865. <param name="items">The status items to pre-populate.</param>
  1866. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  1867. <param name="cancellationToken">The cancellation token.</param>
  1868. <exception cref="T:System.ArgumentNullException">
  1869. <paramref name="namespace"/> is <c>null</c>.
  1870. </exception>
  1871. <exception cref="T:System.ObjectDisposedException">
  1872. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1873. </exception>
  1874. <exception cref="T:MailKit.ServiceNotConnectedException">
  1875. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1876. </exception>
  1877. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  1878. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  1879. </exception>
  1880. <exception cref="T:System.OperationCanceledException">
  1881. The operation was canceled via the cancellation token.
  1882. </exception>
  1883. <exception cref="T:MailKit.FolderNotFoundException">
  1884. The namespace folder could not be found.
  1885. </exception>
  1886. <exception cref="T:System.IO.IOException">
  1887. An I/O error occurred.
  1888. </exception>
  1889. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1890. The server replied to the LIST or LSUB command with a NO or BAD response.
  1891. </exception>
  1892. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1893. The server responded with an unexpected token.
  1894. </exception>
  1895. </member>
  1896. <member name="M:MailKit.Net.Imap.ImapClient.GetFolder(System.String,System.Threading.CancellationToken)">
  1897. <summary>
  1898. Get the folder for the specified path.
  1899. </summary>
  1900. <remarks>
  1901. Gets the folder for the specified path.
  1902. </remarks>
  1903. <returns>The folder.</returns>
  1904. <param name="path">The folder path.</param>
  1905. <param name="cancellationToken">The cancellation token.</param>
  1906. <exception cref="T:System.ArgumentNullException">
  1907. <paramref name="path"/> is <c>null</c>.
  1908. </exception>
  1909. <exception cref="T:System.ObjectDisposedException">
  1910. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1911. </exception>
  1912. <exception cref="T:MailKit.ServiceNotConnectedException">
  1913. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1914. </exception>
  1915. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  1916. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  1917. </exception>
  1918. <exception cref="T:System.OperationCanceledException">
  1919. The operation was canceled via the cancellation token.
  1920. </exception>
  1921. <exception cref="T:MailKit.FolderNotFoundException">
  1922. The folder could not be found.
  1923. </exception>
  1924. <exception cref="T:System.IO.IOException">
  1925. An I/O error occurred.
  1926. </exception>
  1927. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1928. The server replied to the IDLE command with a NO or BAD response.
  1929. </exception>
  1930. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1931. The server responded with an unexpected token.
  1932. </exception>
  1933. </member>
  1934. <member name="M:MailKit.Net.Imap.ImapClient.GetMetadata(MailKit.MetadataTag,System.Threading.CancellationToken)">
  1935. <summary>
  1936. Gets the specified metadata.
  1937. </summary>
  1938. <remarks>
  1939. Gets the specified metadata.
  1940. </remarks>
  1941. <returns>The requested metadata value.</returns>
  1942. <param name="tag">The metadata tag.</param>
  1943. <param name="cancellationToken">The cancellation token.</param>
  1944. <exception cref="T:System.ObjectDisposedException">
  1945. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1946. </exception>
  1947. <exception cref="T:MailKit.ServiceNotConnectedException">
  1948. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1949. </exception>
  1950. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  1951. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  1952. </exception>
  1953. <exception cref="T:System.NotSupportedException">
  1954. The IMAP server does not support the METADATA or METADATA-SERVER extension.
  1955. </exception>
  1956. <exception cref="T:System.OperationCanceledException">
  1957. The operation was canceled via the cancellation token.
  1958. </exception>
  1959. <exception cref="T:System.IO.IOException">
  1960. An I/O error occurred.
  1961. </exception>
  1962. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  1963. The server's response contained unexpected tokens.
  1964. </exception>
  1965. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  1966. The server replied with a NO or BAD response.
  1967. </exception>
  1968. </member>
  1969. <member name="M:MailKit.Net.Imap.ImapClient.GetMetadata(MailKit.MetadataOptions,System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  1970. <summary>
  1971. Gets the specified metadata.
  1972. </summary>
  1973. <remarks>
  1974. Gets the specified metadata.
  1975. </remarks>
  1976. <returns>The requested metadata.</returns>
  1977. <param name="options">The metadata options.</param>
  1978. <param name="tags">The metadata tags.</param>
  1979. <param name="cancellationToken">The cancellation token.</param>
  1980. <exception cref="T:System.ArgumentNullException">
  1981. <para><paramref name="options"/> is <c>null</c>.</para>
  1982. <para>-or-</para>
  1983. <para><paramref name="tags"/> is <c>null</c>.</para>
  1984. </exception>
  1985. <exception cref="T:System.ObjectDisposedException">
  1986. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  1987. </exception>
  1988. <exception cref="T:MailKit.ServiceNotConnectedException">
  1989. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  1990. </exception>
  1991. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  1992. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  1993. </exception>
  1994. <exception cref="T:System.NotSupportedException">
  1995. The IMAP server does not support the METADATA or METADATA-SERVER extension.
  1996. </exception>
  1997. <exception cref="T:System.OperationCanceledException">
  1998. The operation was canceled via the cancellation token.
  1999. </exception>
  2000. <exception cref="T:System.IO.IOException">
  2001. An I/O error occurred.
  2002. </exception>
  2003. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2004. The server's response contained unexpected tokens.
  2005. </exception>
  2006. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2007. The server replied with a NO or BAD response.
  2008. </exception>
  2009. </member>
  2010. <member name="M:MailKit.Net.Imap.ImapClient.SetMetadata(MailKit.MetadataCollection,System.Threading.CancellationToken)">
  2011. <summary>
  2012. Sets the specified metadata.
  2013. </summary>
  2014. <remarks>
  2015. Sets the specified metadata.
  2016. </remarks>
  2017. <param name="metadata">The metadata.</param>
  2018. <param name="cancellationToken">The cancellation token.</param>
  2019. <exception cref="T:System.ArgumentNullException">
  2020. <paramref name="metadata"/> is <c>null</c>.
  2021. </exception>
  2022. <exception cref="T:System.ObjectDisposedException">
  2023. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2024. </exception>
  2025. <exception cref="T:MailKit.ServiceNotConnectedException">
  2026. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2027. </exception>
  2028. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2029. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2030. </exception>
  2031. <exception cref="T:System.NotSupportedException">
  2032. The IMAP server does not support the METADATA or METADATA-SERVER extension.
  2033. </exception>
  2034. <exception cref="T:System.OperationCanceledException">
  2035. The operation was canceled via the cancellation token.
  2036. </exception>
  2037. <exception cref="T:System.IO.IOException">
  2038. An I/O error occurred.
  2039. </exception>
  2040. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2041. The server's response contained unexpected tokens.
  2042. </exception>
  2043. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2044. The server replied with a NO or BAD response.
  2045. </exception>
  2046. </member>
  2047. <member name="M:MailKit.Net.Imap.ImapClient.Dispose(System.Boolean)">
  2048. <summary>
  2049. Releases the unmanaged resources used by the <see cref="T:MailKit.Net.Imap.ImapClient"/> and
  2050. optionally releases the managed resources.
  2051. </summary>
  2052. <remarks>
  2053. Releases the unmanaged resources used by the <see cref="T:MailKit.Net.Imap.ImapClient"/> and
  2054. optionally releases the managed resources.
  2055. </remarks>
  2056. <param name="disposing"><c>true</c> to release both managed and unmanaged resources;
  2057. <c>false</c> to release only the unmanaged resources.</param>
  2058. </member>
  2059. <member name="T:MailKit.Net.Imap.IImapClient">
  2060. <summary>
  2061. An interface for an IMAP client.
  2062. </summary>
  2063. <remarks>
  2064. Implemented by <see cref="T:MailKit.Net.Imap.ImapClient"/>.
  2065. </remarks>
  2066. </member>
  2067. <member name="P:MailKit.Net.Imap.IImapClient.Capabilities">
  2068. <summary>
  2069. Get the capabilities supported by the IMAP server.
  2070. </summary>
  2071. <remarks>
  2072. The capabilities will not be known until a successful connection has been made via one of
  2073. the <a href="Overload_MailKit_Net_Imap_ImapClient_Connect.htm">Connect</a> methods and may
  2074. change as a side-effect of calling one of the
  2075. <a href="Overload_MailKit_Net_Imap_ImapClient_Authenticate.htm">Authenticate</a>
  2076. methods.
  2077. </remarks>
  2078. <example>
  2079. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  2080. </example>
  2081. <value>The capabilities.</value>
  2082. <exception cref="T:System.ArgumentException">
  2083. Capabilities cannot be enabled, they may only be disabled.
  2084. </exception>
  2085. </member>
  2086. <member name="P:MailKit.Net.Imap.IImapClient.AppendLimit">
  2087. <summary>
  2088. Gets the maximum size of a message that can be appended to a folder.
  2089. </summary>
  2090. <remarks>
  2091. <para>Gets the maximum size of a message, in bytes, that can be appended to a folder.</para>
  2092. <note type="note">If the value is not set, then the limit is unspecified.</note>
  2093. </remarks>
  2094. <value>The append limit.</value>
  2095. </member>
  2096. <member name="P:MailKit.Net.Imap.IImapClient.InternationalizationLevel">
  2097. <summary>
  2098. Gets the internationalization level supported by the IMAP server.
  2099. </summary>
  2100. <remarks>
  2101. <para>Gets the internationalization level supported by the IMAP server.</para>
  2102. <para>For more information, see
  2103. <a href="https://tools.ietf.org/html/rfc5255#section-4">section 4 of rfc5255</a>.</para>
  2104. </remarks>
  2105. <value>The internationalization level.</value>
  2106. </member>
  2107. <member name="P:MailKit.Net.Imap.IImapClient.Rights">
  2108. <summary>
  2109. Get the access rights supported by the IMAP server.
  2110. </summary>
  2111. <remarks>
  2112. These rights are additional rights supported by the IMAP server beyond the standard rights
  2113. defined in <a href="https://tools.ietf.org/html/rfc4314#section-2.1">section 2.1 of rfc4314</a>
  2114. and will not be populated until the client is successfully connected.
  2115. </remarks>
  2116. <example>
  2117. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  2118. </example>
  2119. <value>The rights.</value>
  2120. </member>
  2121. <member name="P:MailKit.Net.Imap.IImapClient.IsIdle">
  2122. <summary>
  2123. Get whether or not the client is currently in the IDLE state.
  2124. </summary>
  2125. <remarks>
  2126. Gets whether or not the client is currently in the IDLE state.
  2127. </remarks>
  2128. <value><c>true</c> if an IDLE command is active; otherwise, <c>false</c>.</value>
  2129. </member>
  2130. <member name="M:MailKit.Net.Imap.IImapClient.Compress(System.Threading.CancellationToken)">
  2131. <summary>
  2132. Enable compression over the IMAP connection.
  2133. </summary>
  2134. <remarks>
  2135. <para>Enables compression over the IMAP connection.</para>
  2136. <para>If the IMAP server supports the <see cref="F:MailKit.Net.Imap.ImapCapabilities.Compress"/> extension,
  2137. it is possible at any point after connecting to enable compression to reduce network
  2138. bandwidth usage. Ideally, this method should be called before authenticating.</para>
  2139. </remarks>
  2140. <param name="cancellationToken">The cancellation token.</param>
  2141. <exception cref="T:System.ObjectDisposedException">
  2142. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2143. </exception>
  2144. <exception cref="T:MailKit.ServiceNotConnectedException">
  2145. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2146. </exception>
  2147. <exception cref="T:System.InvalidOperationException">
  2148. Compression must be enabled before a folder has been selected.
  2149. </exception>
  2150. <exception cref="T:System.NotSupportedException">
  2151. The IMAP server does not support the <see cref="F:MailKit.Net.Imap.ImapCapabilities.Compress"/> extension.
  2152. </exception>
  2153. <exception cref="T:System.OperationCanceledException">
  2154. The operation was canceled via the cancellation token.
  2155. </exception>
  2156. <exception cref="T:System.IO.IOException">
  2157. An I/O error occurred.
  2158. </exception>
  2159. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2160. The server replied to the COMPRESS command with a NO or BAD response.
  2161. </exception>
  2162. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2163. An IMAP protocol error occurred.
  2164. </exception>
  2165. </member>
  2166. <member name="M:MailKit.Net.Imap.IImapClient.CompressAsync(System.Threading.CancellationToken)">
  2167. <summary>
  2168. Asynchronously enable compression over the IMAP connection.
  2169. </summary>
  2170. <remarks>
  2171. <para>Asynchronously enables compression over the IMAP connection.</para>
  2172. <para>If the IMAP server supports the <see cref="F:MailKit.Net.Imap.ImapCapabilities.Compress"/> extension,
  2173. it is possible at any point after connecting to enable compression to reduce network
  2174. bandwidth usage. Ideally, this method should be called before authenticating.</para>
  2175. </remarks>
  2176. <returns>An asynchronous task context.</returns>
  2177. <param name="cancellationToken">The cancellation token.</param>
  2178. <exception cref="T:System.ObjectDisposedException">
  2179. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2180. </exception>
  2181. <exception cref="T:MailKit.ServiceNotConnectedException">
  2182. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2183. </exception>
  2184. <exception cref="T:System.InvalidOperationException">
  2185. Compression must be enabled before a folder has been selected.
  2186. </exception>
  2187. <exception cref="T:System.NotSupportedException">
  2188. The IMAP server does not support the COMPRESS extension.
  2189. </exception>
  2190. <exception cref="T:System.OperationCanceledException">
  2191. The operation was canceled via the cancellation token.
  2192. </exception>
  2193. <exception cref="T:System.IO.IOException">
  2194. An I/O error occurred.
  2195. </exception>
  2196. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2197. The server replied to the COMPRESS command with a NO or BAD response.
  2198. </exception>
  2199. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2200. An IMAP protocol error occurred.
  2201. </exception>
  2202. </member>
  2203. <member name="M:MailKit.Net.Imap.IImapClient.EnableUTF8(System.Threading.CancellationToken)">
  2204. <summary>
  2205. Enable the UTF8=ACCEPT extension.
  2206. </summary>
  2207. <remarks>
  2208. Enables the <a href="https://tools.ietf.org/html/rfc6855">UTF8=ACCEPT</a> extension.
  2209. </remarks>
  2210. <param name="cancellationToken">The cancellation token.</param>
  2211. <exception cref="T:System.ObjectDisposedException">
  2212. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2213. </exception>
  2214. <exception cref="T:MailKit.ServiceNotConnectedException">
  2215. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2216. </exception>
  2217. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2218. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2219. </exception>
  2220. <exception cref="T:System.InvalidOperationException">
  2221. UTF8=ACCEPT needs to be enabled before selecting a folder.
  2222. </exception>
  2223. <exception cref="T:System.NotSupportedException">
  2224. The IMAP server does not support the UTF8=ACCEPT extension.
  2225. </exception>
  2226. <exception cref="T:System.OperationCanceledException">
  2227. The operation was canceled via the cancellation token.
  2228. </exception>
  2229. <exception cref="T:System.IO.IOException">
  2230. An I/O error occurred.
  2231. </exception>
  2232. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2233. The server replied to the ENABLE command with a NO or BAD response.
  2234. </exception>
  2235. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2236. An IMAP protocol error occurred.
  2237. </exception>
  2238. </member>
  2239. <member name="M:MailKit.Net.Imap.IImapClient.EnableUTF8Async(System.Threading.CancellationToken)">
  2240. <summary>
  2241. Asynchronously enable the UTF8=ACCEPT extension.
  2242. </summary>
  2243. <remarks>
  2244. Enables the <a href="https://tools.ietf.org/html/rfc6855">UTF8=ACCEPT</a> extension.
  2245. </remarks>
  2246. <returns>An asynchronous task context.</returns>
  2247. <param name="cancellationToken">The cancellation token.</param>
  2248. <exception cref="T:System.ObjectDisposedException">
  2249. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2250. </exception>
  2251. <exception cref="T:MailKit.ServiceNotConnectedException">
  2252. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2253. </exception>
  2254. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2255. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2256. </exception>
  2257. <exception cref="T:System.InvalidOperationException">
  2258. UTF8=ACCEPT needs to be enabled before selecting a folder.
  2259. </exception>
  2260. <exception cref="T:System.NotSupportedException">
  2261. The IMAP server does not support the UTF8=ACCEPT extension.
  2262. </exception>
  2263. <exception cref="T:System.OperationCanceledException">
  2264. The operation was canceled via the cancellation token.
  2265. </exception>
  2266. <exception cref="T:System.IO.IOException">
  2267. An I/O error occurred.
  2268. </exception>
  2269. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2270. The server replied to the ENABLE command with a NO or BAD response.
  2271. </exception>
  2272. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2273. An IMAP protocol error occurred.
  2274. </exception>
  2275. </member>
  2276. <member name="M:MailKit.Net.Imap.IImapClient.Identify(MailKit.Net.Imap.ImapImplementation,System.Threading.CancellationToken)">
  2277. <summary>
  2278. Identify the client implementation to the server and obtain the server implementation details.
  2279. </summary>
  2280. <remarks>
  2281. <para>Passes along the client implementation details to the server while also obtaining implementation
  2282. details from the server.</para>
  2283. <para>If the <paramref name="clientImplementation"/> is <c>null</c> or no properties have been set, no
  2284. identifying information will be sent to the server.</para>
  2285. <note type="security">
  2286. <para>Security Implications</para>
  2287. <para>This command has the danger of violating the privacy of users if misused. Clients should
  2288. notify users that they send the ID command.</para>
  2289. <para>It is highly desirable that implementations provide a method of disabling ID support, perhaps by
  2290. not calling this method at all, or by passing <c>null</c> as the <paramref name="clientImplementation"/>
  2291. argument.</para>
  2292. <para>Implementors must exercise extreme care in adding properties to the <paramref name="clientImplementation"/>.
  2293. Some properties, such as a processor ID number, Ethernet address, or other unique (or mostly unique) identifier
  2294. would allow tracking of users in ways that violate user privacy expectations and may also make it easier for
  2295. attackers to exploit security holes in the client.</para>
  2296. </note>
  2297. </remarks>
  2298. <example>
  2299. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  2300. </example>
  2301. <returns>The implementation details of the server if available; otherwise, <c>null</c>.</returns>
  2302. <param name="clientImplementation">The client implementation.</param>
  2303. <param name="cancellationToken">The cancellation token.</param>
  2304. <exception cref="T:System.ObjectDisposedException">
  2305. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2306. </exception>
  2307. <exception cref="T:MailKit.ServiceNotConnectedException">
  2308. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2309. </exception>
  2310. <exception cref="T:System.NotSupportedException">
  2311. The IMAP server does not support the ID extension.
  2312. </exception>
  2313. <exception cref="T:System.OperationCanceledException">
  2314. The operation was canceled via the cancellation token.
  2315. </exception>
  2316. <exception cref="T:System.IO.IOException">
  2317. An I/O error occurred.
  2318. </exception>
  2319. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2320. The server replied to the ID command with a NO or BAD response.
  2321. </exception>
  2322. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2323. An IMAP protocol error occurred.
  2324. </exception>
  2325. </member>
  2326. <member name="M:MailKit.Net.Imap.IImapClient.IdentifyAsync(MailKit.Net.Imap.ImapImplementation,System.Threading.CancellationToken)">
  2327. <summary>
  2328. Asynchronously identify the client implementation to the server and obtain the server implementation details.
  2329. </summary>
  2330. <remarks>
  2331. <para>Passes along the client implementation details to the server while also obtaining implementation
  2332. details from the server.</para>
  2333. <para>If the <paramref name="clientImplementation"/> is <c>null</c> or no properties have been set, no
  2334. identifying information will be sent to the server.</para>
  2335. <note type="security">
  2336. <para>Security Implications</para>
  2337. <para>This command has the danger of violating the privacy of users if misused. Clients should
  2338. notify users that they send the ID command.</para>
  2339. <para>It is highly desirable that implementations provide a method of disabling ID support, perhaps by
  2340. not calling this method at all, or by passing <c>null</c> as the <paramref name="clientImplementation"/>
  2341. argument.</para>
  2342. <para>Implementors must exercise extreme care in adding properties to the <paramref name="clientImplementation"/>.
  2343. Some properties, such as a processor ID number, Ethernet address, or other unique (or mostly unique) identifier
  2344. would allow tracking of users in ways that violate user privacy expectations and may also make it easier for
  2345. attackers to exploit security holes in the client.</para>
  2346. </note>
  2347. </remarks>
  2348. <returns>The implementation details of the server if available; otherwise, <c>null</c>.</returns>
  2349. <param name="clientImplementation">The client implementation.</param>
  2350. <param name="cancellationToken">The cancellation token.</param>
  2351. <exception cref="T:System.ObjectDisposedException">
  2352. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2353. </exception>
  2354. <exception cref="T:MailKit.ServiceNotConnectedException">
  2355. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2356. </exception>
  2357. <exception cref="T:System.NotSupportedException">
  2358. The IMAP server does not support the ID extension.
  2359. </exception>
  2360. <exception cref="T:System.OperationCanceledException">
  2361. The operation was canceled via the cancellation token.
  2362. </exception>
  2363. <exception cref="T:System.IO.IOException">
  2364. An I/O error occurred.
  2365. </exception>
  2366. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2367. The server replied to the ID command with a NO or BAD response.
  2368. </exception>
  2369. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2370. An IMAP protocol error occurred.
  2371. </exception>
  2372. </member>
  2373. <member name="M:MailKit.Net.Imap.IImapClient.Idle(System.Threading.CancellationToken,System.Threading.CancellationToken)">
  2374. <summary>
  2375. Toggle the <see cref="T:MailKit.Net.Imap.ImapClient"/> into the IDLE state.
  2376. </summary>
  2377. <remarks>
  2378. <para>When a client enters the IDLE state, the IMAP server will send
  2379. events to the client as they occur on the selected folder. These events
  2380. may include notifications of new messages arriving, expunge notifications,
  2381. flag changes, etc.</para>
  2382. <para>Due to the nature of the IDLE command, a folder must be selected
  2383. before a client can enter into the IDLE state. This can be done by
  2384. opening a folder using
  2385. <see cref="M:MailKit.MailFolder.Open(MailKit.FolderAccess,System.Threading.CancellationToken)"/>
  2386. or any of the other variants.</para>
  2387. <para>While the IDLE command is running, no other commands may be issued until the
  2388. <paramref name="doneToken"/> is cancelled.</para>
  2389. <note type="note">It is especially important to cancel the <paramref name="doneToken"/>
  2390. before cancelling the <paramref name="cancellationToken"/> when using SSL or TLS due to
  2391. the fact that <see cref="T:System.Net.Security.SslStream"/> cannot be polled.</note>
  2392. </remarks>
  2393. <example>
  2394. <code language="c#" source="Examples\ImapIdleExample.cs"/>
  2395. </example>
  2396. <param name="doneToken">The cancellation token used to return to the non-idle state.</param>
  2397. <param name="cancellationToken">The cancellation token.</param>
  2398. <exception cref="T:System.ArgumentException">
  2399. <paramref name="doneToken"/> must be cancellable (i.e. <see cref="P:System.Threading.CancellationToken.None"/> cannot be used).
  2400. </exception>
  2401. <exception cref="T:System.ObjectDisposedException">
  2402. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2403. </exception>
  2404. <exception cref="T:MailKit.ServiceNotConnectedException">
  2405. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2406. </exception>
  2407. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2408. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2409. </exception>
  2410. <exception cref="T:System.InvalidOperationException">
  2411. A <see cref="T:MailKit.Net.Imap.ImapFolder"/> has not been opened.
  2412. </exception>
  2413. <exception cref="T:System.NotSupportedException">
  2414. The IMAP server does not support the IDLE extension.
  2415. </exception>
  2416. <exception cref="T:System.OperationCanceledException">
  2417. The operation was canceled via the cancellation token.
  2418. </exception>
  2419. <exception cref="T:System.IO.IOException">
  2420. An I/O error occurred.
  2421. </exception>
  2422. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2423. The server replied to the IDLE command with a NO or BAD response.
  2424. </exception>
  2425. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2426. The server responded with an unexpected token.
  2427. </exception>
  2428. </member>
  2429. <member name="M:MailKit.Net.Imap.IImapClient.IdleAsync(System.Threading.CancellationToken,System.Threading.CancellationToken)">
  2430. <summary>
  2431. Asynchronously toggle the <see cref="T:MailKit.Net.Imap.ImapClient"/> into the IDLE state.
  2432. </summary>
  2433. <remarks>
  2434. <para>When a client enters the IDLE state, the IMAP server will send
  2435. events to the client as they occur on the selected folder. These events
  2436. may include notifications of new messages arriving, expunge notifications,
  2437. flag changes, etc.</para>
  2438. <para>Due to the nature of the IDLE command, a folder must be selected
  2439. before a client can enter into the IDLE state. This can be done by
  2440. opening a folder using
  2441. <see cref="M:MailKit.MailFolder.Open(MailKit.FolderAccess,System.Threading.CancellationToken)"/>
  2442. or any of the other variants.</para>
  2443. <para>While the IDLE command is running, no other commands may be issued until the
  2444. <paramref name="doneToken"/> is cancelled.</para>
  2445. <note type="note">It is especially important to cancel the <paramref name="doneToken"/>
  2446. before cancelling the <paramref name="cancellationToken"/> when using SSL or TLS due to
  2447. the fact that <see cref="T:System.Net.Security.SslStream"/> cannot be polled.</note>
  2448. </remarks>
  2449. <returns>An asynchronous task context.</returns>
  2450. <param name="doneToken">The cancellation token used to return to the non-idle state.</param>
  2451. <param name="cancellationToken">The cancellation token.</param>
  2452. <exception cref="T:System.ArgumentException">
  2453. <paramref name="doneToken"/> must be cancellable (i.e. <see cref="P:System.Threading.CancellationToken.None"/> cannot be used).
  2454. </exception>
  2455. <exception cref="T:System.ObjectDisposedException">
  2456. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2457. </exception>
  2458. <exception cref="T:MailKit.ServiceNotConnectedException">
  2459. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2460. </exception>
  2461. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2462. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2463. </exception>
  2464. <exception cref="T:System.InvalidOperationException">
  2465. A <see cref="T:MailKit.Net.Imap.ImapFolder"/> has not been opened.
  2466. </exception>
  2467. <exception cref="T:System.NotSupportedException">
  2468. The IMAP server does not support the IDLE extension.
  2469. </exception>
  2470. <exception cref="T:System.OperationCanceledException">
  2471. The operation was canceled via the cancellation token.
  2472. </exception>
  2473. <exception cref="T:System.IO.IOException">
  2474. An I/O error occurred.
  2475. </exception>
  2476. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2477. The server replied to the IDLE command with a NO or BAD response.
  2478. </exception>
  2479. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2480. The server responded with an unexpected token.
  2481. </exception>
  2482. </member>
  2483. <member name="M:MailKit.Net.Imap.IImapClient.Notify(System.Boolean,System.Collections.Generic.IList{MailKit.Net.Imap.ImapEventGroup},System.Threading.CancellationToken)">
  2484. <summary>
  2485. Request the specified notification events from the IMAP server.
  2486. </summary>
  2487. <remarks>
  2488. <para>The <a href="https://tools.ietf.org/html/rfc5465">NOTIFY</a> command is used to expand
  2489. which notifications the client wishes to be notified about, including status notifications
  2490. about folders other than the currently selected folder. It can also be used to automatically
  2491. FETCH information about new messages that have arrived in the currently selected folder.</para>
  2492. <para>This, combined with <see cref="M:MailKit.Net.Imap.IImapClient.Idle(System.Threading.CancellationToken,System.Threading.CancellationToken)"/>,
  2493. can be used to get instant notifications for changes to any of the specified folders.</para>
  2494. </remarks>
  2495. <param name="status"><c>true</c> if the server should immediately notify the client of the
  2496. selected folder's status; otherwise, <c>false</c>.</param>
  2497. <param name="eventGroups">The specific event groups that the client would like to receive notifications for.</param>
  2498. <param name="cancellationToken">The cancellation token.</param>
  2499. <exception cref="T:System.ArgumentNullException">
  2500. <paramref name="eventGroups"/> is <c>null</c>.
  2501. </exception>
  2502. <exception cref="T:System.ArgumentException">
  2503. <paramref name="eventGroups"/> is empty.
  2504. </exception>
  2505. <exception cref="T:System.ObjectDisposedException">
  2506. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2507. </exception>
  2508. <exception cref="T:MailKit.ServiceNotConnectedException">
  2509. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2510. </exception>
  2511. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2512. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2513. </exception>
  2514. <exception cref="T:System.InvalidOperationException">
  2515. One or more <see cref="T:MailKit.Net.Imap.ImapEventGroup"/> is invalid.
  2516. </exception>
  2517. <exception cref="T:System.NotSupportedException">
  2518. The IMAP server does not support the NOTIFY extension.
  2519. </exception>
  2520. <exception cref="T:System.OperationCanceledException">
  2521. The operation was canceled via the cancellation token.
  2522. </exception>
  2523. <exception cref="T:System.IO.IOException">
  2524. An I/O error occurred.
  2525. </exception>
  2526. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2527. The server replied to the NOTIFY command with a NO or BAD response.
  2528. </exception>
  2529. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2530. The server responded with an unexpected token.
  2531. </exception>
  2532. </member>
  2533. <member name="M:MailKit.Net.Imap.IImapClient.NotifyAsync(System.Boolean,System.Collections.Generic.IList{MailKit.Net.Imap.ImapEventGroup},System.Threading.CancellationToken)">
  2534. <summary>
  2535. Asynchronously request the specified notification events from the IMAP server.
  2536. </summary>
  2537. <remarks>
  2538. <para>The <a href="https://tools.ietf.org/html/rfc5465">NOTIFY</a> command is used to expand
  2539. which notifications the client wishes to be notified about, including status notifications
  2540. about folders other than the currently selected folder. It can also be used to automatically
  2541. FETCH information about new messages that have arrived in the currently selected folder.</para>
  2542. <para>This, combined with <see cref="M:MailKit.Net.Imap.IImapClient.IdleAsync(System.Threading.CancellationToken,System.Threading.CancellationToken)"/>,
  2543. can be used to get instant notifications for changes to any of the specified folders.</para>
  2544. </remarks>
  2545. <returns>An asynchronous task context.</returns>
  2546. <param name="status"><c>true</c> if the server should immediately notify the client of the
  2547. selected folder's status; otherwise, <c>false</c>.</param>
  2548. <param name="eventGroups">The specific event groups that the client would like to receive notifications for.</param>
  2549. <param name="cancellationToken">The cancellation token.</param>
  2550. <exception cref="T:System.ArgumentNullException">
  2551. <paramref name="eventGroups"/> is <c>null</c>.
  2552. </exception>
  2553. <exception cref="T:System.ArgumentException">
  2554. <paramref name="eventGroups"/> is empty.
  2555. </exception>
  2556. <exception cref="T:System.ObjectDisposedException">
  2557. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2558. </exception>
  2559. <exception cref="T:MailKit.ServiceNotConnectedException">
  2560. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2561. </exception>
  2562. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2563. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2564. </exception>
  2565. <exception cref="T:System.InvalidOperationException">
  2566. One or more <see cref="T:MailKit.Net.Imap.ImapEventGroup"/> is invalid.
  2567. </exception>
  2568. <exception cref="T:System.NotSupportedException">
  2569. The IMAP server does not support the NOTIFY extension.
  2570. </exception>
  2571. <exception cref="T:System.OperationCanceledException">
  2572. The operation was canceled via the cancellation token.
  2573. </exception>
  2574. <exception cref="T:System.IO.IOException">
  2575. An I/O error occurred.
  2576. </exception>
  2577. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2578. The server replied to the NOTIFY command with a NO or BAD response.
  2579. </exception>
  2580. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2581. The server responded with an unexpected token.
  2582. </exception>
  2583. </member>
  2584. <member name="M:MailKit.Net.Imap.IImapClient.DisableNotify(System.Threading.CancellationToken)">
  2585. <summary>
  2586. Disable any previously requested notification events from the IMAP server.
  2587. </summary>
  2588. <remarks>
  2589. Disables any notification events requested in a prior call to
  2590. <see cref="M:MailKit.Net.Imap.IImapClient.Notify(System.Boolean,System.Collections.Generic.IList{MailKit.Net.Imap.ImapEventGroup},System.Threading.CancellationToken)"/>.
  2591. request.
  2592. </remarks>
  2593. <param name="cancellationToken">The cancellation token.</param>
  2594. <exception cref="T:System.ObjectDisposedException">
  2595. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2596. </exception>
  2597. <exception cref="T:MailKit.ServiceNotConnectedException">
  2598. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2599. </exception>
  2600. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2601. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2602. </exception>
  2603. <exception cref="T:System.NotSupportedException">
  2604. The IMAP server does not support the NOTIFY extension.
  2605. </exception>
  2606. <exception cref="T:System.OperationCanceledException">
  2607. The operation was canceled via the cancellation token.
  2608. </exception>
  2609. <exception cref="T:System.IO.IOException">
  2610. An I/O error occurred.
  2611. </exception>
  2612. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2613. The server replied to the NOTIFY command with a NO or BAD response.
  2614. </exception>
  2615. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2616. The server responded with an unexpected token.
  2617. </exception>
  2618. </member>
  2619. <member name="M:MailKit.Net.Imap.IImapClient.DisableNotifyAsync(System.Threading.CancellationToken)">
  2620. <summary>
  2621. Asynchronously disable any previously requested notification events from the IMAP server.
  2622. </summary>
  2623. <remarks>
  2624. Disables any notification events requested in a prior call to
  2625. <see cref="M:MailKit.Net.Imap.IImapClient.NotifyAsync(System.Boolean,System.Collections.Generic.IList{MailKit.Net.Imap.ImapEventGroup},System.Threading.CancellationToken)"/>.
  2626. request.
  2627. </remarks>
  2628. <returns>An asynchronous task context.</returns>
  2629. <param name="cancellationToken">The cancellation token.</param>
  2630. <exception cref="T:System.ObjectDisposedException">
  2631. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2632. </exception>
  2633. <exception cref="T:MailKit.ServiceNotConnectedException">
  2634. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2635. </exception>
  2636. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2637. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2638. </exception>
  2639. <exception cref="T:System.NotSupportedException">
  2640. The IMAP server does not support the NOTIFY extension.
  2641. </exception>
  2642. <exception cref="T:System.OperationCanceledException">
  2643. The operation was canceled via the cancellation token.
  2644. </exception>
  2645. <exception cref="T:System.IO.IOException">
  2646. An I/O error occurred.
  2647. </exception>
  2648. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2649. The server replied to the NOTIFY command with a NO or BAD response.
  2650. </exception>
  2651. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2652. The server responded with an unexpected token.
  2653. </exception>
  2654. </member>
  2655. <member name="T:MailKit.Net.Imap.IImapFolder">
  2656. <summary>
  2657. An interface for an IMAP folder.
  2658. </summary>
  2659. <remarks>
  2660. Implemented by <see cref="T:MailKit.Net.Imap.ImapFolder"/>.
  2661. </remarks>
  2662. <example>
  2663. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadMessages"/>
  2664. </example>
  2665. <example>
  2666. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  2667. </example>
  2668. </member>
  2669. <member name="M:MailKit.Net.Imap.IImapFolder.GetHeaders(MailKit.UniqueId,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  2670. <summary>
  2671. Get the specified body part headers.
  2672. </summary>
  2673. <remarks>
  2674. Gets the specified body part headers.
  2675. </remarks>
  2676. <returns>The body part headers.</returns>
  2677. <param name="uid">The UID of the message.</param>
  2678. <param name="partSpecifier">The body part specifier.</param>
  2679. <param name="cancellationToken">The cancellation token.</param>
  2680. <param name="progress">The progress reporting mechanism.</param>
  2681. <exception cref="T:System.ArgumentNullException">
  2682. <paramref name="partSpecifier"/> is <c>null</c>.
  2683. </exception>
  2684. <exception cref="T:System.ArgumentException">
  2685. <paramref name="uid"/> is invalid.
  2686. </exception>
  2687. <exception cref="T:System.ObjectDisposedException">
  2688. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2689. </exception>
  2690. <exception cref="T:MailKit.ServiceNotConnectedException">
  2691. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2692. </exception>
  2693. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2694. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2695. </exception>
  2696. <exception cref="T:MailKit.FolderNotOpenException">
  2697. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  2698. </exception>
  2699. <exception cref="T:MailKit.MessageNotFoundException">
  2700. The IMAP server did not return the requested body part headers.
  2701. </exception>
  2702. <exception cref="T:System.OperationCanceledException">
  2703. The operation was canceled via the cancellation token.
  2704. </exception>
  2705. <exception cref="T:System.IO.IOException">
  2706. An I/O error occurred.
  2707. </exception>
  2708. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2709. The server's response contained unexpected tokens.
  2710. </exception>
  2711. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2712. The server replied with a NO or BAD response.
  2713. </exception>
  2714. </member>
  2715. <member name="M:MailKit.Net.Imap.IImapFolder.GetHeadersAsync(MailKit.UniqueId,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  2716. <summary>
  2717. Asynchronously get the specified body part headers.
  2718. </summary>
  2719. <remarks>
  2720. Gets the specified body part headers.
  2721. </remarks>
  2722. <returns>The body part headers.</returns>
  2723. <param name="uid">The UID of the message.</param>
  2724. <param name="partSpecifier">The body part specifier.</param>
  2725. <param name="cancellationToken">The cancellation token.</param>
  2726. <param name="progress">The progress reporting mechanism.</param>
  2727. <exception cref="T:System.ArgumentNullException">
  2728. <paramref name="partSpecifier"/> is <c>null</c>.
  2729. </exception>
  2730. <exception cref="T:System.ArgumentException">
  2731. <paramref name="uid"/> is invalid.
  2732. </exception>
  2733. <exception cref="T:System.ObjectDisposedException">
  2734. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2735. </exception>
  2736. <exception cref="T:MailKit.ServiceNotConnectedException">
  2737. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2738. </exception>
  2739. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2740. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2741. </exception>
  2742. <exception cref="T:MailKit.FolderNotOpenException">
  2743. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  2744. </exception>
  2745. <exception cref="T:MailKit.MessageNotFoundException">
  2746. The IMAP server did not return the requested body part headers.
  2747. </exception>
  2748. <exception cref="T:System.OperationCanceledException">
  2749. The operation was canceled via the cancellation token.
  2750. </exception>
  2751. <exception cref="T:System.IO.IOException">
  2752. An I/O error occurred.
  2753. </exception>
  2754. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2755. The server's response contained unexpected tokens.
  2756. </exception>
  2757. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2758. The server replied with a NO or BAD response.
  2759. </exception>
  2760. </member>
  2761. <member name="M:MailKit.Net.Imap.IImapFolder.GetHeaders(System.Int32,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  2762. <summary>
  2763. Get the specified body part headers.
  2764. </summary>
  2765. <remarks>
  2766. Gets the specified body part headers.
  2767. </remarks>
  2768. <returns>The body part headers.</returns>
  2769. <param name="index">The index of the message.</param>
  2770. <param name="partSpecifier">The body part specifier.</param>
  2771. <param name="cancellationToken">The cancellation token.</param>
  2772. <param name="progress">The progress reporting mechanism.</param>
  2773. <exception cref="T:System.ArgumentOutOfRangeException">
  2774. <paramref name="index"/> is out of range.
  2775. </exception>
  2776. <exception cref="T:System.ArgumentNullException">
  2777. <paramref name="partSpecifier"/> is <c>null</c>.
  2778. </exception>
  2779. <exception cref="T:System.ObjectDisposedException">
  2780. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2781. </exception>
  2782. <exception cref="T:MailKit.ServiceNotConnectedException">
  2783. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2784. </exception>
  2785. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2786. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2787. </exception>
  2788. <exception cref="T:MailKit.FolderNotOpenException">
  2789. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  2790. </exception>
  2791. <exception cref="T:MailKit.MessageNotFoundException">
  2792. The IMAP server did not return the requested body part headers.
  2793. </exception>
  2794. <exception cref="T:System.OperationCanceledException">
  2795. The operation was canceled via the cancellation token.
  2796. </exception>
  2797. <exception cref="T:System.IO.IOException">
  2798. An I/O error occurred.
  2799. </exception>
  2800. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2801. The server's response contained unexpected tokens.
  2802. </exception>
  2803. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2804. The server replied with a NO or BAD response.
  2805. </exception>
  2806. </member>
  2807. <member name="M:MailKit.Net.Imap.IImapFolder.GetHeadersAsync(System.Int32,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  2808. <summary>
  2809. Asynchronously get the specified body part headers.
  2810. </summary>
  2811. <remarks>
  2812. Gets the specified body part headers.
  2813. </remarks>
  2814. <returns>The body part headers.</returns>
  2815. <param name="index">The index of the message.</param>
  2816. <param name="partSpecifier">The body part specifier.</param>
  2817. <param name="cancellationToken">The cancellation token.</param>
  2818. <param name="progress">The progress reporting mechanism.</param>
  2819. <exception cref="T:System.ArgumentOutOfRangeException">
  2820. <paramref name="index"/> is out of range.
  2821. </exception>
  2822. <exception cref="T:System.ArgumentNullException">
  2823. <paramref name="partSpecifier"/> is <c>null</c>.
  2824. </exception>
  2825. <exception cref="T:System.ObjectDisposedException">
  2826. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2827. </exception>
  2828. <exception cref="T:MailKit.ServiceNotConnectedException">
  2829. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2830. </exception>
  2831. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2832. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2833. </exception>
  2834. <exception cref="T:MailKit.FolderNotOpenException">
  2835. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  2836. </exception>
  2837. <exception cref="T:MailKit.MessageNotFoundException">
  2838. The IMAP server did not return the requested body part headers.
  2839. </exception>
  2840. <exception cref="T:System.OperationCanceledException">
  2841. The operation was canceled via the cancellation token.
  2842. </exception>
  2843. <exception cref="T:System.IO.IOException">
  2844. An I/O error occurred.
  2845. </exception>
  2846. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2847. The server's response contained unexpected tokens.
  2848. </exception>
  2849. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2850. The server replied with a NO or BAD response.
  2851. </exception>
  2852. </member>
  2853. <member name="M:MailKit.Net.Imap.IImapFolder.GetBodyPart(MailKit.UniqueId,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  2854. <summary>
  2855. Get the specified body part.
  2856. </summary>
  2857. <remarks>
  2858. Gets the specified body part.
  2859. </remarks>
  2860. <returns>The body part.</returns>
  2861. <param name="uid">The UID of the message.</param>
  2862. <param name="partSpecifier">The body part specifier.</param>
  2863. <param name="cancellationToken">The cancellation token.</param>
  2864. <param name="progress">The progress reporting mechanism.</param>
  2865. <exception cref="T:System.ArgumentNullException">
  2866. <paramref name="partSpecifier"/> is <c>null</c>.
  2867. </exception>
  2868. <exception cref="T:System.ArgumentException">
  2869. <paramref name="uid"/> is invalid.
  2870. </exception>
  2871. <exception cref="T:System.ObjectDisposedException">
  2872. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2873. </exception>
  2874. <exception cref="T:MailKit.ServiceNotConnectedException">
  2875. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2876. </exception>
  2877. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2878. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2879. </exception>
  2880. <exception cref="T:MailKit.FolderNotOpenException">
  2881. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  2882. </exception>
  2883. <exception cref="T:MailKit.MessageNotFoundException">
  2884. The IMAP server did not return the requested message body.
  2885. </exception>
  2886. <exception cref="T:System.OperationCanceledException">
  2887. The operation was canceled via the cancellation token.
  2888. </exception>
  2889. <exception cref="T:System.IO.IOException">
  2890. An I/O error occurred.
  2891. </exception>
  2892. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2893. The server's response contained unexpected tokens.
  2894. </exception>
  2895. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2896. The server replied with a NO or BAD response.
  2897. </exception>
  2898. </member>
  2899. <member name="M:MailKit.Net.Imap.IImapFolder.GetBodyPartAsync(MailKit.UniqueId,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  2900. <summary>
  2901. Asynchronously get the specified body part.
  2902. </summary>
  2903. <remarks>
  2904. Gets the specified body part.
  2905. </remarks>
  2906. <returns>The body part.</returns>
  2907. <param name="uid">The UID of the message.</param>
  2908. <param name="partSpecifier">The body part specifier.</param>
  2909. <param name="cancellationToken">The cancellation token.</param>
  2910. <param name="progress">The progress reporting mechanism.</param>
  2911. <exception cref="T:System.ArgumentNullException">
  2912. <paramref name="partSpecifier"/> is <c>null</c>.
  2913. </exception>
  2914. <exception cref="T:System.ArgumentException">
  2915. <paramref name="uid"/> is invalid.
  2916. </exception>
  2917. <exception cref="T:System.ObjectDisposedException">
  2918. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2919. </exception>
  2920. <exception cref="T:MailKit.ServiceNotConnectedException">
  2921. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2922. </exception>
  2923. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2924. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2925. </exception>
  2926. <exception cref="T:MailKit.FolderNotOpenException">
  2927. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  2928. </exception>
  2929. <exception cref="T:MailKit.MessageNotFoundException">
  2930. The IMAP server did not return the requested message body.
  2931. </exception>
  2932. <exception cref="T:System.OperationCanceledException">
  2933. The operation was canceled via the cancellation token.
  2934. </exception>
  2935. <exception cref="T:System.IO.IOException">
  2936. An I/O error occurred.
  2937. </exception>
  2938. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2939. The server's response contained unexpected tokens.
  2940. </exception>
  2941. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2942. The server replied with a NO or BAD response.
  2943. </exception>
  2944. </member>
  2945. <member name="M:MailKit.Net.Imap.IImapFolder.GetBodyPart(System.Int32,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  2946. <summary>
  2947. Get the specified body part.
  2948. </summary>
  2949. <remarks>
  2950. Gets the specified body part.
  2951. </remarks>
  2952. <returns>The body part.</returns>
  2953. <param name="index">The index of the message.</param>
  2954. <param name="partSpecifier">The body part specifier.</param>
  2955. <param name="cancellationToken">The cancellation token.</param>
  2956. <param name="progress">The progress reporting mechanism.</param>
  2957. <exception cref="T:System.ArgumentNullException">
  2958. <paramref name="partSpecifier"/> is <c>null</c>.
  2959. </exception>
  2960. <exception cref="T:System.ArgumentOutOfRangeException">
  2961. <paramref name="index"/> is out of range.
  2962. </exception>
  2963. <exception cref="T:System.ObjectDisposedException">
  2964. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  2965. </exception>
  2966. <exception cref="T:MailKit.ServiceNotConnectedException">
  2967. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  2968. </exception>
  2969. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  2970. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  2971. </exception>
  2972. <exception cref="T:MailKit.FolderNotOpenException">
  2973. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  2974. </exception>
  2975. <exception cref="T:MailKit.MessageNotFoundException">
  2976. The IMAP server did not return the requested message.
  2977. </exception>
  2978. <exception cref="T:System.OperationCanceledException">
  2979. The operation was canceled via the cancellation token.
  2980. </exception>
  2981. <exception cref="T:System.IO.IOException">
  2982. An I/O error occurred.
  2983. </exception>
  2984. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  2985. The server's response contained unexpected tokens.
  2986. </exception>
  2987. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  2988. The server replied with a NO or BAD response.
  2989. </exception>
  2990. </member>
  2991. <member name="M:MailKit.Net.Imap.IImapFolder.GetBodyPartAsync(System.Int32,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  2992. <summary>
  2993. Asynchronously get the specified body part.
  2994. </summary>
  2995. <remarks>
  2996. Gets the specified body part.
  2997. </remarks>
  2998. <returns>The body part.</returns>
  2999. <param name="index">The index of the message.</param>
  3000. <param name="partSpecifier">The body part specifier.</param>
  3001. <param name="cancellationToken">The cancellation token.</param>
  3002. <param name="progress">The progress reporting mechanism.</param>
  3003. <exception cref="T:System.ArgumentNullException">
  3004. <paramref name="partSpecifier"/> is <c>null</c>.
  3005. </exception>
  3006. <exception cref="T:System.ArgumentOutOfRangeException">
  3007. <paramref name="index"/> is out of range.
  3008. </exception>
  3009. <exception cref="T:System.ObjectDisposedException">
  3010. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  3011. </exception>
  3012. <exception cref="T:MailKit.ServiceNotConnectedException">
  3013. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  3014. </exception>
  3015. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  3016. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  3017. </exception>
  3018. <exception cref="T:MailKit.FolderNotOpenException">
  3019. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  3020. </exception>
  3021. <exception cref="T:MailKit.MessageNotFoundException">
  3022. The IMAP server did not return the requested message.
  3023. </exception>
  3024. <exception cref="T:System.OperationCanceledException">
  3025. The operation was canceled via the cancellation token.
  3026. </exception>
  3027. <exception cref="T:System.IO.IOException">
  3028. An I/O error occurred.
  3029. </exception>
  3030. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  3031. The server's response contained unexpected tokens.
  3032. </exception>
  3033. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  3034. The server replied with a NO or BAD response.
  3035. </exception>
  3036. </member>
  3037. <member name="M:MailKit.Net.Imap.IImapFolder.GetStreams(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Net.Imap.ImapFetchStreamCallback,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  3038. <summary>
  3039. Get the streams for the specified messages.
  3040. </summary>
  3041. <remarks>
  3042. <para>Gets the streams for the specified messages.</para>
  3043. </remarks>
  3044. <param name="uids">The uids of the messages.</param>
  3045. <param name="callback"></param>
  3046. <param name="cancellationToken">The cancellation token.</param>
  3047. <param name="progress">The progress reporting mechanism.</param>
  3048. <exception cref="T:System.ArgumentNullException">
  3049. <para><paramref name="uids"/> is <c>null</c>.</para>
  3050. <para>-or-</para>
  3051. <para><paramref name="callback"/> is <c>null</c>.</para>
  3052. </exception>
  3053. <exception cref="T:System.ArgumentException">
  3054. One or more of the <paramref name="uids"/> is invalid.
  3055. </exception>
  3056. <exception cref="T:System.ObjectDisposedException">
  3057. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  3058. </exception>
  3059. <exception cref="T:MailKit.ServiceNotConnectedException">
  3060. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  3061. </exception>
  3062. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  3063. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  3064. </exception>
  3065. <exception cref="T:MailKit.FolderNotOpenException">
  3066. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  3067. </exception>
  3068. <exception cref="T:System.OperationCanceledException">
  3069. The operation was canceled via the cancellation token.
  3070. </exception>
  3071. <exception cref="T:System.IO.IOException">
  3072. An I/O error occurred.
  3073. </exception>
  3074. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  3075. The server's response contained unexpected tokens.
  3076. </exception>
  3077. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  3078. The server replied with a NO or BAD response.
  3079. </exception>
  3080. </member>
  3081. <member name="M:MailKit.Net.Imap.IImapFolder.GetStreamsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Net.Imap.ImapFetchStreamAsyncCallback,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  3082. <summary>
  3083. Asynchronously get the streams for the specified messages.
  3084. </summary>
  3085. <remarks>
  3086. <para>Asynchronously gets the streams for the specified messages.</para>
  3087. </remarks>
  3088. <returns>An awaitable task.</returns>
  3089. <param name="uids">The uids of the messages.</param>
  3090. <param name="callback"></param>
  3091. <param name="cancellationToken">The cancellation token.</param>
  3092. <param name="progress">The progress reporting mechanism.</param>
  3093. <exception cref="T:System.ArgumentNullException">
  3094. <para><paramref name="uids"/> is <c>null</c>.</para>
  3095. <para>-or-</para>
  3096. <para><paramref name="callback"/> is <c>null</c>.</para>
  3097. </exception>
  3098. <exception cref="T:System.ArgumentException">
  3099. One or more of the <paramref name="uids"/> is invalid.
  3100. </exception>
  3101. <exception cref="T:System.ObjectDisposedException">
  3102. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  3103. </exception>
  3104. <exception cref="T:MailKit.ServiceNotConnectedException">
  3105. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  3106. </exception>
  3107. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  3108. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  3109. </exception>
  3110. <exception cref="T:MailKit.FolderNotOpenException">
  3111. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  3112. </exception>
  3113. <exception cref="T:System.OperationCanceledException">
  3114. The operation was canceled via the cancellation token.
  3115. </exception>
  3116. <exception cref="T:System.IO.IOException">
  3117. An I/O error occurred.
  3118. </exception>
  3119. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  3120. The server's response contained unexpected tokens.
  3121. </exception>
  3122. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  3123. The server replied with a NO or BAD response.
  3124. </exception>
  3125. </member>
  3126. <member name="M:MailKit.Net.Imap.IImapFolder.GetStreams(System.Collections.Generic.IList{System.Int32},MailKit.Net.Imap.ImapFetchStreamCallback,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  3127. <summary>
  3128. Get the streams for the specified messages.
  3129. </summary>
  3130. <remarks>
  3131. <para>Gets the streams for the specified messages.</para>
  3132. </remarks>
  3133. <param name="indexes">The indexes of the messages.</param>
  3134. <param name="callback"></param>
  3135. <param name="cancellationToken">The cancellation token.</param>
  3136. <param name="progress">The progress reporting mechanism.</param>
  3137. <exception cref="T:System.ArgumentNullException">
  3138. <para><paramref name="indexes"/> is <c>null</c>.</para>
  3139. <para>-or-</para>
  3140. <para><paramref name="callback"/> is <c>null</c>.</para>
  3141. </exception>
  3142. <exception cref="T:System.ArgumentException">
  3143. One or more of the <paramref name="indexes"/> is invalid.
  3144. </exception>
  3145. <exception cref="T:System.ObjectDisposedException">
  3146. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  3147. </exception>
  3148. <exception cref="T:MailKit.ServiceNotConnectedException">
  3149. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  3150. </exception>
  3151. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  3152. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  3153. </exception>
  3154. <exception cref="T:MailKit.FolderNotOpenException">
  3155. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  3156. </exception>
  3157. <exception cref="T:System.OperationCanceledException">
  3158. The operation was canceled via the cancellation token.
  3159. </exception>
  3160. <exception cref="T:System.IO.IOException">
  3161. An I/O error occurred.
  3162. </exception>
  3163. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  3164. The server's response contained unexpected tokens.
  3165. </exception>
  3166. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  3167. The server replied with a NO or BAD response.
  3168. </exception>
  3169. </member>
  3170. <member name="M:MailKit.Net.Imap.IImapFolder.GetStreamsAsync(System.Collections.Generic.IList{System.Int32},MailKit.Net.Imap.ImapFetchStreamAsyncCallback,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  3171. <summary>
  3172. Asynchronously get the streams for the specified messages.
  3173. </summary>
  3174. <remarks>
  3175. <para>Asynchronously gets the streams for the specified messages.</para>
  3176. </remarks>
  3177. <returns>An awaitable task.</returns>
  3178. <param name="indexes">The indexes of the messages.</param>
  3179. <param name="callback"></param>
  3180. <param name="cancellationToken">The cancellation token.</param>
  3181. <param name="progress">The progress reporting mechanism.</param>
  3182. <exception cref="T:System.ArgumentNullException">
  3183. <para><paramref name="indexes"/> is <c>null</c>.</para>
  3184. <para>-or-</para>
  3185. <para><paramref name="callback"/> is <c>null</c>.</para>
  3186. </exception>
  3187. <exception cref="T:System.ArgumentException">
  3188. One or more of the <paramref name="indexes"/> is invalid.
  3189. </exception>
  3190. <exception cref="T:System.ObjectDisposedException">
  3191. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  3192. </exception>
  3193. <exception cref="T:MailKit.ServiceNotConnectedException">
  3194. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  3195. </exception>
  3196. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  3197. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  3198. </exception>
  3199. <exception cref="T:MailKit.FolderNotOpenException">
  3200. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  3201. </exception>
  3202. <exception cref="T:System.OperationCanceledException">
  3203. The operation was canceled via the cancellation token.
  3204. </exception>
  3205. <exception cref="T:System.IO.IOException">
  3206. An I/O error occurred.
  3207. </exception>
  3208. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  3209. The server's response contained unexpected tokens.
  3210. </exception>
  3211. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  3212. The server replied with a NO or BAD response.
  3213. </exception>
  3214. </member>
  3215. <member name="M:MailKit.Net.Imap.IImapFolder.GetStreams(System.Int32,System.Int32,MailKit.Net.Imap.ImapFetchStreamCallback,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  3216. <summary>
  3217. Get the streams for the specified messages.
  3218. </summary>
  3219. <remarks>
  3220. <para>Gets the streams for the specified messages.</para>
  3221. </remarks>
  3222. <param name="min">The minimum index.</param>
  3223. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  3224. <param name="callback"></param>
  3225. <param name="cancellationToken">The cancellation token.</param>
  3226. <param name="progress">The progress reporting mechanism.</param>
  3227. <exception cref="T:System.ArgumentOutOfRangeException">
  3228. <para><paramref name="min"/> is out of range.</para>
  3229. <para>-or-</para>
  3230. <para><paramref name="max"/> is out of range.</para>
  3231. </exception>
  3232. <exception cref="T:System.ArgumentNullException">
  3233. <paramref name="callback"/> is <c>null</c>.
  3234. </exception>
  3235. <exception cref="T:System.ObjectDisposedException">
  3236. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  3237. </exception>
  3238. <exception cref="T:MailKit.ServiceNotConnectedException">
  3239. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  3240. </exception>
  3241. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  3242. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  3243. </exception>
  3244. <exception cref="T:MailKit.FolderNotOpenException">
  3245. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  3246. </exception>
  3247. <exception cref="T:System.OperationCanceledException">
  3248. The operation was canceled via the cancellation token.
  3249. </exception>
  3250. <exception cref="T:System.IO.IOException">
  3251. An I/O error occurred.
  3252. </exception>
  3253. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  3254. The server's response contained unexpected tokens.
  3255. </exception>
  3256. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  3257. The server replied with a NO or BAD response.
  3258. </exception>
  3259. </member>
  3260. <member name="M:MailKit.Net.Imap.IImapFolder.GetStreamsAsync(System.Int32,System.Int32,MailKit.Net.Imap.ImapFetchStreamAsyncCallback,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  3261. <summary>
  3262. Asynchronously get the streams for the specified messages.
  3263. </summary>
  3264. <remarks>
  3265. <para>Asynchronously gets the streams for the specified messages.</para>
  3266. </remarks>
  3267. <returns>An awaitable task.</returns>
  3268. <param name="min">The minimum index.</param>
  3269. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  3270. <param name="callback"></param>
  3271. <param name="cancellationToken">The cancellation token.</param>
  3272. <param name="progress">The progress reporting mechanism.</param>
  3273. <exception cref="T:System.ArgumentOutOfRangeException">
  3274. <para><paramref name="min"/> is out of range.</para>
  3275. <para>-or-</para>
  3276. <para><paramref name="max"/> is out of range.</para>
  3277. </exception>
  3278. <exception cref="T:System.ArgumentNullException">
  3279. <paramref name="callback"/> is <c>null</c>.
  3280. </exception>
  3281. <exception cref="T:System.ObjectDisposedException">
  3282. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  3283. </exception>
  3284. <exception cref="T:MailKit.ServiceNotConnectedException">
  3285. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  3286. </exception>
  3287. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  3288. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  3289. </exception>
  3290. <exception cref="T:MailKit.FolderNotOpenException">
  3291. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  3292. </exception>
  3293. <exception cref="T:System.OperationCanceledException">
  3294. The operation was canceled via the cancellation token.
  3295. </exception>
  3296. <exception cref="T:System.IO.IOException">
  3297. An I/O error occurred.
  3298. </exception>
  3299. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  3300. The server's response contained unexpected tokens.
  3301. </exception>
  3302. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  3303. The server replied with a NO or BAD response.
  3304. </exception>
  3305. </member>
  3306. <member name="M:MailKit.Net.Imap.IImapFolder.Search(System.String,System.Threading.CancellationToken)">
  3307. <summary>
  3308. Search the folder for messages matching the specified query.
  3309. </summary>
  3310. <remarks>
  3311. Sends a <c>UID SEARCH</c> command with the specified query passed directly to the IMAP server
  3312. with no interpretation by MailKit. This means that the query may contain any arguments that a
  3313. <c>UID SEARCH</c> command is allowed to have according to the IMAP specifications and any
  3314. extensions that are supported, including <c>RETURN</c> parameters.
  3315. </remarks>
  3316. <returns>An array of matching UIDs.</returns>
  3317. <param name="query">The search query.</param>
  3318. <param name="cancellationToken">The cancellation token.</param>
  3319. <exception cref="T:System.ArgumentNullException">
  3320. <paramref name="query"/> is <c>null</c>.
  3321. </exception>
  3322. <exception cref="T:System.ArgumentException">
  3323. <paramref name="query"/> is an empty string.
  3324. </exception>
  3325. <exception cref="T:System.ObjectDisposedException">
  3326. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  3327. </exception>
  3328. <exception cref="T:MailKit.ServiceNotConnectedException">
  3329. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  3330. </exception>
  3331. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  3332. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  3333. </exception>
  3334. <exception cref="T:MailKit.FolderNotOpenException">
  3335. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  3336. </exception>
  3337. <exception cref="T:System.OperationCanceledException">
  3338. The operation was canceled via the cancellation token.
  3339. </exception>
  3340. <exception cref="T:System.IO.IOException">
  3341. An I/O error occurred.
  3342. </exception>
  3343. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  3344. The server's response contained unexpected tokens.
  3345. </exception>
  3346. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  3347. The server replied with a NO or BAD response.
  3348. </exception>
  3349. </member>
  3350. <member name="M:MailKit.Net.Imap.IImapFolder.SearchAsync(System.String,System.Threading.CancellationToken)">
  3351. <summary>
  3352. Asynchronously search the folder for messages matching the specified query.
  3353. </summary>
  3354. <remarks>
  3355. Sends a <c>UID SEARCH</c> command with the specified query passed directly to the IMAP server
  3356. with no interpretation by MailKit. This means that the query may contain any arguments that a
  3357. <c>UID SEARCH</c> command is allowed to have according to the IMAP specifications and any
  3358. extensions that are supported, including <c>RETURN</c> parameters.
  3359. </remarks>
  3360. <returns>An array of matching UIDs.</returns>
  3361. <param name="query">The search query.</param>
  3362. <param name="cancellationToken">The cancellation token.</param>
  3363. <exception cref="T:System.ArgumentNullException">
  3364. <paramref name="query"/> is <c>null</c>.
  3365. </exception>
  3366. <exception cref="T:System.ArgumentException">
  3367. <paramref name="query"/> is an empty string.
  3368. </exception>
  3369. <exception cref="T:System.ObjectDisposedException">
  3370. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  3371. </exception>
  3372. <exception cref="T:MailKit.ServiceNotConnectedException">
  3373. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  3374. </exception>
  3375. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  3376. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  3377. </exception>
  3378. <exception cref="T:MailKit.FolderNotOpenException">
  3379. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  3380. </exception>
  3381. <exception cref="T:System.OperationCanceledException">
  3382. The operation was canceled via the cancellation token.
  3383. </exception>
  3384. <exception cref="T:System.IO.IOException">
  3385. An I/O error occurred.
  3386. </exception>
  3387. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  3388. The server's response contained unexpected tokens.
  3389. </exception>
  3390. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  3391. The server replied with a NO or BAD response.
  3392. </exception>
  3393. </member>
  3394. <member name="M:MailKit.Net.Imap.IImapFolder.Sort(System.String,System.Threading.CancellationToken)">
  3395. <summary>
  3396. Sort messages matching the specified query.
  3397. </summary>
  3398. <remarks>
  3399. Sends a <c>UID SORT</c> command with the specified query passed directly to the IMAP server
  3400. with no interpretation by MailKit. This means that the query may contain any arguments that a
  3401. <c>UID SORT</c> command is allowed to have according to the IMAP specifications and any
  3402. extensions that are supported, including <c>RETURN</c> parameters.
  3403. </remarks>
  3404. <returns>An array of matching UIDs.</returns>
  3405. <param name="query">The search query.</param>
  3406. <param name="cancellationToken">The cancellation token.</param>
  3407. <exception cref="T:System.ArgumentNullException">
  3408. <paramref name="query"/> is <c>null</c>.
  3409. </exception>
  3410. <exception cref="T:System.ArgumentException">
  3411. <paramref name="query"/> is an empty string.
  3412. </exception>
  3413. <exception cref="T:System.NotSupportedException">
  3414. The IMAP server does not support the SORT extension.
  3415. </exception>
  3416. <exception cref="T:System.ObjectDisposedException">
  3417. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  3418. </exception>
  3419. <exception cref="T:MailKit.ServiceNotConnectedException">
  3420. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  3421. </exception>
  3422. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  3423. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  3424. </exception>
  3425. <exception cref="T:MailKit.FolderNotOpenException">
  3426. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  3427. </exception>
  3428. <exception cref="T:System.OperationCanceledException">
  3429. The operation was canceled via the cancellation token.
  3430. </exception>
  3431. <exception cref="T:System.IO.IOException">
  3432. An I/O error occurred.
  3433. </exception>
  3434. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  3435. The server's response contained unexpected tokens.
  3436. </exception>
  3437. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  3438. The server replied with a NO or BAD response.
  3439. </exception>
  3440. </member>
  3441. <member name="M:MailKit.Net.Imap.IImapFolder.SortAsync(System.String,System.Threading.CancellationToken)">
  3442. <summary>
  3443. Asynchronously sort messages matching the specified query.
  3444. </summary>
  3445. <remarks>
  3446. Sends a <c>UID SORT</c> command with the specified query passed directly to the IMAP server
  3447. with no interpretation by MailKit. This means that the query may contain any arguments that a
  3448. <c>UID SORT</c> command is allowed to have according to the IMAP specifications and any
  3449. extensions that are supported, including <c>RETURN</c> parameters.
  3450. </remarks>
  3451. <returns>An array of matching UIDs.</returns>
  3452. <param name="query">The search query.</param>
  3453. <param name="cancellationToken">The cancellation token.</param>
  3454. <exception cref="T:System.ArgumentNullException">
  3455. <paramref name="query"/> is <c>null</c>.
  3456. </exception>
  3457. <exception cref="T:System.ArgumentException">
  3458. <paramref name="query"/> is an empty string.
  3459. </exception>
  3460. <exception cref="T:System.NotSupportedException">
  3461. The IMAP server does not support the SORT extension.
  3462. </exception>
  3463. <exception cref="T:System.ObjectDisposedException">
  3464. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  3465. </exception>
  3466. <exception cref="T:MailKit.ServiceNotConnectedException">
  3467. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  3468. </exception>
  3469. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  3470. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  3471. </exception>
  3472. <exception cref="T:MailKit.FolderNotOpenException">
  3473. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  3474. </exception>
  3475. <exception cref="T:System.OperationCanceledException">
  3476. The operation was canceled via the cancellation token.
  3477. </exception>
  3478. <exception cref="T:System.IO.IOException">
  3479. An I/O error occurred.
  3480. </exception>
  3481. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  3482. The server's response contained unexpected tokens.
  3483. </exception>
  3484. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  3485. The server replied with a NO or BAD response.
  3486. </exception>
  3487. </member>
  3488. <member name="T:MailKit.Net.Imap.ImapFetchStreamCallback">
  3489. <summary>
  3490. A callback used when fetching message streams.
  3491. </summary>
  3492. <remarks>
  3493. <para>This callback is meant to be used with the various
  3494. <a href="Overload_MailKit_Net_Imap_ImapFolder_GetStreams.htm">GetStreams</a>
  3495. methods.</para>
  3496. <para>Once this callback returns, the stream argument will be disposed, so
  3497. it is important to consume the stream right away and not add it to a queue
  3498. for later processing.</para>
  3499. </remarks>
  3500. <param name="folder">The IMAP folder that the message belongs to.</param>
  3501. <param name="index">The index of the message in the folder.</param>
  3502. <param name="uid">The UID of the message in the folder.</param>
  3503. <param name="stream">The raw message (or part) stream.</param>
  3504. </member>
  3505. <member name="T:MailKit.Net.Imap.ImapFetchStreamAsyncCallback">
  3506. <summary>
  3507. An asynchronous callback used when fetching message streams.
  3508. </summary>
  3509. <remarks>
  3510. <para>This callback is meant to be used with the various
  3511. <a href="Overload_MailKit_Net_Imap_ImapFolder_GetStreamsAsync.htm">GetStreamsAsync</a>
  3512. methods.</para>
  3513. <para>Once this callback returns, the stream argument will be disposed, so
  3514. it is important to consume the stream right away and not add it to a queue
  3515. for later processing.</para>
  3516. </remarks>
  3517. <returns>An awaitable task context.</returns>
  3518. <param name="folder">The IMAP folder that the message belongs to.</param>
  3519. <param name="index">The index of the message in the folder.</param>
  3520. <param name="uid">The UID of the message in the folder.</param>
  3521. <param name="stream">The raw message (or part) stream.</param>
  3522. <param name="cancellationToken">The cancellation token.</param>
  3523. </member>
  3524. <member name="T:MailKit.Net.Imap.ImapCapabilities">
  3525. <summary>
  3526. Capabilities supported by an IMAP server.
  3527. </summary>
  3528. <remarks>
  3529. Capabilities are read as part of the response to the <c>CAPABILITY</c> command that
  3530. is issued during the connection and authentication phases of the
  3531. <see cref="T:MailKit.Net.Imap.ImapClient"/>.
  3532. </remarks>
  3533. <example>
  3534. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  3535. </example>
  3536. </member>
  3537. <member name="F:MailKit.Net.Imap.ImapCapabilities.None">
  3538. <summary>
  3539. The server does not support any additional extensions.
  3540. </summary>
  3541. </member>
  3542. <member name="F:MailKit.Net.Imap.ImapCapabilities.IMAP4">
  3543. <summary>
  3544. The server implements the core IMAP4 commands.
  3545. </summary>
  3546. </member>
  3547. <member name="F:MailKit.Net.Imap.ImapCapabilities.IMAP4rev1">
  3548. <summary>
  3549. The server implements the core IMAP4rev1 commands.
  3550. </summary>
  3551. </member>
  3552. <member name="F:MailKit.Net.Imap.ImapCapabilities.IMAP4rev2">
  3553. <summary>
  3554. The server implements the core IMAP4rev2 commands.
  3555. </summary>
  3556. </member>
  3557. <member name="F:MailKit.Net.Imap.ImapCapabilities.Status">
  3558. <summary>
  3559. The server supports the <c>STATUS</c> command.
  3560. </summary>
  3561. </member>
  3562. <member name="F:MailKit.Net.Imap.ImapCapabilities.Acl">
  3563. <summary>
  3564. The server supports the ACL extension defined in <a href="https://tools.ietf.org/html/rfc2086">rfc2086</a>
  3565. and <a href="https://tools.ietf.org/html/rfc4314">rfc4314</a>.
  3566. </summary>
  3567. </member>
  3568. <member name="F:MailKit.Net.Imap.ImapCapabilities.Quota">
  3569. <summary>
  3570. The server supports the <a href="https://tools.ietf.org/html/rfc2087">QUOTA</a> extension.
  3571. </summary>
  3572. </member>
  3573. <member name="F:MailKit.Net.Imap.ImapCapabilities.LiteralPlus">
  3574. <summary>
  3575. The server supports the <a href="https://tools.ietf.org/html/rfc2088">LITERAL+</a> extension.
  3576. </summary>
  3577. </member>
  3578. <member name="F:MailKit.Net.Imap.ImapCapabilities.Idle">
  3579. <summary>
  3580. The server supports the <a href="https://tools.ietf.org/html/rfc2177">IDLE</a> extension.
  3581. </summary>
  3582. </member>
  3583. <member name="F:MailKit.Net.Imap.ImapCapabilities.MailboxReferrals">
  3584. <summary>
  3585. The server supports the <a href="https://tools.ietf.org/html/rfc2193">MAILBOX-REFERRALS</a> extension.
  3586. </summary>
  3587. </member>
  3588. <member name="F:MailKit.Net.Imap.ImapCapabilities.LoginReferrals">
  3589. <summary>
  3590. the server supports the <a href="https://tools.ietf.org/html/rfc2221">LOGIN-REFERRALS</a> extension.
  3591. </summary>
  3592. </member>
  3593. <member name="F:MailKit.Net.Imap.ImapCapabilities.Namespace">
  3594. <summary>
  3595. The server supports the <a href="https://tools.ietf.org/html/rfc2342">NAMESPACE</a> extension.
  3596. </summary>
  3597. </member>
  3598. <member name="F:MailKit.Net.Imap.ImapCapabilities.Id">
  3599. <summary>
  3600. The server supports the <a href="https://tools.ietf.org/html/rfc2971">ID</a> extension.
  3601. </summary>
  3602. </member>
  3603. <member name="F:MailKit.Net.Imap.ImapCapabilities.Children">
  3604. <summary>
  3605. The server supports the <a href="https://tools.ietf.org/html/rfc3348">CHILDREN</a> extension.
  3606. </summary>
  3607. </member>
  3608. <member name="F:MailKit.Net.Imap.ImapCapabilities.LoginDisabled">
  3609. <summary>
  3610. The server supports the <a href="https://tools.ietf.org/html/rfc3501">LOGINDISABLED</a> extension.
  3611. </summary>
  3612. </member>
  3613. <member name="F:MailKit.Net.Imap.ImapCapabilities.StartTLS">
  3614. <summary>
  3615. The server supports the <a href="https://tools.ietf.org/html/rfc3501">STARTTLS</a> extension.
  3616. </summary>
  3617. </member>
  3618. <member name="F:MailKit.Net.Imap.ImapCapabilities.MultiAppend">
  3619. <summary>
  3620. The server supports the <a href="https://tools.ietf.org/html/rfc3502">MULTIAPPEND</a> extension.
  3621. </summary>
  3622. </member>
  3623. <member name="F:MailKit.Net.Imap.ImapCapabilities.Binary">
  3624. <summary>
  3625. The server supports the <a href="https://tools.ietf.org/html/rfc3516">BINARY</a> content extension.
  3626. </summary>
  3627. </member>
  3628. <member name="F:MailKit.Net.Imap.ImapCapabilities.Unselect">
  3629. <summary>
  3630. The server supports the <a href="https://tools.ietf.org/html/rfc3691">UNSELECT</a> extension.
  3631. </summary>
  3632. </member>
  3633. <member name="F:MailKit.Net.Imap.ImapCapabilities.UidPlus">
  3634. <summary>
  3635. The server supports the <a href="https://tools.ietf.org/html/rfc4315">UIDPLUS</a> extension.
  3636. </summary>
  3637. </member>
  3638. <member name="F:MailKit.Net.Imap.ImapCapabilities.Catenate">
  3639. <summary>
  3640. The server supports the <a href="https://tools.ietf.org/html/rfc4469">CATENATE</a> extension.
  3641. </summary>
  3642. </member>
  3643. <member name="F:MailKit.Net.Imap.ImapCapabilities.CondStore">
  3644. <summary>
  3645. The server supports the <a href="https://tools.ietf.org/html/rfc4551">CONDSTORE</a> extension.
  3646. </summary>
  3647. </member>
  3648. <member name="F:MailKit.Net.Imap.ImapCapabilities.ESearch">
  3649. <summary>
  3650. The server supports the <a href="https://tools.ietf.org/html/rfc4731">ESEARCH</a> extension.
  3651. </summary>
  3652. </member>
  3653. <member name="F:MailKit.Net.Imap.ImapCapabilities.SaslIR">
  3654. <summary>
  3655. The server supports the <a href="https://tools.ietf.org/html/rfc4959">SASL-IR</a> extension.
  3656. </summary>
  3657. </member>
  3658. <member name="F:MailKit.Net.Imap.ImapCapabilities.Compress">
  3659. <summary>
  3660. The server supports the <a href="https://tools.ietf.org/html/rfc4978">COMPRESS</a> extension.
  3661. </summary>
  3662. </member>
  3663. <member name="F:MailKit.Net.Imap.ImapCapabilities.Within">
  3664. <summary>
  3665. The server supports the <a href="https://tools.ietf.org/html/rfc5032">WITHIN</a> extension.
  3666. </summary>
  3667. </member>
  3668. <member name="F:MailKit.Net.Imap.ImapCapabilities.Enable">
  3669. <summary>
  3670. The server supports the <a href="https://tools.ietf.org/html/rfc5161">ENABLE</a> extension.
  3671. </summary>
  3672. </member>
  3673. <member name="F:MailKit.Net.Imap.ImapCapabilities.QuickResync">
  3674. <summary>
  3675. The server supports the <a href="https://tools.ietf.org/html/rfc5162">QRESYNC</a> extension.
  3676. </summary>
  3677. </member>
  3678. <member name="F:MailKit.Net.Imap.ImapCapabilities.SearchResults">
  3679. <summary>
  3680. The server supports the <a href="https://tools.ietf.org/html/rfc5182">SEARCHRES</a> extension.
  3681. </summary>
  3682. </member>
  3683. <member name="F:MailKit.Net.Imap.ImapCapabilities.Sort">
  3684. <summary>
  3685. The server supports the <a href="https://tools.ietf.org/html/rfc5256">SORT</a> extension.
  3686. </summary>
  3687. </member>
  3688. <member name="F:MailKit.Net.Imap.ImapCapabilities.Thread">
  3689. <summary>
  3690. The server supports the <a href="https://tools.ietf.org/html/rfc5256">THREAD</a> extension.
  3691. </summary>
  3692. </member>
  3693. <member name="F:MailKit.Net.Imap.ImapCapabilities.Annotate">
  3694. <summary>
  3695. The server supports the <a href="https://tools.ietf.org/html/rfc5257">ANNOTATE</a> extension.
  3696. </summary>
  3697. </member>
  3698. <member name="F:MailKit.Net.Imap.ImapCapabilities.ListExtended">
  3699. <summary>
  3700. The server supports the <a href="https://tools.ietf.org/html/rfc5258">LIST-EXTENDED</a> extension.
  3701. </summary>
  3702. </member>
  3703. <member name="F:MailKit.Net.Imap.ImapCapabilities.Convert">
  3704. <summary>
  3705. The server supports the <a href="https://tools.ietf.org/html/rfc5259">CONVERT</a> extension.
  3706. </summary>
  3707. </member>
  3708. <member name="F:MailKit.Net.Imap.ImapCapabilities.Language">
  3709. <summary>
  3710. The server supports the <a href="https://tools.ietf.org/html/rfc5255">LANGUAGE</a> extension.
  3711. </summary>
  3712. </member>
  3713. <member name="F:MailKit.Net.Imap.ImapCapabilities.I18NLevel">
  3714. <summary>
  3715. The server supports the <a href="https://tools.ietf.org/html/rfc5255">I18NLEVEL</a> extension.
  3716. </summary>
  3717. </member>
  3718. <member name="F:MailKit.Net.Imap.ImapCapabilities.ESort">
  3719. <summary>
  3720. The server supports the <a href="https://tools.ietf.org/html/rfc5267">ESORT</a> extension.
  3721. </summary>
  3722. </member>
  3723. <member name="F:MailKit.Net.Imap.ImapCapabilities.Context">
  3724. <summary>
  3725. The server supports the <a href="https://tools.ietf.org/html/rfc5267">CONTEXT</a> extension.
  3726. </summary>
  3727. </member>
  3728. <member name="F:MailKit.Net.Imap.ImapCapabilities.Metadata">
  3729. <summary>
  3730. The server supports the <a href="https://tools.ietf.org/html/rfc5464">METADATA</a> extension.
  3731. </summary>
  3732. </member>
  3733. <member name="F:MailKit.Net.Imap.ImapCapabilities.MetadataServer">
  3734. <summary>
  3735. The server supports the <a href="https://tools.ietf.org/html/rfc5464">METADATA-SERVER</a> extension.
  3736. </summary>
  3737. </member>
  3738. <member name="F:MailKit.Net.Imap.ImapCapabilities.Notify">
  3739. <summary>
  3740. The server supports the <a href="https://tools.ietf.org/html/rfc5465">NOTIFY</a> extension.
  3741. </summary>
  3742. </member>
  3743. <member name="F:MailKit.Net.Imap.ImapCapabilities.Filters">
  3744. <summary>
  3745. The server supports the <a href="https://tools.ietf.org/html/rfc5466">FILTERS</a> extension.
  3746. </summary>
  3747. </member>
  3748. <member name="F:MailKit.Net.Imap.ImapCapabilities.ListStatus">
  3749. <summary>
  3750. The server supports the <a href="https://tools.ietf.org/html/rfc5819">LIST-STATUS</a> extension.
  3751. </summary>
  3752. </member>
  3753. <member name="F:MailKit.Net.Imap.ImapCapabilities.SortDisplay">
  3754. <summary>
  3755. The server supports the <a href="https://tools.ietf.org/html/rfc5957">SORT=DISPLAY</a> extension.
  3756. </summary>
  3757. </member>
  3758. <member name="F:MailKit.Net.Imap.ImapCapabilities.CreateSpecialUse">
  3759. <summary>
  3760. The server supports the <a href="https://tools.ietf.org/html/rfc6154">CREATE-SPECIAL-USE</a> extension.
  3761. </summary>
  3762. </member>
  3763. <member name="F:MailKit.Net.Imap.ImapCapabilities.SpecialUse">
  3764. <summary>
  3765. The server supports the <a href="https://tools.ietf.org/html/rfc6154">SPECIAL-USE</a> extension.
  3766. </summary>
  3767. </member>
  3768. <member name="F:MailKit.Net.Imap.ImapCapabilities.FuzzySearch">
  3769. <summary>
  3770. The server supports the <a href="https://tools.ietf.org/html/rfc6203">SEARCH=FUZZY</a> extension.
  3771. </summary>
  3772. </member>
  3773. <member name="F:MailKit.Net.Imap.ImapCapabilities.MultiSearch">
  3774. <summary>
  3775. The server supports the <a href="https://tools.ietf.org/html/rfc6237">MULTISEARCH</a> extension.
  3776. </summary>
  3777. </member>
  3778. <member name="F:MailKit.Net.Imap.ImapCapabilities.Move">
  3779. <summary>
  3780. The server supports the <a href="https://tools.ietf.org/html/rfc6851">MOVE</a> extension.
  3781. </summary>
  3782. </member>
  3783. <member name="F:MailKit.Net.Imap.ImapCapabilities.UTF8Accept">
  3784. <summary>
  3785. The server supports the <a href="https://tools.ietf.org/html/rfc6855">UTF8=ACCEPT</a> extension.
  3786. </summary>
  3787. </member>
  3788. <member name="F:MailKit.Net.Imap.ImapCapabilities.UTF8Only">
  3789. <summary>
  3790. The server supports the <a href="https://tools.ietf.org/html/rfc6855">UTF8=ONLY</a> extension.
  3791. </summary>
  3792. </member>
  3793. <member name="F:MailKit.Net.Imap.ImapCapabilities.LiteralMinus">
  3794. <summary>
  3795. The server supports the <a href="https://tools.ietf.org/html/rfc7888">LITERAL-</a> extension.
  3796. </summary>
  3797. </member>
  3798. <member name="F:MailKit.Net.Imap.ImapCapabilities.AppendLimit">
  3799. <summary>
  3800. The server supports the <a href="https://tools.ietf.org/html/rfc7889">APPENDLIMIT</a> extension.
  3801. </summary>
  3802. </member>
  3803. <member name="F:MailKit.Net.Imap.ImapCapabilities.Unauthenticate">
  3804. <summary>
  3805. The server supports the <a href="https://tools.ietf.org/html/rfc8437">UNAUTHENTICATE</a> extension.
  3806. </summary>
  3807. </member>
  3808. <member name="F:MailKit.Net.Imap.ImapCapabilities.StatusSize">
  3809. <summary>
  3810. The server supports the <a href="https://tools.ietf.org/html/rfc8438">STATUS=SIZE</a> extension.
  3811. </summary>
  3812. </member>
  3813. <member name="F:MailKit.Net.Imap.ImapCapabilities.ListMyRights">
  3814. <summary>
  3815. The server supports the <a href="https://tools.ietf.org/html/rfc8440">LIST-MYRIGHTS</a> extension.
  3816. </summary>
  3817. </member>
  3818. <member name="F:MailKit.Net.Imap.ImapCapabilities.ObjectID">
  3819. <summary>
  3820. The server supports the <a href="https://tools.ietf.org/html/rfc8474">OBJECTID</a> extension.
  3821. </summary>
  3822. </member>
  3823. <member name="F:MailKit.Net.Imap.ImapCapabilities.XList">
  3824. <summary>
  3825. The server supports the <a href="https://developers.google.com/gmail/imap_extensions">XLIST</a> extension (GMail).
  3826. </summary>
  3827. </member>
  3828. <member name="F:MailKit.Net.Imap.ImapCapabilities.GMailExt1">
  3829. <summary>
  3830. The server supports the <a href="https://developers.google.com/gmail/imap_extensions">X-GM-EXT1</a> extension (GMail).
  3831. </summary>
  3832. </member>
  3833. <member name="T:MailKit.Net.Imap.ImapContinuationHandler">
  3834. <summary>
  3835. An IMAP continuation handler.
  3836. </summary>
  3837. <remarks>
  3838. All exceptions thrown by the handler are considered fatal and will
  3839. force-disconnect the connection. If a non-fatal error occurs, set
  3840. it on the <see cref="P:MailKit.Net.Imap.ImapCommand.Exception"/> property.
  3841. </remarks>
  3842. </member>
  3843. <member name="T:MailKit.Net.Imap.ImapUntaggedHandler">
  3844. <summary>
  3845. An IMAP untagged response handler.
  3846. </summary>
  3847. <remarks>
  3848. <para>Most IMAP commands return their results in untagged responses.</para>
  3849. </remarks>
  3850. </member>
  3851. <member name="T:MailKit.Net.Imap.ImapCommandStatus">
  3852. <summary>
  3853. IMAP command status.
  3854. </summary>
  3855. </member>
  3856. <member name="T:MailKit.Net.Imap.ImapIdleContext">
  3857. <summary>
  3858. An IMAP IDLE context.
  3859. </summary>
  3860. <remarks>
  3861. <para>An IMAP IDLE command does not work like normal commands. Unlike most commands,
  3862. the IDLE command does not end until the client sends a separate "DONE" command.</para>
  3863. <para>In order to facilitate this, the way this works is that the consumer of MailKit's
  3864. IMAP APIs provides a 'doneToken' which signals to the command-processing loop to
  3865. send the "DONE" command. Since, like every other IMAP command, it is also necessary to
  3866. provide a means of cancelling the IDLE command, it becomes necessary to link the
  3867. 'doneToken' and the 'cancellationToken' together.</para>
  3868. </remarks>
  3869. </member>
  3870. <member name="M:MailKit.Net.Imap.ImapIdleContext.#ctor(MailKit.Net.Imap.ImapEngine,System.Threading.CancellationToken,System.Threading.CancellationToken)">
  3871. <summary>
  3872. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapIdleContext"/> class.
  3873. </summary>
  3874. <remarks>
  3875. Creates a new <see cref="T:MailKit.Net.Imap.ImapIdleContext"/>.
  3876. </remarks>
  3877. <param name="engine">The IMAP engine.</param>
  3878. <param name="doneToken">The done token.</param>
  3879. <param name="cancellationToken">The cancellation token.</param>
  3880. </member>
  3881. <member name="P:MailKit.Net.Imap.ImapIdleContext.Engine">
  3882. <summary>
  3883. Get the engine.
  3884. </summary>
  3885. <remarks>
  3886. Gets the engine.
  3887. </remarks>
  3888. <value>The engine.</value>
  3889. </member>
  3890. <member name="P:MailKit.Net.Imap.ImapIdleContext.CancellationToken">
  3891. <summary>
  3892. Get the cancellation token.
  3893. </summary>
  3894. <remarks>
  3895. Get the cancellation token.
  3896. </remarks>
  3897. <value>The cancellation token.</value>
  3898. </member>
  3899. <member name="P:MailKit.Net.Imap.ImapIdleContext.DoneToken">
  3900. <summary>
  3901. Get the done token.
  3902. </summary>
  3903. <remarks>
  3904. Gets the done token.
  3905. </remarks>
  3906. <value>The done token.</value>
  3907. </member>
  3908. <member name="M:MailKit.Net.Imap.ImapIdleContext.ContinuationHandler(MailKit.Net.Imap.ImapEngine,MailKit.Net.Imap.ImapCommand,System.String,System.Boolean)">
  3909. <summary>
  3910. Callback method to be used as the ImapCommand's ContinuationHandler.
  3911. </summary>
  3912. <remarks>
  3913. Callback method to be used as the ImapCommand's ContinuationHandler.
  3914. </remarks>
  3915. <param name="engine">The ImapEngine.</param>
  3916. <param name="ic">The ImapCommand.</param>
  3917. <param name="text">The text.</param>
  3918. <param name="doAsync"><c>true</c> if the command is being run asynchronously; otherwise, <c>false</c>.</param>
  3919. <returns></returns>
  3920. </member>
  3921. <member name="M:MailKit.Net.Imap.ImapIdleContext.Dispose">
  3922. <summary>
  3923. Releases all resource used by the <see cref="T:MailKit.Net.Imap.ImapIdleContext"/> object.
  3924. </summary>
  3925. <remarks>Call <see cref="M:MailKit.Net.Imap.ImapIdleContext.Dispose"/> when you are finished using the <see cref="T:MailKit.Net.Imap.ImapIdleContext"/>. The
  3926. <see cref="M:MailKit.Net.Imap.ImapIdleContext.Dispose"/> method leaves the <see cref="T:MailKit.Net.Imap.ImapIdleContext"/> in an unusable state. After
  3927. calling <see cref="M:MailKit.Net.Imap.ImapIdleContext.Dispose"/>, you must release all references to the
  3928. <see cref="T:MailKit.Net.Imap.ImapIdleContext"/> so the garbage collector can reclaim the memory that the
  3929. <see cref="T:MailKit.Net.Imap.ImapIdleContext"/> was occupying.</remarks>
  3930. </member>
  3931. <member name="T:MailKit.Net.Imap.ImapLiteral">
  3932. <summary>
  3933. An IMAP literal object.
  3934. </summary>
  3935. <remarks>
  3936. The literal can be a string, byte[], Stream, or a MimeMessage.
  3937. </remarks>
  3938. </member>
  3939. <member name="M:MailKit.Net.Imap.ImapLiteral.#ctor(MimeKit.FormatOptions,MimeKit.MimeMessage,System.Action{System.Int32})">
  3940. <summary>
  3941. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapLiteral"/> class.
  3942. </summary>
  3943. <remarks>
  3944. Creates a new <see cref="T:MailKit.Net.Imap.ImapLiteral"/>.
  3945. </remarks>
  3946. <param name="options">The formatting options.</param>
  3947. <param name="message">The message.</param>
  3948. <param name="action">The progress update action.</param>
  3949. </member>
  3950. <member name="M:MailKit.Net.Imap.ImapLiteral.#ctor(MimeKit.FormatOptions,System.Byte[])">
  3951. <summary>
  3952. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapLiteral"/> class.
  3953. </summary>
  3954. <remarks>
  3955. Creates a new <see cref="T:MailKit.Net.Imap.ImapLiteral"/>.
  3956. </remarks>
  3957. <param name="options">The formatting options.</param>
  3958. <param name="literal">The literal.</param>
  3959. </member>
  3960. <member name="P:MailKit.Net.Imap.ImapLiteral.Length">
  3961. <summary>
  3962. Get the length of the literal, in bytes.
  3963. </summary>
  3964. <remarks>
  3965. Gets the length of the literal, in bytes.
  3966. </remarks>
  3967. <value>The length.</value>
  3968. </member>
  3969. <member name="M:MailKit.Net.Imap.ImapLiteral.WriteToAsync(MailKit.Net.Imap.ImapStream,System.Boolean,System.Threading.CancellationToken)">
  3970. <summary>
  3971. Write the literal to the specified stream.
  3972. </summary>
  3973. <remarks>
  3974. Writes the literal to the specified stream.
  3975. </remarks>
  3976. <param name="stream">The stream.</param>
  3977. <param name="doAsync">Whether the literal should be written asynchronously or not.</param>
  3978. <param name="cancellationToken">The cancellation token.</param>
  3979. </member>
  3980. <member name="T:MailKit.Net.Imap.ImapCommandPart">
  3981. <summary>
  3982. A partial IMAP command.
  3983. </summary>
  3984. <remarks>
  3985. IMAP commands that contain literal strings are broken up into multiple parts
  3986. in case the IMAP server does not support the LITERAL+ extension. These parts
  3987. are then sent individually as we receive "+" responses from the server.
  3988. </remarks>
  3989. </member>
  3990. <member name="T:MailKit.Net.Imap.ImapCommand">
  3991. <summary>
  3992. An IMAP command.
  3993. </summary>
  3994. </member>
  3995. <member name="M:MailKit.Net.Imap.ImapCommand.#ctor(MailKit.Net.Imap.ImapEngine,System.Threading.CancellationToken,MailKit.Net.Imap.ImapFolder,MimeKit.FormatOptions,System.String,System.Object[])">
  3996. <summary>
  3997. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapCommand"/> class.
  3998. </summary>
  3999. <remarks>
  4000. Creates a new <see cref="T:MailKit.Net.Imap.ImapCommand"/>.
  4001. </remarks>
  4002. <param name="engine">The IMAP engine that will be sending the command.</param>
  4003. <param name="cancellationToken">The cancellation token.</param>
  4004. <param name="folder">The IMAP folder that the command operates on.</param>
  4005. <param name="options">The formatting options.</param>
  4006. <param name="format">The command format.</param>
  4007. <param name="args">The command arguments.</param>
  4008. </member>
  4009. <member name="M:MailKit.Net.Imap.ImapCommand.#ctor(MailKit.Net.Imap.ImapEngine,System.Threading.CancellationToken,MailKit.Net.Imap.ImapFolder,System.String,System.Object[])">
  4010. <summary>
  4011. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapCommand"/> class.
  4012. </summary>
  4013. <remarks>
  4014. Creates a new <see cref="T:MailKit.Net.Imap.ImapCommand"/>.
  4015. </remarks>
  4016. <param name="engine">The IMAP engine that will be sending the command.</param>
  4017. <param name="cancellationToken">The cancellation token.</param>
  4018. <param name="folder">The IMAP folder that the command operates on.</param>
  4019. <param name="format">The command format.</param>
  4020. <param name="args">The command arguments.</param>
  4021. </member>
  4022. <member name="M:MailKit.Net.Imap.ImapCommand.RegisterUntaggedHandler(System.String,MailKit.Net.Imap.ImapUntaggedHandler)">
  4023. <summary>
  4024. Registers the untagged handler for the specified atom token.
  4025. </summary>
  4026. <param name="atom">The atom token.</param>
  4027. <param name="handler">The handler.</param>
  4028. <exception cref="T:System.ArgumentNullException">
  4029. <para><paramref name="atom"/> is <c>null</c>.</para>
  4030. <para>-or-</para>
  4031. <para><paramref name="handler"/> is <c>null</c>.</para>
  4032. </exception>
  4033. <exception cref="T:System.InvalidOperationException">
  4034. Untagged handlers must be registered before the command has been queued.
  4035. </exception>
  4036. </member>
  4037. <member name="M:MailKit.Net.Imap.ImapCommand.StepAsync(System.Boolean)">
  4038. <summary>
  4039. Sends the next part of the command to the server.
  4040. </summary>
  4041. <exception cref="T:System.OperationCanceledException">
  4042. The operation was canceled via the cancellation token.
  4043. </exception>
  4044. <exception cref="T:System.IO.IOException">
  4045. An I/O error occurred.
  4046. </exception>
  4047. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  4048. An IMAP protocol error occurred.
  4049. </exception>
  4050. </member>
  4051. <member name="T:MailKit.Net.Imap.ImapCommandException">
  4052. <summary>
  4053. An exception that is thrown when an IMAP command returns NO or BAD.
  4054. </summary>
  4055. <remarks>
  4056. The exception that is thrown when an IMAP command fails. Unlike a <see cref="T:MailKit.Net.Imap.ImapProtocolException"/>,
  4057. a <see cref="T:MailKit.Net.Imap.ImapCommandException"/> does not require the <see cref="T:MailKit.Net.Imap.ImapClient"/> to be reconnected.
  4058. </remarks>
  4059. </member>
  4060. <member name="M:MailKit.Net.Imap.ImapCommandException.Create(System.String,MailKit.Net.Imap.ImapCommand)">
  4061. <summary>
  4062. Create a new <see cref="T:MailKit.Net.Imap.ImapCommandException"/> based on the specified command name and <see cref="T:MailKit.Net.Imap.ImapCommand"/> state.
  4063. </summary>
  4064. <remarks>
  4065. Create a new <see cref="T:MailKit.Net.Imap.ImapCommandException"/> based on the specified command name and <see cref="T:MailKit.Net.Imap.ImapCommand"/> state.
  4066. </remarks>
  4067. <returns>A new command exception.</returns>
  4068. <param name="command">The command name.</param>
  4069. <param name="ic">The command state.</param>
  4070. </member>
  4071. <member name="M:MailKit.Net.Imap.ImapCommandException.#ctor(MailKit.Net.Imap.ImapCommandResponse,System.String,System.String,System.Exception)">
  4072. <summary>
  4073. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapCommandException"/> class.
  4074. </summary>
  4075. <remarks>
  4076. Creates a new <see cref="T:MailKit.Net.Imap.ImapCommandException"/>.
  4077. </remarks>
  4078. <param name="response">The IMAP command response.</param>
  4079. <param name="message">The error message.</param>
  4080. <param name="responseText">The human-readable response text.</param>
  4081. <param name="innerException">The inner exception.</param>
  4082. </member>
  4083. <member name="M:MailKit.Net.Imap.ImapCommandException.#ctor(MailKit.Net.Imap.ImapCommandResponse,System.String,System.String)">
  4084. <summary>
  4085. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapCommandException"/> class.
  4086. </summary>
  4087. <remarks>
  4088. Creates a new <see cref="T:MailKit.Net.Imap.ImapCommandException"/>.
  4089. </remarks>
  4090. <param name="response">The IMAP command response.</param>
  4091. <param name="responseText">The human-readable response text.</param>
  4092. <param name="message">The error message.</param>
  4093. </member>
  4094. <member name="M:MailKit.Net.Imap.ImapCommandException.#ctor(MailKit.Net.Imap.ImapCommandResponse,System.String)">
  4095. <summary>
  4096. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapCommandException"/> class.
  4097. </summary>
  4098. <remarks>
  4099. Creates a new <see cref="T:MailKit.Net.Imap.ImapCommandException"/>.
  4100. </remarks>
  4101. <param name="response">The IMAP command response.</param>
  4102. <param name="responseText">The human-readable response text.</param>
  4103. </member>
  4104. <member name="P:MailKit.Net.Imap.ImapCommandException.Response">
  4105. <summary>
  4106. Gets the IMAP command response.
  4107. </summary>
  4108. <remarks>
  4109. Gets the IMAP command response.
  4110. </remarks>
  4111. <value>The IMAP command response.</value>
  4112. </member>
  4113. <member name="P:MailKit.Net.Imap.ImapCommandException.ResponseText">
  4114. <summary>
  4115. Gets the human-readable IMAP command response text.
  4116. </summary>
  4117. <remarks>
  4118. Gets the human-readable IMAP command response text.
  4119. </remarks>
  4120. <value>The response text.</value>
  4121. </member>
  4122. <member name="T:MailKit.Net.Imap.ImapCommandResponse">
  4123. <summary>
  4124. An enumeration of possible IMAP command responses.
  4125. </summary>
  4126. <remarks>
  4127. An enumeration of possible IMAP command responses.
  4128. </remarks>
  4129. </member>
  4130. <member name="F:MailKit.Net.Imap.ImapCommandResponse.None">
  4131. <summary>
  4132. No IMAP command response yet.
  4133. </summary>
  4134. </member>
  4135. <member name="F:MailKit.Net.Imap.ImapCommandResponse.Ok">
  4136. <summary>
  4137. The command resulted in an "OK" response.
  4138. </summary>
  4139. </member>
  4140. <member name="F:MailKit.Net.Imap.ImapCommandResponse.No">
  4141. <summary>
  4142. The command resulted in a "NO" response.
  4143. </summary>
  4144. </member>
  4145. <member name="F:MailKit.Net.Imap.ImapCommandResponse.Bad">
  4146. <summary>
  4147. The command resulted in a "BAD" response.
  4148. </summary>
  4149. </member>
  4150. <member name="T:MailKit.Net.Imap.ImapEngineState">
  4151. <summary>
  4152. The state of the <see cref="T:MailKit.Net.Imap.ImapEngine"/>.
  4153. </summary>
  4154. </member>
  4155. <member name="F:MailKit.Net.Imap.ImapEngineState.Disconnected">
  4156. <summary>
  4157. The ImapEngine is in the disconnected state.
  4158. </summary>
  4159. </member>
  4160. <member name="F:MailKit.Net.Imap.ImapEngineState.Connecting">
  4161. <summary>
  4162. The ImapEngine is in the process of connecting.
  4163. </summary>
  4164. </member>
  4165. <member name="F:MailKit.Net.Imap.ImapEngineState.Connected">
  4166. <summary>
  4167. The ImapEngine is connected but not yet authenticated.
  4168. </summary>
  4169. </member>
  4170. <member name="F:MailKit.Net.Imap.ImapEngineState.Authenticated">
  4171. <summary>
  4172. The ImapEngine is in the authenticated state.
  4173. </summary>
  4174. </member>
  4175. <member name="F:MailKit.Net.Imap.ImapEngineState.Selected">
  4176. <summary>
  4177. The ImapEngine is in the selected state.
  4178. </summary>
  4179. </member>
  4180. <member name="F:MailKit.Net.Imap.ImapEngineState.Idle">
  4181. <summary>
  4182. The ImapEngine is in the IDLE state.
  4183. </summary>
  4184. </member>
  4185. <member name="T:MailKit.Net.Imap.ImapEngine">
  4186. <summary>
  4187. An IMAP command engine.
  4188. </summary>
  4189. </member>
  4190. <member name="P:MailKit.Net.Imap.ImapEngine.AuthenticationMechanisms">
  4191. <summary>
  4192. Get the authentication mechanisms supported by the IMAP server.
  4193. </summary>
  4194. <remarks>
  4195. The authentication mechanisms are queried durring the
  4196. <see cref="M:MailKit.Net.Imap.ImapEngine.ConnectAsync(MailKit.Net.Imap.ImapStream,System.Boolean,System.Threading.CancellationToken)"/> method.
  4197. </remarks>
  4198. <value>The authentication mechanisms.</value>
  4199. </member>
  4200. <member name="P:MailKit.Net.Imap.ImapEngine.CompressionAlgorithms">
  4201. <summary>
  4202. Get the compression algorithms supported by the IMAP server.
  4203. </summary>
  4204. <remarks>
  4205. The compression algorithms are populated by the
  4206. <see cref="M:MailKit.Net.Imap.ImapEngine.QueryCapabilitiesAsync(System.Boolean,System.Threading.CancellationToken)"/> method.
  4207. </remarks>
  4208. <value>The compression algorithms.</value>
  4209. </member>
  4210. <member name="P:MailKit.Net.Imap.ImapEngine.ThreadingAlgorithms">
  4211. <summary>
  4212. Get the threading algorithms supported by the IMAP server.
  4213. </summary>
  4214. <remarks>
  4215. The threading algorithms are populated by the
  4216. <see cref="M:MailKit.Net.Imap.ImapEngine.QueryCapabilitiesAsync(System.Boolean,System.Threading.CancellationToken)"/> method.
  4217. </remarks>
  4218. <value>The threading algorithms.</value>
  4219. </member>
  4220. <member name="P:MailKit.Net.Imap.ImapEngine.AppendLimit">
  4221. <summary>
  4222. Gets the append limit supported by the IMAP server.
  4223. </summary>
  4224. <remarks>
  4225. Gets the append limit supported by the IMAP server.
  4226. </remarks>
  4227. <value>The append limit.</value>
  4228. </member>
  4229. <member name="P:MailKit.Net.Imap.ImapEngine.I18NLevel">
  4230. <summary>
  4231. Gets the I18NLEVEL supported by the IMAP server.
  4232. </summary>
  4233. <remarks>
  4234. Gets the I18NLEVEL supported by the IMAP server.
  4235. </remarks>
  4236. <value>The internationalization level.</value>
  4237. </member>
  4238. <member name="P:MailKit.Net.Imap.ImapEngine.Capabilities">
  4239. <summary>
  4240. Get the capabilities supported by the IMAP server.
  4241. </summary>
  4242. <remarks>
  4243. The capabilities will not be known until a successful connection
  4244. has been made via the <see cref="M:MailKit.Net.Imap.ImapEngine.ConnectAsync(MailKit.Net.Imap.ImapStream,System.Boolean,System.Threading.CancellationToken)"/> method.
  4245. </remarks>
  4246. <value>The capabilities.</value>
  4247. </member>
  4248. <member name="P:MailKit.Net.Imap.ImapEngine.IsBusy">
  4249. <summary>
  4250. Indicates whether or not the engine is busy processing commands.
  4251. </summary>
  4252. <remarks>
  4253. Indicates whether or not the engine is busy processing commands.
  4254. </remarks>
  4255. <value><c>true</c> if th e engine is busy processing commands; otherwise, <c>false</c>.</value>
  4256. </member>
  4257. <member name="P:MailKit.Net.Imap.ImapEngine.CapabilitiesVersion">
  4258. <summary>
  4259. Get the capabilities version.
  4260. </summary>
  4261. <remarks>
  4262. Every time the engine receives an untagged CAPABILITIES
  4263. response from the server, it increments this value.
  4264. </remarks>
  4265. <value>The capabilities version.</value>
  4266. </member>
  4267. <member name="P:MailKit.Net.Imap.ImapEngine.ProtocolVersion">
  4268. <summary>
  4269. Get the IMAP protocol version.
  4270. </summary>
  4271. <remarks>
  4272. Gets the IMAP protocol version.
  4273. </remarks>
  4274. <value>The IMAP protocol version.</value>
  4275. </member>
  4276. <member name="P:MailKit.Net.Imap.ImapEngine.Rights">
  4277. <summary>
  4278. Get the rights specified in the capabilities.
  4279. </summary>
  4280. <remarks>
  4281. Gets the rights specified in the capabilities.
  4282. </remarks>
  4283. <value>The rights.</value>
  4284. </member>
  4285. <member name="P:MailKit.Net.Imap.ImapEngine.SupportedCharsets">
  4286. <summary>
  4287. Get the supported charsets.
  4288. </summary>
  4289. <remarks>
  4290. Gets the supported charsets.
  4291. </remarks>
  4292. <value>The supported charsets.</value>
  4293. </member>
  4294. <member name="P:MailKit.Net.Imap.ImapEngine.SupportedContexts">
  4295. <summary>
  4296. Get the supported contexts.
  4297. </summary>
  4298. <remarks>
  4299. Gets the supported contexts.
  4300. </remarks>
  4301. <value>The supported contexts.</value>
  4302. </member>
  4303. <member name="P:MailKit.Net.Imap.ImapEngine.QResyncEnabled">
  4304. <summary>
  4305. Get whether or not the QRESYNC feature has been enabled.
  4306. </summary>
  4307. <remarks>
  4308. Gets whether or not the QRESYNC feature has been enabled.
  4309. </remarks>
  4310. <value><c>true</c> if the QRESYNC feature has been enabled; otherwise, <c>false</c>.</value>
  4311. </member>
  4312. <member name="P:MailKit.Net.Imap.ImapEngine.UTF8Enabled">
  4313. <summary>
  4314. Get whether or not the UTF8=ACCEPT feature has been enabled.
  4315. </summary>
  4316. <remarks>
  4317. Gets whether or not the UTF8=ACCEPT feature has been enabled.
  4318. </remarks>
  4319. <value><c>true</c> if the UTF8=ACCEPT feature has been enabled; otherwise, <c>false</c>.</value>
  4320. </member>
  4321. <member name="P:MailKit.Net.Imap.ImapEngine.Uri">
  4322. <summary>
  4323. Get the URI of the IMAP server.
  4324. </summary>
  4325. <remarks>
  4326. Gets the URI of the IMAP server.
  4327. </remarks>
  4328. <value>The URI of the IMAP server.</value>
  4329. </member>
  4330. <member name="P:MailKit.Net.Imap.ImapEngine.Stream">
  4331. <summary>
  4332. Get the underlying IMAP stream.
  4333. </summary>
  4334. <remarks>
  4335. Gets the underlying IMAP stream.
  4336. </remarks>
  4337. <value>The IMAP stream.</value>
  4338. </member>
  4339. <member name="P:MailKit.Net.Imap.ImapEngine.State">
  4340. <summary>
  4341. Get or sets the state of the engine.
  4342. </summary>
  4343. <remarks>
  4344. Gets or sets the state of the engine.
  4345. </remarks>
  4346. <value>The engine state.</value>
  4347. </member>
  4348. <member name="P:MailKit.Net.Imap.ImapEngine.IsConnected">
  4349. <summary>
  4350. Get whether or not the engine is currently connected to a IMAP server.
  4351. </summary>
  4352. <remarks>
  4353. Gets whether or not the engine is currently connected to a IMAP server.
  4354. </remarks>
  4355. <value><c>true</c> if the engine is connected; otherwise, <c>false</c>.</value>
  4356. </member>
  4357. <member name="P:MailKit.Net.Imap.ImapEngine.PersonalNamespaces">
  4358. <summary>
  4359. Gets the personal folder namespaces.
  4360. </summary>
  4361. <remarks>
  4362. Gets the personal folder namespaces.
  4363. </remarks>
  4364. <value>The personal folder namespaces.</value>
  4365. </member>
  4366. <member name="P:MailKit.Net.Imap.ImapEngine.SharedNamespaces">
  4367. <summary>
  4368. Gets the shared folder namespaces.
  4369. </summary>
  4370. <remarks>
  4371. Gets the shared folder namespaces.
  4372. </remarks>
  4373. <value>The shared folder namespaces.</value>
  4374. </member>
  4375. <member name="P:MailKit.Net.Imap.ImapEngine.OtherNamespaces">
  4376. <summary>
  4377. Gets the other folder namespaces.
  4378. </summary>
  4379. <remarks>
  4380. Gets the other folder namespaces.
  4381. </remarks>
  4382. <value>The other folder namespaces.</value>
  4383. </member>
  4384. <member name="P:MailKit.Net.Imap.ImapEngine.Selected">
  4385. <summary>
  4386. Gets the selected folder.
  4387. </summary>
  4388. <remarks>
  4389. Gets the selected folder.
  4390. </remarks>
  4391. <value>The selected folder.</value>
  4392. </member>
  4393. <member name="P:MailKit.Net.Imap.ImapEngine.IsDisposed">
  4394. <summary>
  4395. Gets a value indicating whether the engine is disposed.
  4396. </summary>
  4397. <remarks>
  4398. Gets a value indicating whether the engine is disposed.
  4399. </remarks>
  4400. <value><c>true</c> if the engine is disposed; otherwise, <c>false</c>.</value>
  4401. </member>
  4402. <member name="P:MailKit.Net.Imap.ImapEngine.NotifySelectedNewExpunge">
  4403. <summary>
  4404. Gets whether the current NOTIFY status prevents using indexes and * for referencing messages.
  4405. </summary>
  4406. <remarks>
  4407. Gets whether the current NOTIFY status prevents using indexes and * for referencing messages. This is the case when the client has asked for MessageNew or MessageExpunge events on the SELECTED mailbox.
  4408. </remarks>
  4409. <value><c>true</c> if the use of indexes and * is prevented; otherwise, <c>false</c>.</value>
  4410. </member>
  4411. <member name="P:MailKit.Net.Imap.ImapEngine.Inbox">
  4412. <summary>
  4413. Gets the Inbox folder.
  4414. </summary>
  4415. <value>The Inbox folder.</value>
  4416. </member>
  4417. <member name="P:MailKit.Net.Imap.ImapEngine.All">
  4418. <summary>
  4419. Gets the special folder containing an aggregate of all messages.
  4420. </summary>
  4421. <value>The folder containing all messages.</value>
  4422. </member>
  4423. <member name="P:MailKit.Net.Imap.ImapEngine.Archive">
  4424. <summary>
  4425. Gets the special archive folder.
  4426. </summary>
  4427. <value>The archive folder.</value>
  4428. </member>
  4429. <member name="P:MailKit.Net.Imap.ImapEngine.Drafts">
  4430. <summary>
  4431. Gets the special folder containing drafts.
  4432. </summary>
  4433. <value>The drafts folder.</value>
  4434. </member>
  4435. <member name="P:MailKit.Net.Imap.ImapEngine.Flagged">
  4436. <summary>
  4437. Gets the special folder containing flagged messages.
  4438. </summary>
  4439. <value>The flagged folder.</value>
  4440. </member>
  4441. <member name="P:MailKit.Net.Imap.ImapEngine.Junk">
  4442. <summary>
  4443. Gets the special folder containing junk messages.
  4444. </summary>
  4445. <value>The junk folder.</value>
  4446. </member>
  4447. <member name="P:MailKit.Net.Imap.ImapEngine.Sent">
  4448. <summary>
  4449. Gets the special folder containing sent messages.
  4450. </summary>
  4451. <value>The sent.</value>
  4452. </member>
  4453. <member name="P:MailKit.Net.Imap.ImapEngine.Trash">
  4454. <summary>
  4455. Gets the folder containing deleted messages.
  4456. </summary>
  4457. <value>The trash folder.</value>
  4458. </member>
  4459. <member name="M:MailKit.Net.Imap.ImapEngine.SetStream(MailKit.Net.Imap.ImapStream)">
  4460. <summary>
  4461. Sets the stream - this is only here to be used by the unit tests.
  4462. </summary>
  4463. <param name="stream">The IMAP stream.</param>
  4464. </member>
  4465. <member name="M:MailKit.Net.Imap.ImapEngine.ConnectAsync(MailKit.Net.Imap.ImapStream,System.Boolean,System.Threading.CancellationToken)">
  4466. <summary>
  4467. Takes posession of the <see cref="T:MailKit.Net.Imap.ImapStream"/> and reads the greeting.
  4468. </summary>
  4469. <param name="stream">The IMAP stream.</param>
  4470. <param name="doAsync">Whether or not asyncrhonois IO methods should be used.</param>
  4471. <param name="cancellationToken">The cancellation token.</param>
  4472. <exception cref="T:System.OperationCanceledException">
  4473. The operation was canceled via the cancellation token.
  4474. </exception>
  4475. <exception cref="T:System.IO.IOException">
  4476. An I/O error occurred.
  4477. </exception>
  4478. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  4479. An IMAP protocol error occurred.
  4480. </exception>
  4481. </member>
  4482. <member name="M:MailKit.Net.Imap.ImapEngine.Disconnect">
  4483. <summary>
  4484. Disconnects the <see cref="T:MailKit.Net.Imap.ImapEngine"/>.
  4485. </summary>
  4486. <remarks>
  4487. Disconnects the <see cref="T:MailKit.Net.Imap.ImapEngine"/>.
  4488. </remarks>
  4489. </member>
  4490. <member name="M:MailKit.Net.Imap.ImapEngine.ReadToken(System.Threading.CancellationToken)">
  4491. <summary>
  4492. Reads the next token.
  4493. </summary>
  4494. <returns>The token.</returns>
  4495. <param name="cancellationToken">The cancellation token.</param>
  4496. <exception cref="T:System.InvalidOperationException">
  4497. The engine is not connected.
  4498. </exception>
  4499. <exception cref="T:System.OperationCanceledException">
  4500. The operation was canceled via the cancellation token.
  4501. </exception>
  4502. <exception cref="T:System.IO.IOException">
  4503. An I/O error occurred.
  4504. </exception>
  4505. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  4506. An IMAP protocol error occurred.
  4507. </exception>
  4508. </member>
  4509. <member name="M:MailKit.Net.Imap.ImapEngine.ParseResponseCodeAsync(System.Boolean,System.Boolean,System.Threading.CancellationToken)">
  4510. <summary>
  4511. Parses the response code.
  4512. </summary>
  4513. <returns>The response code.</returns>
  4514. <param name="isTagged">Whether or not the resp-code is tagged vs untagged.</param>
  4515. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  4516. <param name="cancellationToken">The cancellation token.</param>
  4517. </member>
  4518. <member name="M:MailKit.Net.Imap.ImapEngine.ProcessUntaggedResponseAsync(System.Boolean,System.Threading.CancellationToken)">
  4519. <summary>
  4520. Processes an untagged response.
  4521. </summary>
  4522. <returns>The untagged response.</returns>
  4523. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  4524. <param name="cancellationToken">The cancellation token.</param>
  4525. </member>
  4526. <member name="M:MailKit.Net.Imap.ImapEngine.IterateAsync(System.Boolean)">
  4527. <summary>
  4528. Iterate the command pipeline.
  4529. </summary>
  4530. </member>
  4531. <member name="M:MailKit.Net.Imap.ImapEngine.RunAsync(MailKit.Net.Imap.ImapCommand,System.Boolean)">
  4532. <summary>
  4533. Wait for the specified command to finish.
  4534. </summary>
  4535. <param name="ic">The IMAP command.</param>
  4536. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  4537. <exception cref="T:System.ArgumentNullException">
  4538. <paramref name="ic"/> is <c>null</c>.
  4539. </exception>
  4540. </member>
  4541. <member name="M:MailKit.Net.Imap.ImapEngine.QueueCommand(System.Threading.CancellationToken,MailKit.Net.Imap.ImapFolder,MimeKit.FormatOptions,System.String,System.Object[])">
  4542. <summary>
  4543. Queues the command.
  4544. </summary>
  4545. <returns>The command.</returns>
  4546. <param name="cancellationToken">The cancellation token.</param>
  4547. <param name="folder">The folder that the command operates on.</param>
  4548. <param name="options">The formatting options.</param>
  4549. <param name="format">The command format.</param>
  4550. <param name="args">The command arguments.</param>
  4551. </member>
  4552. <member name="M:MailKit.Net.Imap.ImapEngine.QueueCommand(System.Threading.CancellationToken,MailKit.Net.Imap.ImapFolder,System.String,System.Object[])">
  4553. <summary>
  4554. Queues the command.
  4555. </summary>
  4556. <returns>The command.</returns>
  4557. <param name="cancellationToken">The cancellation token.</param>
  4558. <param name="folder">The folder that the command operates on.</param>
  4559. <param name="format">The command format.</param>
  4560. <param name="args">The command arguments.</param>
  4561. </member>
  4562. <member name="M:MailKit.Net.Imap.ImapEngine.QueueCommand(MailKit.Net.Imap.ImapCommand)">
  4563. <summary>
  4564. Queues the command.
  4565. </summary>
  4566. <param name="ic">The IMAP command.</param>
  4567. </member>
  4568. <member name="M:MailKit.Net.Imap.ImapEngine.QueryCapabilitiesAsync(System.Boolean,System.Threading.CancellationToken)">
  4569. <summary>
  4570. Queries the capabilities.
  4571. </summary>
  4572. <returns>The command result.</returns>
  4573. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  4574. <param name="cancellationToken">The cancellation token.</param>
  4575. </member>
  4576. <member name="M:MailKit.Net.Imap.ImapEngine.CacheFolder(MailKit.Net.Imap.ImapFolder)">
  4577. <summary>
  4578. Cache the specified folder.
  4579. </summary>
  4580. <param name="folder">The folder.</param>
  4581. </member>
  4582. <member name="M:MailKit.Net.Imap.ImapEngine.GetCachedFolder(System.String,MailKit.Net.Imap.ImapFolder@)">
  4583. <summary>
  4584. Gets the cached folder.
  4585. </summary>
  4586. <returns><c>true</c> if the folder was retreived from the cache; otherwise, <c>false</c>.</returns>
  4587. <param name="encodedName">The encoded folder name.</param>
  4588. <param name="folder">The cached folder.</param>
  4589. </member>
  4590. <member name="M:MailKit.Net.Imap.ImapEngine.LookupParentFoldersAsync(System.Collections.Generic.IEnumerable{MailKit.Net.Imap.ImapFolder},System.Boolean,System.Threading.CancellationToken)">
  4591. <summary>
  4592. Looks up and sets the <see cref="P:MailKit.MailFolder.ParentFolder"/> property of each of the folders.
  4593. </summary>
  4594. <param name="folders">The IMAP folders.</param>
  4595. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  4596. <param name="cancellationToken">The cancellation token.</param>
  4597. </member>
  4598. <member name="M:MailKit.Net.Imap.ImapEngine.QueryNamespacesAsync(System.Boolean,System.Threading.CancellationToken)">
  4599. <summary>
  4600. Queries the namespaces.
  4601. </summary>
  4602. <returns>The command result.</returns>
  4603. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  4604. <param name="cancellationToken">The cancellation token.</param>
  4605. </member>
  4606. <member name="M:MailKit.Net.Imap.ImapEngine.AssignSpecialFolder(MailKit.Net.Imap.ImapFolder)">
  4607. <summary>
  4608. Assigns a folder as a special folder.
  4609. </summary>
  4610. <param name="folder">The special folder.</param>
  4611. </member>
  4612. <member name="M:MailKit.Net.Imap.ImapEngine.AssignSpecialFolders(System.Collections.Generic.IList{MailKit.Net.Imap.ImapFolder})">
  4613. <summary>
  4614. Assigns the special folders.
  4615. </summary>
  4616. <param name="list">The list of folders.</param>
  4617. </member>
  4618. <member name="M:MailKit.Net.Imap.ImapEngine.QuerySpecialFoldersAsync(System.Boolean,System.Threading.CancellationToken)">
  4619. <summary>
  4620. Queries the special folders.
  4621. </summary>
  4622. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  4623. <param name="cancellationToken">The cancellation token.</param>
  4624. </member>
  4625. <member name="M:MailKit.Net.Imap.ImapEngine.GetQuotaRootFolderAsync(System.String,System.Boolean,System.Threading.CancellationToken)">
  4626. <summary>
  4627. Gets the folder representing the specified quota root.
  4628. </summary>
  4629. <returns>The folder.</returns>
  4630. <param name="quotaRoot">The name of the quota root.</param>
  4631. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  4632. <param name="cancellationToken">The cancellation token.</param>
  4633. </member>
  4634. <member name="M:MailKit.Net.Imap.ImapEngine.GetFolderAsync(System.String,System.Boolean,System.Threading.CancellationToken)">
  4635. <summary>
  4636. Gets the folder for the specified path.
  4637. </summary>
  4638. <returns>The folder.</returns>
  4639. <param name="path">The folder path.</param>
  4640. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  4641. <param name="cancellationToken">The cancellation token.</param>
  4642. </member>
  4643. <member name="M:MailKit.Net.Imap.ImapEngine.GetFoldersAsync(MailKit.FolderNamespace,MailKit.StatusItems,System.Boolean,System.Boolean,System.Threading.CancellationToken)">
  4644. <summary>
  4645. Get all of the folders within the specified namespace.
  4646. </summary>
  4647. <remarks>
  4648. Gets all of the folders within the specified namespace.
  4649. </remarks>
  4650. <returns>The list of folders.</returns>
  4651. <param name="namespace">The namespace.</param>
  4652. <param name="items">The status items to pre-populate.</param>
  4653. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  4654. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  4655. <param name="cancellationToken">The cancellation token.</param>
  4656. </member>
  4657. <member name="M:MailKit.Net.Imap.ImapEngine.DecodeMailboxName(System.String)">
  4658. <summary>
  4659. Decodes the name of the mailbox.
  4660. </summary>
  4661. <returns>The mailbox name.</returns>
  4662. <param name="encodedName">The encoded name.</param>
  4663. </member>
  4664. <member name="M:MailKit.Net.Imap.ImapEngine.EncodeMailboxName(System.String)">
  4665. <summary>
  4666. Encodes the name of the mailbox.
  4667. </summary>
  4668. <returns>The mailbox name.</returns>
  4669. <param name="mailboxName">The encoded mailbox name.</param>
  4670. </member>
  4671. <member name="M:MailKit.Net.Imap.ImapEngine.IsValidMailboxName(System.String,System.Char)">
  4672. <summary>
  4673. Determines whether the mailbox name is valid or not.
  4674. </summary>
  4675. <returns><c>true</c> if the mailbox name is valid; otherwise, <c>false</c>.</returns>
  4676. <param name="mailboxName">The mailbox name.</param>
  4677. <param name="delim">The path delimeter.</param>
  4678. </member>
  4679. <member name="E:MailKit.Net.Imap.ImapEngine.Alert">
  4680. <summary>
  4681. Occurs when the engine receives an alert message from the server.
  4682. </summary>
  4683. </member>
  4684. <member name="E:MailKit.Net.Imap.ImapEngine.FolderCreated">
  4685. <summary>
  4686. Occurs when the engine receives a notification that a folder has been created.
  4687. </summary>
  4688. </member>
  4689. <member name="E:MailKit.Net.Imap.ImapEngine.MetadataChanged">
  4690. <summary>
  4691. Occurs when the engine receives a notification that metadata has changed.
  4692. </summary>
  4693. </member>
  4694. <member name="E:MailKit.Net.Imap.ImapEngine.NotificationOverflow">
  4695. <summary>
  4696. Occurs when the engine receives a notification overflow message from the server.
  4697. </summary>
  4698. </member>
  4699. <member name="M:MailKit.Net.Imap.ImapEngine.Dispose">
  4700. <summary>
  4701. Releases all resource used by the <see cref="T:MailKit.Net.Imap.ImapEngine"/> object.
  4702. </summary>
  4703. <remarks>Call <see cref="M:MailKit.Net.Imap.ImapEngine.Dispose"/> when you are finished using the <see cref="T:MailKit.Net.Imap.ImapEngine"/>. The
  4704. <see cref="M:MailKit.Net.Imap.ImapEngine.Dispose"/> method leaves the <see cref="T:MailKit.Net.Imap.ImapEngine"/> in an unusable state. After
  4705. calling <see cref="M:MailKit.Net.Imap.ImapEngine.Dispose"/>, you must release all references to the <see cref="T:MailKit.Net.Imap.ImapEngine"/> so
  4706. the garbage collector can reclaim the memory that the <see cref="T:MailKit.Net.Imap.ImapEngine"/> was occupying.</remarks>
  4707. </member>
  4708. <member name="T:MailKit.Net.Imap.ImapEventGroup">
  4709. <summary>
  4710. An IMAP event group used with the NOTIFY command.
  4711. </summary>
  4712. <remarks>
  4713. An IMAP event group used with the NOTIFY command.
  4714. </remarks>
  4715. </member>
  4716. <member name="M:MailKit.Net.Imap.ImapEventGroup.#ctor(MailKit.Net.Imap.ImapMailboxFilter,System.Collections.Generic.IList{MailKit.Net.Imap.ImapEvent})">
  4717. <summary>
  4718. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapEventGroup"/> class.
  4719. </summary>
  4720. <remarks>
  4721. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapEventGroup"/> class.
  4722. </remarks>
  4723. <param name="mailboxFilter">The mailbox filter.</param>
  4724. <param name="events">The list of IMAP events.</param>
  4725. <exception cref="T:System.ArgumentNullException">
  4726. <para><paramref name="mailboxFilter"/> is <c>null</c>.</para>
  4727. <para>-or-</para>
  4728. <para><paramref name="events"/> is <c>null</c>.</para>
  4729. </exception>
  4730. </member>
  4731. <member name="P:MailKit.Net.Imap.ImapEventGroup.MailboxFilter">
  4732. <summary>
  4733. Get the mailbox filter.
  4734. </summary>
  4735. <remarks>
  4736. Gets the mailbox filter.
  4737. </remarks>
  4738. <value>The mailbox filter.</value>
  4739. </member>
  4740. <member name="P:MailKit.Net.Imap.ImapEventGroup.Events">
  4741. <summary>
  4742. Get the list of IMAP events.
  4743. </summary>
  4744. <remarks>
  4745. Gets the list of IMAP events.
  4746. </remarks>
  4747. <value>The events.</value>
  4748. </member>
  4749. <member name="M:MailKit.Net.Imap.ImapEventGroup.Format(MailKit.Net.Imap.ImapEngine,System.Text.StringBuilder,System.Collections.Generic.IList{System.Object},System.Boolean@)">
  4750. <summary>
  4751. Format the IMAP NOTIFY command for this particular IMAP event group.
  4752. </summary>
  4753. <remarks>
  4754. Formats the IMAP NOTIFY command for this particular IMAP event group.
  4755. </remarks>
  4756. <param name="engine">The IMAP engine.</param>
  4757. <param name="command">The IMAP command builder.</param>
  4758. <param name="args">The IMAP command argument builder.</param>
  4759. <param name="notifySelectedNewExpunge">Gets set to <c>true</c> if the NOTIFY command requests the MessageNew or
  4760. MessageExpunged events for a SELECTED or SELECTED-DELAYED mailbox filter; otherwise it is left unchanged.</param>
  4761. </member>
  4762. <member name="T:MailKit.Net.Imap.ImapMailboxFilter">
  4763. <summary>
  4764. An IMAP mailbox filter for use with the NOTIFY command.
  4765. </summary>
  4766. <remarks>
  4767. An IMAP mailbox filter for use with the NOTIFY command.
  4768. </remarks>
  4769. </member>
  4770. <member name="F:MailKit.Net.Imap.ImapMailboxFilter.Selected">
  4771. <summary>
  4772. An IMAP mailbox filter specifying that the client wants immediate notifications for
  4773. the currently selected folder.
  4774. </summary>
  4775. <remarks>
  4776. The <c>SELECTED</c> mailbox specifier requires the server to send immediate
  4777. notifications for the currently selected mailbox about all specified
  4778. message events.
  4779. </remarks>
  4780. </member>
  4781. <member name="F:MailKit.Net.Imap.ImapMailboxFilter.SelectedDelayed">
  4782. <summary>
  4783. An IMAP mailbox filter specifying the currently selected folder but delays notifications
  4784. until a command has been issued.
  4785. </summary>
  4786. <remarks>
  4787. The <c>SELECTED-DELAYED</c> mailbox specifier requires the server to delay a
  4788. <see cref="F:MailKit.Net.Imap.ImapEvent.MessageExpunge"/> event until the client issues a command that allows
  4789. returning information about expunged messages (see
  4790. <a href="https://tools.ietf.org/html/rfc3501#section-7.4.1">Section 7.4.1 of RFC3501]</a>
  4791. for more details), for example, till a <c>NOOP</c> or an <c>IDLE</c> command has been issued.
  4792. When <c>SELECTED-DELAYED</c> is specified, the server MAY also delay returning other message
  4793. events until the client issues one of the commands specified above, or it MAY return them
  4794. immediately.
  4795. </remarks>
  4796. </member>
  4797. <member name="F:MailKit.Net.Imap.ImapMailboxFilter.Inboxes">
  4798. <summary>
  4799. An IMAP mailbox filter specifying the currently selected folder.
  4800. </summary>
  4801. <remarks>
  4802. <para>The <c>INBOXES</c> mailbox specifier refers to all selectable mailboxes in the user's
  4803. personal namespace(s) to which messages may be delivered by a Message Delivery Agent (MDA).
  4804. </para>
  4805. <para>If the IMAP server cannot easily compute this set, it MUST treat <see cref="F:MailKit.Net.Imap.ImapMailboxFilter.Inboxes"/>
  4806. as equivalent to <see cref="F:MailKit.Net.Imap.ImapMailboxFilter.Personal"/>.</para>
  4807. </remarks>
  4808. </member>
  4809. <member name="F:MailKit.Net.Imap.ImapMailboxFilter.Personal">
  4810. <summary>
  4811. An IMAP mailbox filter specifying all selectable folders within the user's personal namespace.
  4812. </summary>
  4813. <remarks>
  4814. The <c>PERSONAL</c> mailbox specifier refers to all selectable folders within the user's personal namespace.
  4815. </remarks>
  4816. </member>
  4817. <member name="F:MailKit.Net.Imap.ImapMailboxFilter.Subscribed">
  4818. <summary>
  4819. An IMAP mailbox filter that refers to all subscribed folders.
  4820. </summary>
  4821. <remarks>
  4822. <para>The <c>SUBSCRIBED</c> mailbox specifier refers to all folders subscribed to by the user.</para>
  4823. <para>If the subscription list changes, the server MUST reevaluate the list.</para>
  4824. </remarks>
  4825. </member>
  4826. <member name="T:MailKit.Net.Imap.ImapMailboxFilter.Mailboxes">
  4827. <summary>
  4828. An IMAP mailbox filter that specifies a list of folders to receive notifications about.
  4829. </summary>
  4830. <remarks>
  4831. An IMAP mailbox filter that specifies a list of folders to receive notifications about.
  4832. </remarks>
  4833. </member>
  4834. <member name="M:MailKit.Net.Imap.ImapMailboxFilter.Mailboxes.#ctor(System.Collections.Generic.IList{MailKit.IMailFolder})">
  4835. <summary>
  4836. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapMailboxFilter.Mailboxes"/> class.
  4837. </summary>
  4838. <remarks>
  4839. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapMailboxFilter.Mailboxes"/> class.
  4840. </remarks>
  4841. <param name="folders">The list of folders to watch for events.</param>
  4842. <exception cref="T:System.ArgumentNullException">
  4843. <paramref name="folders"/> is <c>null</c>.
  4844. </exception>
  4845. <exception cref="T:System.ArgumentException">
  4846. <para>The list of <paramref name="folders"/> is empty.</para>
  4847. <para>-or-</para>
  4848. <para>The list of <paramref name="folders"/> contains folders that are not of
  4849. type <see cref="T:MailKit.Net.Imap.ImapFolder"/>.</para>
  4850. </exception>
  4851. </member>
  4852. <member name="M:MailKit.Net.Imap.ImapMailboxFilter.Mailboxes.#ctor(MailKit.IMailFolder[])">
  4853. <summary>
  4854. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapMailboxFilter.Mailboxes"/> class.
  4855. </summary>
  4856. <remarks>
  4857. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapMailboxFilter.Mailboxes"/> class.
  4858. </remarks>
  4859. <param name="folders">The list of folders to watch for events.</param>
  4860. <exception cref="T:System.ArgumentNullException">
  4861. <paramref name="folders"/> is <c>null</c>.
  4862. </exception>
  4863. <exception cref="T:System.ArgumentException">
  4864. <para>The list of <paramref name="folders"/> is empty.</para>
  4865. <para>-or-</para>
  4866. <para>The list of <paramref name="folders"/> contains folders that are not of
  4867. type <see cref="T:MailKit.Net.Imap.ImapFolder"/>.</para>
  4868. </exception>
  4869. </member>
  4870. <member name="M:MailKit.Net.Imap.ImapMailboxFilter.Mailboxes.#ctor(System.String,System.Collections.Generic.IList{MailKit.IMailFolder})">
  4871. <summary>
  4872. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapMailboxFilter.Mailboxes"/> class.
  4873. </summary>
  4874. <remarks>
  4875. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapMailboxFilter.Mailboxes"/> class.
  4876. </remarks>
  4877. <param name="name">The name of the mailbox filter.</param>
  4878. <param name="folders">The list of folders to watch for events.</param>
  4879. <exception cref="T:System.ArgumentNullException">
  4880. <paramref name="folders"/> is <c>null</c>.
  4881. </exception>
  4882. <exception cref="T:System.ArgumentException">
  4883. <para>The list of <paramref name="folders"/> is empty.</para>
  4884. <para>-or-</para>
  4885. <para>The list of <paramref name="folders"/> contains folders that are not of
  4886. type <see cref="T:MailKit.Net.Imap.ImapFolder"/>.</para>
  4887. </exception>
  4888. </member>
  4889. <member name="M:MailKit.Net.Imap.ImapMailboxFilter.Mailboxes.Format(MailKit.Net.Imap.ImapEngine,System.Text.StringBuilder,System.Collections.Generic.IList{System.Object})">
  4890. <summary>
  4891. Format the IMAP NOTIFY command for this particular IMAP mailbox filter.
  4892. </summary>
  4893. <remarks>
  4894. Formats the IMAP NOTIFY command for this particular IMAP mailbox filter.
  4895. </remarks>
  4896. <param name="engine">The IMAP engine.</param>
  4897. <param name="command">The IMAP command builder.</param>
  4898. <param name="args">The IMAP command argument builder.</param>
  4899. </member>
  4900. <member name="T:MailKit.Net.Imap.ImapMailboxFilter.Subtree">
  4901. <summary>
  4902. An IMAP mailbox filter that specifies a list of folder subtrees to get notifications about.
  4903. </summary>
  4904. <remarks>
  4905. <para>The client will receive notifications for each specified folder plus all selectable
  4906. folders that are subordinate to any of the specified folders.</para>
  4907. </remarks>
  4908. </member>
  4909. <member name="M:MailKit.Net.Imap.ImapMailboxFilter.Subtree.#ctor(System.Collections.Generic.IList{MailKit.IMailFolder})">
  4910. <summary>
  4911. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapMailboxFilter.Subtree"/> class.
  4912. </summary>
  4913. <remarks>
  4914. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapMailboxFilter.Subtree"/> class.
  4915. </remarks>
  4916. <param name="folders">The list of folders to watch for events.</param>
  4917. <exception cref="T:System.ArgumentNullException">
  4918. <paramref name="folders"/> is <c>null</c>.
  4919. </exception>
  4920. <exception cref="T:System.ArgumentException">
  4921. <para>The list of <paramref name="folders"/> is empty.</para>
  4922. <para>-or-</para>
  4923. <para>The list of <paramref name="folders"/> contains folders that are not of
  4924. type <see cref="T:MailKit.Net.Imap.ImapFolder"/>.</para>
  4925. </exception>
  4926. </member>
  4927. <member name="M:MailKit.Net.Imap.ImapMailboxFilter.Subtree.#ctor(MailKit.IMailFolder[])">
  4928. <summary>
  4929. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapMailboxFilter.Subtree"/> class.
  4930. </summary>
  4931. <remarks>
  4932. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapMailboxFilter.Subtree"/> class.
  4933. </remarks>
  4934. <param name="folders">The list of folders to watch for events.</param>
  4935. <exception cref="T:System.ArgumentNullException">
  4936. <paramref name="folders"/> is <c>null</c>.
  4937. </exception>
  4938. <exception cref="T:System.ArgumentException">
  4939. <para>The list of <paramref name="folders"/> is empty.</para>
  4940. <para>-or-</para>
  4941. <para>The list of <paramref name="folders"/> contains folders that are not of
  4942. type <see cref="T:MailKit.Net.Imap.ImapFolder"/>.</para>
  4943. </exception>
  4944. </member>
  4945. <member name="M:MailKit.Net.Imap.ImapMailboxFilter.#ctor(System.String)">
  4946. <summary>
  4947. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapMailboxFilter"/> class.
  4948. </summary>
  4949. <remarks>
  4950. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapMailboxFilter"/> class.
  4951. </remarks>
  4952. <param name="name">The name of the mailbox filter.</param>
  4953. </member>
  4954. <member name="P:MailKit.Net.Imap.ImapMailboxFilter.Name">
  4955. <summary>
  4956. Get the name of the mailbox filter.
  4957. </summary>
  4958. <remarks>
  4959. Gets the name of the mailbox filter.
  4960. </remarks>
  4961. <value>The name.</value>
  4962. </member>
  4963. <member name="M:MailKit.Net.Imap.ImapMailboxFilter.Format(MailKit.Net.Imap.ImapEngine,System.Text.StringBuilder,System.Collections.Generic.IList{System.Object})">
  4964. <summary>
  4965. Format the IMAP NOTIFY command for this particular IMAP mailbox filter.
  4966. </summary>
  4967. <remarks>
  4968. Formats the IMAP NOTIFY command for this particular IMAP mailbox filter.
  4969. </remarks>
  4970. <param name="engine">The IMAP engine.</param>
  4971. <param name="command">The IMAP command builder.</param>
  4972. <param name="args">The IMAP command argument builder.</param>
  4973. </member>
  4974. <member name="T:MailKit.Net.Imap.ImapEvent">
  4975. <summary>
  4976. An IMAP notification event.
  4977. </summary>
  4978. <remarks>
  4979. An IMAP notification event.
  4980. </remarks>
  4981. </member>
  4982. <member name="F:MailKit.Net.Imap.ImapEvent.MessageExpunge">
  4983. <summary>
  4984. An IMAP event notification for expunged messages.
  4985. </summary>
  4986. <remarks>
  4987. <para>If the expunged message or messages are in the selected mailbox, the server notifies the client
  4988. using <see cref="E:MailKit.IMailFolder.MessageExpunged"/> (or <see cref="E:MailKit.IMailFolder.MessagesVanished"/> if
  4989. the <a href="https://tools.ietf.org/html/rfc5162">QRESYNC</a> extension has been enabled via
  4990. <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/> or
  4991. <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResyncAsync(System.Threading.CancellationToken)"/>).</para>
  4992. <para>If the expunged message or messages are in another mailbox, the <see cref="P:MailKit.IMailFolder.UidNext"/>
  4993. and <see cref="P:MailKit.IMailFolder.Count"/> properties will be updated and the appropriate
  4994. <see cref="E:MailKit.IMailFolder.UidNextChanged"/> and <see cref="E:MailKit.IMailFolder.CountChanged"/> events will be
  4995. emitted for the relevant folder. If the <a href="https://tools.ietf.org/html/rfc5162">QRESYNC</a>
  4996. extension is enabled, the <see cref="P:MailKit.IMailFolder.HighestModSeq"/> property will also be updated and
  4997. the <see cref="E:MailKit.IMailFolder.HighestModSeqChanged"/> event will be emitted.</para>
  4998. <note type="note">if a client requests <see cref="F:MailKit.Net.Imap.ImapEvent.MessageExpunge"/> with the <see cref="F:MailKit.Net.Imap.ImapMailboxFilter.Selected"/>
  4999. mailbox specifier, the meaning of a message index can change at any time, so the client cannot use
  5000. message indexes in commands anymore. The client MUST use API variants that take <see cref="T:MailKit.UniqueId"/> or
  5001. a <see cref="T:System.Collections.Generic.IList`1"/>. The meaning of <c>*</c>* can also change when messages are added or expunged.
  5002. A client wishing to keep using message indexes can either use the <see cref="F:MailKit.Net.Imap.ImapMailboxFilter.SelectedDelayed"/>
  5003. mailbox specifier or can avoid using the <see cref="F:MailKit.Net.Imap.ImapEvent.MessageExpunge"/> event entirely.</note>
  5004. </remarks>
  5005. </member>
  5006. <member name="F:MailKit.Net.Imap.ImapEvent.FlagChange">
  5007. <summary>
  5008. An IMAP event notification for message flag changes.
  5009. </summary>
  5010. <remarks>
  5011. <para>If the <see cref="F:MailKit.Net.Imap.ImapEvent.FlagChange"/> notification arrives for a message located in the currently selected
  5012. folder, then that folder will emit a <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> event as well as a
  5013. <see cref="E:MailKit.IMailFolder.MessageSummaryFetched"/> event with an appropriately populated
  5014. <see cref="T:MailKit.IMessageSummary"/>.</para>
  5015. <para>On the other hand, if the <see cref="F:MailKit.Net.Imap.ImapEvent.FlagChange"/> notification arrives for a message that is not
  5016. located in the currently selected folder, then the events that are emitted will depend on the
  5017. <see cref="T:MailKit.Net.Imap.ImapCapabilities"/> of the IMAP server.</para>
  5018. <para>If the server supports the <see cref="F:MailKit.Net.Imap.ImapCapabilities.CondStore"/> capability (or the
  5019. <see cref="F:MailKit.Net.Imap.ImapCapabilities.QuickResync"/> capability and the client has enabled it via
  5020. <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/>), then the
  5021. <see cref="E:MailKit.IMailFolder.HighestModSeqChanged"/> event will be emitted as well as the
  5022. <see cref="E:MailKit.IMailFolder.UidValidityChanged"/> event (if the latter has changed). If the number of
  5023. seen messages has changed, then the <see cref="E:MailKit.IMailFolder.UnreadChanged"/> event may also be emitted.</para>
  5024. <para>If the server does not support either the <see cref="F:MailKit.Net.Imap.ImapCapabilities.CondStore"/> capability nor
  5025. the <see cref="F:MailKit.Net.Imap.ImapCapabilities.QuickResync"/> capability and the client has not enabled the later capability
  5026. via <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/>, then the server may choose
  5027. only to notify the client of <see cref="P:MailKit.IMailFolder.UidValidity"/> changes by emitting the
  5028. <see cref="E:MailKit.IMailFolder.UidValidityChanged"/> event.</para>
  5029. </remarks>
  5030. </member>
  5031. <member name="F:MailKit.Net.Imap.ImapEvent.AnnotationChange">
  5032. <summary>
  5033. An IMAP event notification for message annotation changes.
  5034. </summary>
  5035. <remarks>
  5036. <para>If the <see cref="F:MailKit.Net.Imap.ImapEvent.AnnotationChange"/> notification arrives for a message located in the currently selected
  5037. folder, then that folder will emit a <see cref="E:MailKit.IMailFolder.AnnotationsChanged"/> event as well as a
  5038. <see cref="E:MailKit.IMailFolder.MessageSummaryFetched"/> event with an appropriately populated
  5039. <see cref="T:MailKit.IMessageSummary"/>.</para>
  5040. <para>On the other hand, if the <see cref="F:MailKit.Net.Imap.ImapEvent.AnnotationChange"/> notification arrives for a message that is not
  5041. located in the currently selected folder, then the events that are emitted will depend on the
  5042. <see cref="T:MailKit.Net.Imap.ImapCapabilities"/> of the IMAP server.</para>
  5043. <para>If the server supports the <see cref="F:MailKit.Net.Imap.ImapCapabilities.CondStore"/> capability (or the
  5044. <see cref="F:MailKit.Net.Imap.ImapCapabilities.QuickResync"/> capability and the client has enabled it via
  5045. <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/>), then the
  5046. <see cref="E:MailKit.IMailFolder.HighestModSeqChanged"/> event will be emitted as well as the
  5047. <see cref="E:MailKit.IMailFolder.UidValidityChanged"/> event (if the latter has changed). If the number of
  5048. seen messages has changed, then the <see cref="E:MailKit.IMailFolder.UnreadChanged"/> event may also be emitted.</para>
  5049. <para>If the server does not support either the <see cref="F:MailKit.Net.Imap.ImapCapabilities.CondStore"/> capability nor
  5050. the <see cref="F:MailKit.Net.Imap.ImapCapabilities.QuickResync"/> capability and the client has not enabled the later capability
  5051. via <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/>, then the server may choose
  5052. only to notify the client of <see cref="P:MailKit.IMailFolder.UidValidity"/> changes by emitting the
  5053. <see cref="E:MailKit.IMailFolder.UidValidityChanged"/> event.</para>
  5054. </remarks>
  5055. </member>
  5056. <member name="F:MailKit.Net.Imap.ImapEvent.MailboxName">
  5057. <summary>
  5058. AN IMAP event notification for folders that have been created, deleted, or renamed.
  5059. </summary>
  5060. <remarks>
  5061. <para>These notifications are sent if an affected mailbox name was created, deleted, or renamed.</para>
  5062. <para>As these notifications are received by the client, the apropriate will be emitted:
  5063. <see cref="E:MailKit.MailStore.FolderCreated"/>, <see cref="E:MailKit.IMailFolder.Deleted"/>, or
  5064. <see cref="E:MailKit.IMailFolder.Renamed"/>, respectively.</para>
  5065. <note type="info">If the server supports <see cref="F:MailKit.Net.Imap.ImapCapabilities.Acl"/>, granting or revocation of the
  5066. <see cref="F:MailKit.AccessRight.LookupFolder"/> right to the current user on the affected folder will also be
  5067. considered folder creation or deletion, respectively. If a folder is created or deleted, the folder itself
  5068. and its direct parent (whether it is an existing folder or not) are considered to be affected.</note>
  5069. </remarks>
  5070. </member>
  5071. <member name="F:MailKit.Net.Imap.ImapEvent.SubscriptionChange">
  5072. <summary>
  5073. An IMAP event notification for folders who have had their subscription status changed.
  5074. </summary>
  5075. <remarks>
  5076. <para>This event requests that the server notifies the client of any subscription changes,
  5077. causing the <see cref="E:MailKit.IMailFolder.Subscribed"/> or <see cref="E:MailKit.IMailFolder.Unsubscribed"/>
  5078. events to be emitted accordingly on the affected <see cref="T:MailKit.IMailFolder"/>.</para>
  5079. </remarks>
  5080. </member>
  5081. <member name="F:MailKit.Net.Imap.ImapEvent.MailboxMetadataChange">
  5082. <summary>
  5083. An IMAP event notification for changes to folder metadata.
  5084. </summary>
  5085. <remarks>
  5086. <para>Support for this event type is OPTIONAL unless <see cref="F:MailKit.Net.Imap.ImapCapabilities.Metadata"/> is supported
  5087. by the server, in which case support for this event type is REQUIRED.</para>
  5088. <para>If the server does support this event, then the <see cref="E:MailKit.IMailFolder.MetadataChanged"/> event
  5089. will be emitted whenever metadata changes for any folder included in the <see cref="T:MailKit.Net.Imap.ImapMailboxFilter"/>.</para>
  5090. </remarks>
  5091. </member>
  5092. <member name="F:MailKit.Net.Imap.ImapEvent.ServerMetadataChange">
  5093. <summary>
  5094. An IMAP event notification for changes to server metadata.
  5095. </summary>
  5096. <remarks>
  5097. <para>Support for this event type is OPTIONAL unless <see cref="F:MailKit.Net.Imap.ImapCapabilities.Metadata"/> is supported
  5098. by the server, in which case support for this event type is REQUIRED.</para>
  5099. <para>If the server does support this event, then the <see cref="E:MailKit.IMailStore.MetadataChanged"/> event
  5100. will be emitted whenever metadata changes.</para>
  5101. </remarks>
  5102. </member>
  5103. <member name="M:MailKit.Net.Imap.ImapEvent.#ctor(System.String,System.Boolean)">
  5104. <summary>
  5105. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapEvent"/> class.
  5106. </summary>
  5107. <remarks>
  5108. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapEvent"/> class.
  5109. </remarks>
  5110. <param name="name">The name of the IMAP event.</param>
  5111. <param name="isMessageEvent"><c>true</c> if the event is a message event; otherwise, <c>false</c>.</param>
  5112. </member>
  5113. <member name="P:MailKit.Net.Imap.ImapEvent.IsMessageEvent">
  5114. <summary>
  5115. Get whether or not this <see cref="T:MailKit.Net.Imap.ImapEvent"/> is a message event.
  5116. </summary>
  5117. <remarks>
  5118. Gets whether or not this <see cref="T:MailKit.Net.Imap.ImapEvent"/> is a message event.
  5119. </remarks>
  5120. <value><c>true</c> if is message event; otherwise, <c>false</c>.</value>
  5121. </member>
  5122. <member name="P:MailKit.Net.Imap.ImapEvent.Name">
  5123. <summary>
  5124. Get the name of the IMAP event.
  5125. </summary>
  5126. <remarks>
  5127. Gets the name of the IMAP event.
  5128. </remarks>
  5129. <value>The name of the IMAP event.</value>
  5130. </member>
  5131. <member name="M:MailKit.Net.Imap.ImapEvent.Format(MailKit.Net.Imap.ImapEngine,System.Text.StringBuilder,System.Collections.Generic.IList{System.Object},System.Boolean)">
  5132. <summary>
  5133. Format the IMAP NOTIFY command for this particular IMAP mailbox filter.
  5134. </summary>
  5135. <remarks>
  5136. Formats the IMAP NOTIFY command for this particular IMAP mailbox filter.
  5137. </remarks>
  5138. <param name="engine">The IMAP engine.</param>
  5139. <param name="command">The IMAP command builder.</param>
  5140. <param name="args">The IMAP command argument builder.</param>
  5141. <param name="isSelectedFilter"><c>true</c> if the event is being registered for a
  5142. <see cref="F:MailKit.Net.Imap.ImapMailboxFilter.Selected"/> or <see cref="F:MailKit.Net.Imap.ImapMailboxFilter.SelectedDelayed"/>
  5143. mailbox filter.</param>
  5144. </member>
  5145. <member name="T:MailKit.Net.Imap.ImapEvent.MessageNew">
  5146. <summary>
  5147. An IMAP event notification for new or appended messages.
  5148. </summary>
  5149. <remarks>
  5150. <para>An IMAP event notification for new or appended messages.</para>
  5151. <para>If the new or appended message is in the selected folder, the folder will emit the
  5152. <see cref="E:MailKit.IMailFolder.CountChanged"/> event, followed by a
  5153. <see cref="E:MailKit.IMailFolder.MessageSummaryFetched"/> event containing the information requested by the client.</para>
  5154. <note type="note">These events will not be emitted for any message created by the client on this particular folder
  5155. as a result of, for example, a call to
  5156. <see cref="M:MailKit.IMailFolder.Append(MimeKit.MimeMessage,MailKit.MessageFlags,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>
  5157. or <see cref="M:MailKit.IMailFolder.CopyTo(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.IMailFolder,System.Threading.CancellationToken)"/>.</note>
  5158. </remarks>
  5159. </member>
  5160. <member name="M:MailKit.Net.Imap.ImapEvent.MessageNew.#ctor(MailKit.MessageSummaryItems)">
  5161. <summary>
  5162. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapEvent.MessageNew"/> class.
  5163. </summary>
  5164. <remarks>
  5165. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapEvent.MessageNew"/> class.
  5166. </remarks>
  5167. <param name="items">The message summary items to automatically retrieve for new messages.</param>
  5168. </member>
  5169. <member name="M:MailKit.Net.Imap.ImapEvent.MessageNew.#ctor(MailKit.MessageSummaryItems,System.Collections.Generic.HashSet{MimeKit.HeaderId})">
  5170. <summary>
  5171. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapEvent.MessageNew"/> class.
  5172. </summary>
  5173. <remarks>
  5174. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapEvent.MessageNew"/> class.
  5175. </remarks>
  5176. <param name="items">The message summary items to automatically retrieve for new messages.</param>
  5177. <param name="headers">Additional message headers to retrieve for new messages.</param>
  5178. </member>
  5179. <member name="M:MailKit.Net.Imap.ImapEvent.MessageNew.#ctor(MailKit.MessageSummaryItems,System.Collections.Generic.HashSet{System.String})">
  5180. <summary>
  5181. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapEvent.MessageNew"/> class.
  5182. </summary>
  5183. <remarks>
  5184. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapEvent.MessageNew"/> class.
  5185. </remarks>
  5186. <param name="items">The message summary items to automatically retrieve for new messages.</param>
  5187. <param name="headers">Additional message headers to retrieve for new messages.</param>
  5188. </member>
  5189. <member name="M:MailKit.Net.Imap.ImapEvent.MessageNew.Format(MailKit.Net.Imap.ImapEngine,System.Text.StringBuilder,System.Collections.Generic.IList{System.Object},System.Boolean)">
  5190. <summary>
  5191. Format the IMAP NOTIFY command for this particular IMAP mailbox filter.
  5192. </summary>
  5193. <remarks>
  5194. Formats the IMAP NOTIFY command for this particular IMAP mailbox filter.
  5195. </remarks>
  5196. <param name="engine">The IMAP engine.</param>
  5197. <param name="command">The IMAP command builder.</param>
  5198. <param name="args">The IMAP command argument builder.</param>
  5199. <param name="isSelectedFilter"><c>true</c> if the event is being registered for a
  5200. <see cref="F:MailKit.Net.Imap.ImapMailboxFilter.Selected"/> or <see cref="F:MailKit.Net.Imap.ImapMailboxFilter.SelectedDelayed"/>
  5201. mailbox filter.</param>
  5202. </member>
  5203. <member name="T:MailKit.Net.Imap.ImapFolder">
  5204. <summary>
  5205. An IMAP folder.
  5206. </summary>
  5207. <remarks>
  5208. An IMAP folder.
  5209. </remarks>
  5210. <example>
  5211. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadMessages"/>
  5212. </example>
  5213. <example>
  5214. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  5215. </example>
  5216. </member>
  5217. <member name="M:MailKit.Net.Imap.ImapFolder.#ctor(MailKit.Net.Imap.ImapFolderConstructorArgs)">
  5218. <summary>
  5219. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapFolder"/> class.
  5220. </summary>
  5221. <remarks>
  5222. <para>Creates a new <see cref="T:MailKit.Net.Imap.ImapFolder"/>.</para>
  5223. <para>If you subclass <see cref="T:MailKit.Net.Imap.ImapFolder"/>, you will also need to subclass
  5224. <see cref="T:MailKit.Net.Imap.ImapClient"/> and override the
  5225. <see cref="M:MailKit.Net.Imap.ImapClient.CreateImapFolder(MailKit.Net.Imap.ImapFolderConstructorArgs)"/>
  5226. method in order to return a new instance of your ImapFolder subclass.</para>
  5227. </remarks>
  5228. <param name="args">The constructor arguments.</param>
  5229. <exception cref="T:System.ArgumentNullException">
  5230. <paramref name="args"/> is <c>null</c>.
  5231. </exception>
  5232. </member>
  5233. <member name="P:MailKit.Net.Imap.ImapFolder.Engine">
  5234. <summary>
  5235. Get the IMAP command engine.
  5236. </summary>
  5237. <remarks>
  5238. Gets the IMAP command engine.
  5239. </remarks>
  5240. <value>The engine.</value>
  5241. </member>
  5242. <member name="P:MailKit.Net.Imap.ImapFolder.EncodedName">
  5243. <summary>
  5244. Get the encoded name of the folder.
  5245. </summary>
  5246. <remarks>
  5247. Gets the encoded name of the folder.
  5248. </remarks>
  5249. <value>The encoded name.</value>
  5250. </member>
  5251. <member name="P:MailKit.Net.Imap.ImapFolder.SyncRoot">
  5252. <summary>
  5253. Gets an object that can be used to synchronize access to the IMAP server.
  5254. </summary>
  5255. <remarks>
  5256. <para>Gets an object that can be used to synchronize access to the IMAP server.</para>
  5257. <para>When using the non-Async methods from multiple threads, it is important to lock the
  5258. <see cref="P:MailKit.Net.Imap.ImapFolder.SyncRoot"/> object for thread safety when using the synchronous methods.</para>
  5259. </remarks>
  5260. <value>The lock object.</value>
  5261. </member>
  5262. <member name="M:MailKit.Net.Imap.ImapFolder.OnParentFolderRenamed">
  5263. <summary>
  5264. Notifies the folder that a parent folder has been renamed.
  5265. </summary>
  5266. <remarks>
  5267. Updates the <see cref="P:MailKit.MailFolder.FullName"/> property.
  5268. </remarks>
  5269. </member>
  5270. <member name="P:MailKit.Net.Imap.ImapFolder.IsOpen">
  5271. <summary>
  5272. Gets a value indicating whether the folder is currently open.
  5273. </summary>
  5274. <remarks>
  5275. Gets a value indicating whether the folder is currently open.
  5276. </remarks>
  5277. <value><c>true</c> if the folder is currently open; otherwise, <c>false</c>.</value>
  5278. </member>
  5279. <member name="M:MailKit.Net.Imap.ImapFolder.Open(MailKit.FolderAccess,System.UInt32,System.UInt64,System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)">
  5280. <summary>
  5281. Open the folder using the requested folder access.
  5282. </summary>
  5283. <remarks>
  5284. <para>This variant of the <see cref="M:MailKit.Net.Imap.ImapFolder.Open(MailKit.FolderAccess,System.Threading.CancellationToken)"/>
  5285. method is meant for quick resynchronization of the folder. Before calling this method,
  5286. the <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/> method MUST be called.</para>
  5287. <para>You should also make sure to add listeners to the <see cref="E:MailKit.MailFolder.MessagesVanished"/> and
  5288. <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events to get notifications of changes since
  5289. the last time the folder was opened.</para>
  5290. </remarks>
  5291. <returns>The <see cref="T:MailKit.FolderAccess"/> state of the folder.</returns>
  5292. <param name="access">The requested folder access.</param>
  5293. <param name="uidValidity">The last known <see cref="P:MailKit.MailFolder.UidValidity"/> value.</param>
  5294. <param name="highestModSeq">The last known <see cref="P:MailKit.MailFolder.HighestModSeq"/> value.</param>
  5295. <param name="uids">The last known list of unique message identifiers.</param>
  5296. <param name="cancellationToken">The cancellation token.</param>
  5297. <exception cref="T:System.ArgumentOutOfRangeException">
  5298. <paramref name="access"/> is not a valid value.
  5299. </exception>
  5300. <exception cref="T:System.ObjectDisposedException">
  5301. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5302. </exception>
  5303. <exception cref="T:MailKit.ServiceNotConnectedException">
  5304. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5305. </exception>
  5306. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5307. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5308. </exception>
  5309. <exception cref="T:MailKit.FolderNotFoundException">
  5310. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  5311. </exception>
  5312. <exception cref="T:System.InvalidOperationException">
  5313. The QRESYNC feature has not been enabled.
  5314. </exception>
  5315. <exception cref="T:System.NotSupportedException">
  5316. The IMAP server does not support the QRESYNC extension.
  5317. </exception>
  5318. <exception cref="T:System.OperationCanceledException">
  5319. The operation was canceled via the cancellation token.
  5320. </exception>
  5321. <exception cref="T:System.IO.IOException">
  5322. An I/O error occurred.
  5323. </exception>
  5324. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5325. The server's response contained unexpected tokens.
  5326. </exception>
  5327. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5328. The server replied with a NO or BAD response.
  5329. </exception>
  5330. </member>
  5331. <member name="M:MailKit.Net.Imap.ImapFolder.OpenAsync(MailKit.FolderAccess,System.UInt32,System.UInt64,System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)">
  5332. <summary>
  5333. Asynchronously open the folder using the requested folder access.
  5334. </summary>
  5335. <remarks>
  5336. <para>This variant of the <see cref="M:MailKit.Net.Imap.ImapFolder.Open(MailKit.FolderAccess,System.Threading.CancellationToken)"/>
  5337. method is meant for quick resynchronization of the folder. Before calling this method,
  5338. the <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/> method MUST be called.</para>
  5339. <para>You should also make sure to add listeners to the <see cref="E:MailKit.MailFolder.MessagesVanished"/> and
  5340. <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events to get notifications of changes since
  5341. the last time the folder was opened.</para>
  5342. </remarks>
  5343. <returns>The <see cref="T:MailKit.FolderAccess"/> state of the folder.</returns>
  5344. <param name="access">The requested folder access.</param>
  5345. <param name="uidValidity">The last known <see cref="P:MailKit.MailFolder.UidValidity"/> value.</param>
  5346. <param name="highestModSeq">The last known <see cref="P:MailKit.MailFolder.HighestModSeq"/> value.</param>
  5347. <param name="uids">The last known list of unique message identifiers.</param>
  5348. <param name="cancellationToken">The cancellation token.</param>
  5349. <exception cref="T:System.ArgumentOutOfRangeException">
  5350. <paramref name="access"/> is not a valid value.
  5351. </exception>
  5352. <exception cref="T:System.ObjectDisposedException">
  5353. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5354. </exception>
  5355. <exception cref="T:MailKit.ServiceNotConnectedException">
  5356. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5357. </exception>
  5358. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5359. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5360. </exception>
  5361. <exception cref="T:MailKit.FolderNotFoundException">
  5362. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  5363. </exception>
  5364. <exception cref="T:System.InvalidOperationException">
  5365. The QRESYNC feature has not been enabled.
  5366. </exception>
  5367. <exception cref="T:System.NotSupportedException">
  5368. The IMAP server does not support the QRESYNC extension.
  5369. </exception>
  5370. <exception cref="T:System.OperationCanceledException">
  5371. The operation was canceled via the cancellation token.
  5372. </exception>
  5373. <exception cref="T:System.IO.IOException">
  5374. An I/O error occurred.
  5375. </exception>
  5376. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5377. The server's response contained unexpected tokens.
  5378. </exception>
  5379. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5380. The server replied with a NO or BAD response.
  5381. </exception>
  5382. </member>
  5383. <member name="M:MailKit.Net.Imap.ImapFolder.Open(MailKit.FolderAccess,System.Threading.CancellationToken)">
  5384. <summary>
  5385. Open the folder using the requested folder access.
  5386. </summary>
  5387. <remarks>
  5388. Opens the folder using the requested folder access.
  5389. </remarks>
  5390. <returns>The <see cref="T:MailKit.FolderAccess"/> state of the folder.</returns>
  5391. <param name="access">The requested folder access.</param>
  5392. <param name="cancellationToken">The cancellation token.</param>
  5393. <exception cref="T:System.ArgumentOutOfRangeException">
  5394. <paramref name="access"/> is not a valid value.
  5395. </exception>
  5396. <exception cref="T:System.ObjectDisposedException">
  5397. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5398. </exception>
  5399. <exception cref="T:MailKit.ServiceNotConnectedException">
  5400. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5401. </exception>
  5402. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5403. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5404. </exception>
  5405. <exception cref="T:MailKit.FolderNotFoundException">
  5406. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  5407. </exception>
  5408. <exception cref="T:System.OperationCanceledException">
  5409. The operation was canceled via the cancellation token.
  5410. </exception>
  5411. <exception cref="T:System.IO.IOException">
  5412. An I/O error occurred.
  5413. </exception>
  5414. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5415. The server's response contained unexpected tokens.
  5416. </exception>
  5417. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5418. The server replied with a NO or BAD response.
  5419. </exception>
  5420. </member>
  5421. <member name="M:MailKit.Net.Imap.ImapFolder.OpenAsync(MailKit.FolderAccess,System.Threading.CancellationToken)">
  5422. <summary>
  5423. Asynchronously open the folder using the requested folder access.
  5424. </summary>
  5425. <remarks>
  5426. Opens the folder using the requested folder access.
  5427. </remarks>
  5428. <returns>The <see cref="T:MailKit.FolderAccess"/> state of the folder.</returns>
  5429. <param name="access">The requested folder access.</param>
  5430. <param name="cancellationToken">The cancellation token.</param>
  5431. <exception cref="T:System.ArgumentOutOfRangeException">
  5432. <paramref name="access"/> is not a valid value.
  5433. </exception>
  5434. <exception cref="T:System.ObjectDisposedException">
  5435. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5436. </exception>
  5437. <exception cref="T:MailKit.ServiceNotConnectedException">
  5438. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5439. </exception>
  5440. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5441. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5442. </exception>
  5443. <exception cref="T:MailKit.FolderNotFoundException">
  5444. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  5445. </exception>
  5446. <exception cref="T:System.OperationCanceledException">
  5447. The operation was canceled via the cancellation token.
  5448. </exception>
  5449. <exception cref="T:System.IO.IOException">
  5450. An I/O error occurred.
  5451. </exception>
  5452. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5453. The server's response contained unexpected tokens.
  5454. </exception>
  5455. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5456. The server replied with a NO or BAD response.
  5457. </exception>
  5458. </member>
  5459. <member name="M:MailKit.Net.Imap.ImapFolder.Close(System.Boolean,System.Threading.CancellationToken)">
  5460. <summary>
  5461. Close the folder, optionally expunging the messages marked for deletion.
  5462. </summary>
  5463. <remarks>
  5464. Closes the folder, optionally expunging the messages marked for deletion.
  5465. </remarks>
  5466. <param name="expunge">If set to <c>true</c>, expunge.</param>
  5467. <param name="cancellationToken">The cancellation token.</param>
  5468. <exception cref="T:System.ObjectDisposedException">
  5469. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5470. </exception>
  5471. <exception cref="T:MailKit.ServiceNotConnectedException">
  5472. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5473. </exception>
  5474. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5475. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5476. </exception>
  5477. <exception cref="T:MailKit.FolderNotOpenException">
  5478. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  5479. </exception>
  5480. <exception cref="T:System.OperationCanceledException">
  5481. The operation was canceled via the cancellation token.
  5482. </exception>
  5483. <exception cref="T:System.IO.IOException">
  5484. An I/O error occurred.
  5485. </exception>
  5486. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5487. The server's response contained unexpected tokens.
  5488. </exception>
  5489. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5490. The server replied with a NO or BAD response.
  5491. </exception>
  5492. </member>
  5493. <member name="M:MailKit.Net.Imap.ImapFolder.CloseAsync(System.Boolean,System.Threading.CancellationToken)">
  5494. <summary>
  5495. Asynchronously close the folder, optionally expunging the messages marked for deletion.
  5496. </summary>
  5497. <remarks>
  5498. Closes the folder, optionally expunging the messages marked for deletion.
  5499. </remarks>
  5500. <returns>An asynchronous task context.</returns>
  5501. <param name="expunge">If set to <c>true</c>, expunge.</param>
  5502. <param name="cancellationToken">The cancellation token.</param>
  5503. <exception cref="T:System.ObjectDisposedException">
  5504. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5505. </exception>
  5506. <exception cref="T:MailKit.ServiceNotConnectedException">
  5507. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5508. </exception>
  5509. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5510. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5511. </exception>
  5512. <exception cref="T:MailKit.FolderNotOpenException">
  5513. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  5514. </exception>
  5515. <exception cref="T:System.OperationCanceledException">
  5516. The operation was canceled via the cancellation token.
  5517. </exception>
  5518. <exception cref="T:System.IO.IOException">
  5519. An I/O error occurred.
  5520. </exception>
  5521. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5522. The server's response contained unexpected tokens.
  5523. </exception>
  5524. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5525. The server replied with a NO or BAD response.
  5526. </exception>
  5527. </member>
  5528. <member name="M:MailKit.Net.Imap.ImapFolder.Create(System.String,System.Boolean,System.Threading.CancellationToken)">
  5529. <summary>
  5530. Create a new subfolder with the given name.
  5531. </summary>
  5532. <remarks>
  5533. Creates a new subfolder with the given name.
  5534. </remarks>
  5535. <returns>The created folder.</returns>
  5536. <param name="name">The name of the folder to create.</param>
  5537. <param name="isMessageFolder"><c>true</c> if the folder will be used to contain messages; otherwise <c>false</c>.</param>
  5538. <param name="cancellationToken">The cancellation token.</param>
  5539. <exception cref="T:System.ArgumentNullException">
  5540. <paramref name="name"/> is <c>null</c>.
  5541. </exception>
  5542. <exception cref="T:System.ArgumentException">
  5543. <paramref name="name"/> is empty.
  5544. </exception>
  5545. <exception cref="T:System.ObjectDisposedException">
  5546. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5547. </exception>
  5548. <exception cref="T:MailKit.ServiceNotConnectedException">
  5549. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5550. </exception>
  5551. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5552. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5553. </exception>
  5554. <exception cref="T:System.InvalidOperationException">
  5555. The <see cref="P:MailKit.MailFolder.DirectorySeparator"/> is nil, and thus child folders cannot be created.
  5556. </exception>
  5557. <exception cref="T:System.OperationCanceledException">
  5558. The operation was canceled via the cancellation token.
  5559. </exception>
  5560. <exception cref="T:System.IO.IOException">
  5561. An I/O error occurred.
  5562. </exception>
  5563. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5564. The server's response contained unexpected tokens.
  5565. </exception>
  5566. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5567. The server replied with a NO or BAD response.
  5568. </exception>
  5569. </member>
  5570. <member name="M:MailKit.Net.Imap.ImapFolder.CreateAsync(System.String,System.Boolean,System.Threading.CancellationToken)">
  5571. <summary>
  5572. Asynchronously create a new subfolder with the given name.
  5573. </summary>
  5574. <remarks>
  5575. Creates a new subfolder with the given name.
  5576. </remarks>
  5577. <returns>The created folder.</returns>
  5578. <param name="name">The name of the folder to create.</param>
  5579. <param name="isMessageFolder"><c>true</c> if the folder will be used to contain messages; otherwise <c>false</c>.</param>
  5580. <param name="cancellationToken">The cancellation token.</param>
  5581. <exception cref="T:System.ArgumentNullException">
  5582. <paramref name="name"/> is <c>null</c>.
  5583. </exception>
  5584. <exception cref="T:System.ArgumentException">
  5585. <paramref name="name"/> is empty.
  5586. </exception>
  5587. <exception cref="T:System.ObjectDisposedException">
  5588. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5589. </exception>
  5590. <exception cref="T:MailKit.ServiceNotConnectedException">
  5591. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5592. </exception>
  5593. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5594. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5595. </exception>
  5596. <exception cref="T:System.InvalidOperationException">
  5597. The <see cref="P:MailKit.MailFolder.DirectorySeparator"/> is nil, and thus child folders cannot be created.
  5598. </exception>
  5599. <exception cref="T:System.OperationCanceledException">
  5600. The operation was canceled via the cancellation token.
  5601. </exception>
  5602. <exception cref="T:System.IO.IOException">
  5603. An I/O error occurred.
  5604. </exception>
  5605. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5606. The server's response contained unexpected tokens.
  5607. </exception>
  5608. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5609. The server replied with a NO or BAD response.
  5610. </exception>
  5611. </member>
  5612. <member name="M:MailKit.Net.Imap.ImapFolder.Create(System.String,System.Collections.Generic.IEnumerable{MailKit.SpecialFolder},System.Threading.CancellationToken)">
  5613. <summary>
  5614. Create a new subfolder with the given name.
  5615. </summary>
  5616. <remarks>
  5617. Creates a new subfolder with the given name.
  5618. </remarks>
  5619. <returns>The created folder.</returns>
  5620. <param name="name">The name of the folder to create.</param>
  5621. <param name="specialUses">A list of special uses for the folder being created.</param>
  5622. <param name="cancellationToken">The cancellation token.</param>
  5623. <exception cref="T:System.ArgumentNullException">
  5624. <para><paramref name="name"/> is <c>null</c>.</para>
  5625. <para>-or-</para>
  5626. <para><paramref name="specialUses"/> is <c>null</c>.</para>
  5627. </exception>
  5628. <exception cref="T:System.ArgumentException">
  5629. <paramref name="name"/> is empty.
  5630. </exception>
  5631. <exception cref="T:System.ObjectDisposedException">
  5632. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5633. </exception>
  5634. <exception cref="T:MailKit.ServiceNotConnectedException">
  5635. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5636. </exception>
  5637. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5638. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5639. </exception>
  5640. <exception cref="T:System.InvalidOperationException">
  5641. The <see cref="P:MailKit.MailFolder.DirectorySeparator"/> is nil, and thus child folders cannot be created.
  5642. </exception>
  5643. <exception cref="T:System.NotSupportedException">
  5644. The IMAP server does not support the CREATE-SPECIAL-USE extension.
  5645. </exception>
  5646. <exception cref="T:System.OperationCanceledException">
  5647. The operation was canceled via the cancellation token.
  5648. </exception>
  5649. <exception cref="T:System.IO.IOException">
  5650. An I/O error occurred.
  5651. </exception>
  5652. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5653. The server's response contained unexpected tokens.
  5654. </exception>
  5655. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5656. The server replied with a NO or BAD response.
  5657. </exception>
  5658. </member>
  5659. <member name="M:MailKit.Net.Imap.ImapFolder.CreateAsync(System.String,System.Collections.Generic.IEnumerable{MailKit.SpecialFolder},System.Threading.CancellationToken)">
  5660. <summary>
  5661. Asynchronously create a new subfolder with the given name.
  5662. </summary>
  5663. <remarks>
  5664. Creates a new subfolder with the given name.
  5665. </remarks>
  5666. <returns>The created folder.</returns>
  5667. <param name="name">The name of the folder to create.</param>
  5668. <param name="specialUses">A list of special uses for the folder being created.</param>
  5669. <param name="cancellationToken">The cancellation token.</param>
  5670. <exception cref="T:System.ArgumentNullException">
  5671. <para><paramref name="name"/> is <c>null</c>.</para>
  5672. <para>-or-</para>
  5673. <para><paramref name="specialUses"/> is <c>null</c>.</para>
  5674. </exception>
  5675. <exception cref="T:System.ArgumentException">
  5676. <paramref name="name"/> is empty.
  5677. </exception>
  5678. <exception cref="T:System.ObjectDisposedException">
  5679. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5680. </exception>
  5681. <exception cref="T:MailKit.ServiceNotConnectedException">
  5682. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5683. </exception>
  5684. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5685. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5686. </exception>
  5687. <exception cref="T:System.InvalidOperationException">
  5688. The <see cref="P:MailKit.MailFolder.DirectorySeparator"/> is nil, and thus child folders cannot be created.
  5689. </exception>
  5690. <exception cref="T:System.NotSupportedException">
  5691. The IMAP server does not support the CREATE-SPECIAL-USE extension.
  5692. </exception>
  5693. <exception cref="T:System.OperationCanceledException">
  5694. The operation was canceled via the cancellation token.
  5695. </exception>
  5696. <exception cref="T:System.IO.IOException">
  5697. An I/O error occurred.
  5698. </exception>
  5699. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5700. The server's response contained unexpected tokens.
  5701. </exception>
  5702. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5703. The server replied with a NO or BAD response.
  5704. </exception>
  5705. </member>
  5706. <member name="M:MailKit.Net.Imap.ImapFolder.Rename(MailKit.IMailFolder,System.String,System.Threading.CancellationToken)">
  5707. <summary>
  5708. Rename the folder to exist with a new name under a new parent folder.
  5709. </summary>
  5710. <remarks>
  5711. Renames the folder to exist with a new name under a new parent folder.
  5712. </remarks>
  5713. <param name="parent">The new parent folder.</param>
  5714. <param name="name">The new name of the folder.</param>
  5715. <param name="cancellationToken">The cancellation token.</param>
  5716. <exception cref="T:System.ArgumentNullException">
  5717. <para><paramref name="parent"/> is <c>null</c>.</para>
  5718. <para>-or-</para>
  5719. <para><paramref name="name"/> is <c>null</c>.</para>
  5720. </exception>
  5721. <exception cref="T:System.ArgumentException">
  5722. <para><paramref name="parent"/> does not belong to the <see cref="T:MailKit.Net.Imap.ImapClient"/>.</para>
  5723. <para>-or-</para>
  5724. <para><paramref name="name"/> is not a legal folder name.</para>
  5725. </exception>
  5726. <exception cref="T:System.ObjectDisposedException">
  5727. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5728. </exception>
  5729. <exception cref="T:MailKit.ServiceNotConnectedException">
  5730. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5731. </exception>
  5732. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5733. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5734. </exception>
  5735. <exception cref="T:MailKit.FolderNotFoundException">
  5736. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  5737. </exception>
  5738. <exception cref="T:System.InvalidOperationException">
  5739. The folder cannot be renamed (it is either a namespace or the Inbox).
  5740. </exception>
  5741. <exception cref="T:System.OperationCanceledException">
  5742. The operation was canceled via the cancellation token.
  5743. </exception>
  5744. <exception cref="T:System.IO.IOException">
  5745. An I/O error occurred.
  5746. </exception>
  5747. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5748. The server's response contained unexpected tokens.
  5749. </exception>
  5750. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5751. The server replied with a NO or BAD response.
  5752. </exception>
  5753. </member>
  5754. <member name="M:MailKit.Net.Imap.ImapFolder.RenameAsync(MailKit.IMailFolder,System.String,System.Threading.CancellationToken)">
  5755. <summary>
  5756. Asynchronously rename the folder to exist with a new name under a new parent folder.
  5757. </summary>
  5758. <remarks>
  5759. Renames the folder to exist with a new name under a new parent folder.
  5760. </remarks>
  5761. <returns>An awaitable task.</returns>
  5762. <param name="parent">The new parent folder.</param>
  5763. <param name="name">The new name of the folder.</param>
  5764. <param name="cancellationToken">The cancellation token.</param>
  5765. <exception cref="T:System.ArgumentNullException">
  5766. <para><paramref name="parent"/> is <c>null</c>.</para>
  5767. <para>-or-</para>
  5768. <para><paramref name="name"/> is <c>null</c>.</para>
  5769. </exception>
  5770. <exception cref="T:System.ArgumentException">
  5771. <para><paramref name="parent"/> does not belong to the <see cref="T:MailKit.Net.Imap.ImapClient"/>.</para>
  5772. <para>-or-</para>
  5773. <para><paramref name="name"/> is not a legal folder name.</para>
  5774. </exception>
  5775. <exception cref="T:System.ObjectDisposedException">
  5776. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5777. </exception>
  5778. <exception cref="T:MailKit.ServiceNotConnectedException">
  5779. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5780. </exception>
  5781. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5782. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5783. </exception>
  5784. <exception cref="T:MailKit.FolderNotFoundException">
  5785. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  5786. </exception>
  5787. <exception cref="T:System.InvalidOperationException">
  5788. The folder cannot be renamed (it is either a namespace or the Inbox).
  5789. </exception>
  5790. <exception cref="T:System.OperationCanceledException">
  5791. The operation was canceled via the cancellation token.
  5792. </exception>
  5793. <exception cref="T:System.IO.IOException">
  5794. An I/O error occurred.
  5795. </exception>
  5796. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5797. The server's response contained unexpected tokens.
  5798. </exception>
  5799. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5800. The server replied with a NO or BAD response.
  5801. </exception>
  5802. </member>
  5803. <member name="M:MailKit.Net.Imap.ImapFolder.Delete(System.Threading.CancellationToken)">
  5804. <summary>
  5805. Delete the folder on the IMAP server.
  5806. </summary>
  5807. <remarks>
  5808. <para>Deletes the folder on the IMAP server.</para>
  5809. <note type="note">This method will not delete any child folders.</note>
  5810. </remarks>
  5811. <param name="cancellationToken">The cancellation token.</param>
  5812. <exception cref="T:System.ObjectDisposedException">
  5813. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5814. </exception>
  5815. <exception cref="T:MailKit.ServiceNotConnectedException">
  5816. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5817. </exception>
  5818. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5819. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5820. </exception>
  5821. <exception cref="T:System.InvalidOperationException">
  5822. The folder cannot be deleted (it is either a namespace or the Inbox).
  5823. </exception>
  5824. <exception cref="T:System.OperationCanceledException">
  5825. The operation was canceled via the cancellation token.
  5826. </exception>
  5827. <exception cref="T:System.IO.IOException">
  5828. An I/O error occurred.
  5829. </exception>
  5830. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5831. The server's response contained unexpected tokens.
  5832. </exception>
  5833. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5834. The server replied with a NO or BAD response.
  5835. </exception>
  5836. </member>
  5837. <member name="M:MailKit.Net.Imap.ImapFolder.DeleteAsync(System.Threading.CancellationToken)">
  5838. <summary>
  5839. Asynchronously delete the folder on the IMAP server.
  5840. </summary>
  5841. <remarks>
  5842. <para>Deletes the folder on the IMAP server.</para>
  5843. <note type="note">This method will not delete any child folders.</note>
  5844. </remarks>
  5845. <returns>An awaitable task.</returns>
  5846. <param name="cancellationToken">The cancellation token.</param>
  5847. <exception cref="T:System.ObjectDisposedException">
  5848. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5849. </exception>
  5850. <exception cref="T:MailKit.ServiceNotConnectedException">
  5851. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5852. </exception>
  5853. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5854. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5855. </exception>
  5856. <exception cref="T:System.InvalidOperationException">
  5857. The folder cannot be deleted (it is either a namespace or the Inbox).
  5858. </exception>
  5859. <exception cref="T:System.OperationCanceledException">
  5860. The operation was canceled via the cancellation token.
  5861. </exception>
  5862. <exception cref="T:System.IO.IOException">
  5863. An I/O error occurred.
  5864. </exception>
  5865. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5866. The server's response contained unexpected tokens.
  5867. </exception>
  5868. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5869. The server replied with a NO or BAD response.
  5870. </exception>
  5871. </member>
  5872. <member name="M:MailKit.Net.Imap.ImapFolder.Subscribe(System.Threading.CancellationToken)">
  5873. <summary>
  5874. Subscribe the folder.
  5875. </summary>
  5876. <remarks>
  5877. Subscribes the folder.
  5878. </remarks>
  5879. <param name="cancellationToken">The cancellation token.</param>
  5880. <exception cref="T:System.ObjectDisposedException">
  5881. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5882. </exception>
  5883. <exception cref="T:MailKit.ServiceNotConnectedException">
  5884. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5885. </exception>
  5886. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5887. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5888. </exception>
  5889. <exception cref="T:System.OperationCanceledException">
  5890. The operation was canceled via the cancellation token.
  5891. </exception>
  5892. <exception cref="T:System.IO.IOException">
  5893. An I/O error occurred.
  5894. </exception>
  5895. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5896. The server's response contained unexpected tokens.
  5897. </exception>
  5898. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5899. The server replied with a NO or BAD response.
  5900. </exception>
  5901. </member>
  5902. <member name="M:MailKit.Net.Imap.ImapFolder.SubscribeAsync(System.Threading.CancellationToken)">
  5903. <summary>
  5904. Asynchronously subscribe the folder.
  5905. </summary>
  5906. <remarks>
  5907. Subscribes the folder.
  5908. </remarks>
  5909. <returns>An awaitable task.</returns>
  5910. <param name="cancellationToken">The cancellation token.</param>
  5911. <exception cref="T:System.ObjectDisposedException">
  5912. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5913. </exception>
  5914. <exception cref="T:MailKit.ServiceNotConnectedException">
  5915. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5916. </exception>
  5917. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5918. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5919. </exception>
  5920. <exception cref="T:System.OperationCanceledException">
  5921. The operation was canceled via the cancellation token.
  5922. </exception>
  5923. <exception cref="T:System.IO.IOException">
  5924. An I/O error occurred.
  5925. </exception>
  5926. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5927. The server's response contained unexpected tokens.
  5928. </exception>
  5929. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5930. The server replied with a NO or BAD response.
  5931. </exception>
  5932. </member>
  5933. <member name="M:MailKit.Net.Imap.ImapFolder.Unsubscribe(System.Threading.CancellationToken)">
  5934. <summary>
  5935. Unsubscribe the folder.
  5936. </summary>
  5937. <remarks>
  5938. Unsubscribes the folder.
  5939. </remarks>
  5940. <param name="cancellationToken">The cancellation token.</param>
  5941. <exception cref="T:System.ObjectDisposedException">
  5942. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5943. </exception>
  5944. <exception cref="T:MailKit.ServiceNotConnectedException">
  5945. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5946. </exception>
  5947. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5948. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5949. </exception>
  5950. <exception cref="T:System.OperationCanceledException">
  5951. The operation was canceled via the cancellation token.
  5952. </exception>
  5953. <exception cref="T:System.IO.IOException">
  5954. An I/O error occurred.
  5955. </exception>
  5956. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5957. The server's response contained unexpected tokens.
  5958. </exception>
  5959. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5960. The server replied with a NO or BAD response.
  5961. </exception>
  5962. </member>
  5963. <member name="M:MailKit.Net.Imap.ImapFolder.UnsubscribeAsync(System.Threading.CancellationToken)">
  5964. <summary>
  5965. Asynchronously unsubscribe the folder.
  5966. </summary>
  5967. <remarks>
  5968. Unsubscribes the folder.
  5969. </remarks>
  5970. <returns>An awaitable task.</returns>
  5971. <param name="cancellationToken">The cancellation token.</param>
  5972. <exception cref="T:System.ObjectDisposedException">
  5973. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  5974. </exception>
  5975. <exception cref="T:MailKit.ServiceNotConnectedException">
  5976. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  5977. </exception>
  5978. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  5979. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  5980. </exception>
  5981. <exception cref="T:System.OperationCanceledException">
  5982. The operation was canceled via the cancellation token.
  5983. </exception>
  5984. <exception cref="T:System.IO.IOException">
  5985. An I/O error occurred.
  5986. </exception>
  5987. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  5988. The server's response contained unexpected tokens.
  5989. </exception>
  5990. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  5991. The server replied with a NO or BAD response.
  5992. </exception>
  5993. </member>
  5994. <member name="M:MailKit.Net.Imap.ImapFolder.GetSubfolders(MailKit.StatusItems,System.Boolean,System.Threading.CancellationToken)">
  5995. <summary>
  5996. Get the subfolders.
  5997. </summary>
  5998. <remarks>
  5999. Gets the subfolders.
  6000. </remarks>
  6001. <returns>The subfolders.</returns>
  6002. <param name="items">The status items to pre-populate.</param>
  6003. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  6004. <param name="cancellationToken">The cancellation token.</param>
  6005. <exception cref="T:System.ObjectDisposedException">
  6006. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6007. </exception>
  6008. <exception cref="T:MailKit.ServiceNotConnectedException">
  6009. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6010. </exception>
  6011. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6012. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6013. </exception>
  6014. <exception cref="T:System.OperationCanceledException">
  6015. The operation was canceled via the cancellation token.
  6016. </exception>
  6017. <exception cref="T:System.IO.IOException">
  6018. An I/O error occurred.
  6019. </exception>
  6020. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6021. The server's response contained unexpected tokens.
  6022. </exception>
  6023. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6024. The server replied with a NO or BAD response.
  6025. </exception>
  6026. </member>
  6027. <member name="M:MailKit.Net.Imap.ImapFolder.GetSubfoldersAsync(MailKit.StatusItems,System.Boolean,System.Threading.CancellationToken)">
  6028. <summary>
  6029. Asynchronously get the subfolders.
  6030. </summary>
  6031. <remarks>
  6032. Gets the subfolders.
  6033. </remarks>
  6034. <returns>The subfolders.</returns>
  6035. <param name="items">The status items to pre-populate.</param>
  6036. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  6037. <param name="cancellationToken">The cancellation token.</param>
  6038. <exception cref="T:System.ObjectDisposedException">
  6039. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6040. </exception>
  6041. <exception cref="T:MailKit.ServiceNotConnectedException">
  6042. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6043. </exception>
  6044. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6045. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6046. </exception>
  6047. <exception cref="T:System.OperationCanceledException">
  6048. The operation was canceled via the cancellation token.
  6049. </exception>
  6050. <exception cref="T:System.IO.IOException">
  6051. An I/O error occurred.
  6052. </exception>
  6053. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6054. The server's response contained unexpected tokens.
  6055. </exception>
  6056. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6057. The server replied with a NO or BAD response.
  6058. </exception>
  6059. </member>
  6060. <member name="M:MailKit.Net.Imap.ImapFolder.GetSubfolder(System.String,System.Threading.CancellationToken)">
  6061. <summary>
  6062. Get the specified subfolder.
  6063. </summary>
  6064. <remarks>
  6065. Gets the specified subfolder.
  6066. </remarks>
  6067. <returns>The subfolder.</returns>
  6068. <param name="name">The name of the subfolder.</param>
  6069. <param name="cancellationToken">The cancellation token.</param>
  6070. <exception cref="T:System.ArgumentNullException">
  6071. <paramref name="name"/> is <c>null</c>.
  6072. </exception>
  6073. <exception cref="T:System.ArgumentException">
  6074. <paramref name="name"/> is either an empty string or contains the <see cref="P:MailKit.MailFolder.DirectorySeparator"/>.
  6075. </exception>
  6076. <exception cref="T:System.ObjectDisposedException">
  6077. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6078. </exception>
  6079. <exception cref="T:MailKit.ServiceNotConnectedException">
  6080. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6081. </exception>
  6082. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6083. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6084. </exception>
  6085. <exception cref="T:System.OperationCanceledException">
  6086. The operation was canceled via the cancellation token.
  6087. </exception>
  6088. <exception cref="T:System.IO.IOException">
  6089. An I/O error occurred.
  6090. </exception>
  6091. <exception cref="T:MailKit.FolderNotFoundException">
  6092. The requested folder could not be found.
  6093. </exception>
  6094. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6095. The server's response contained unexpected tokens.
  6096. </exception>
  6097. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6098. The server replied with a NO or BAD response.
  6099. </exception>
  6100. </member>
  6101. <member name="M:MailKit.Net.Imap.ImapFolder.GetSubfolderAsync(System.String,System.Threading.CancellationToken)">
  6102. <summary>
  6103. Asynchronously get the specified subfolder.
  6104. </summary>
  6105. <remarks>
  6106. Gets the specified subfolder.
  6107. </remarks>
  6108. <returns>The subfolder.</returns>
  6109. <param name="name">The name of the subfolder.</param>
  6110. <param name="cancellationToken">The cancellation token.</param>
  6111. <exception cref="T:System.ArgumentNullException">
  6112. <paramref name="name"/> is <c>null</c>.
  6113. </exception>
  6114. <exception cref="T:System.ArgumentException">
  6115. <paramref name="name"/> is either an empty string or contains the <see cref="P:MailKit.MailFolder.DirectorySeparator"/>.
  6116. </exception>
  6117. <exception cref="T:System.ObjectDisposedException">
  6118. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6119. </exception>
  6120. <exception cref="T:MailKit.ServiceNotConnectedException">
  6121. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6122. </exception>
  6123. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6124. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6125. </exception>
  6126. <exception cref="T:System.OperationCanceledException">
  6127. The operation was canceled via the cancellation token.
  6128. </exception>
  6129. <exception cref="T:System.IO.IOException">
  6130. An I/O error occurred.
  6131. </exception>
  6132. <exception cref="T:MailKit.FolderNotFoundException">
  6133. The requested folder could not be found.
  6134. </exception>
  6135. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6136. The server's response contained unexpected tokens.
  6137. </exception>
  6138. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6139. The server replied with a NO or BAD response.
  6140. </exception>
  6141. </member>
  6142. <member name="M:MailKit.Net.Imap.ImapFolder.Check(System.Threading.CancellationToken)">
  6143. <summary>
  6144. Force the server to sync its in-memory state with its disk state.
  6145. </summary>
  6146. <remarks>
  6147. <para>The <c>CHECK</c> command forces the IMAP server to sync its
  6148. in-memory state with its disk state.</para>
  6149. <para>For more information about the <c>CHECK</c> command, see
  6150. <a href="https://tools.ietf.org/html/rfc3501#section-6.4.1">rfc350101</a>.</para>
  6151. </remarks>
  6152. <param name="cancellationToken">The cancellation token.</param>
  6153. <exception cref="T:System.ObjectDisposedException">
  6154. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6155. </exception>
  6156. <exception cref="T:MailKit.FolderNotOpenException">
  6157. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  6158. </exception>
  6159. <exception cref="T:MailKit.ServiceNotConnectedException">
  6160. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6161. </exception>
  6162. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6163. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6164. </exception>
  6165. <exception cref="T:System.OperationCanceledException">
  6166. The operation was canceled via the cancellation token.
  6167. </exception>
  6168. <exception cref="T:System.IO.IOException">
  6169. An I/O error occurred.
  6170. </exception>
  6171. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6172. The server's response contained unexpected tokens.
  6173. </exception>
  6174. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6175. The server replied with a NO or BAD response.
  6176. </exception>
  6177. </member>
  6178. <member name="M:MailKit.Net.Imap.ImapFolder.CheckAsync(System.Threading.CancellationToken)">
  6179. <summary>
  6180. Asynchronously force the server to sync its in-memory state with its disk state.
  6181. </summary>
  6182. <remarks>
  6183. <para>The <c>CHECK</c> command forces the IMAP server to sync its
  6184. in-memory state with its disk state.</para>
  6185. <para>For more information about the <c>CHECK</c> command, see
  6186. <a href="https://tools.ietf.org/html/rfc3501#section-6.4.1">rfc350101</a>.</para>
  6187. </remarks>
  6188. <returns>An awaitable task.</returns>
  6189. <param name="cancellationToken">The cancellation token.</param>
  6190. <exception cref="T:System.ObjectDisposedException">
  6191. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6192. </exception>
  6193. <exception cref="T:MailKit.FolderNotOpenException">
  6194. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  6195. </exception>
  6196. <exception cref="T:MailKit.ServiceNotConnectedException">
  6197. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6198. </exception>
  6199. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6200. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6201. </exception>
  6202. <exception cref="T:System.OperationCanceledException">
  6203. The operation was canceled via the cancellation token.
  6204. </exception>
  6205. <exception cref="T:System.IO.IOException">
  6206. An I/O error occurred.
  6207. </exception>
  6208. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6209. The server's response contained unexpected tokens.
  6210. </exception>
  6211. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6212. The server replied with a NO or BAD response.
  6213. </exception>
  6214. </member>
  6215. <member name="M:MailKit.Net.Imap.ImapFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)">
  6216. <summary>
  6217. Update the values of the specified items.
  6218. </summary>
  6219. <remarks>
  6220. <para>Updates the values of the specified items.</para>
  6221. <para>The <see cref="M:MailKit.Net.Imap.ImapFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/> method
  6222. MUST NOT be used on a folder that is already in the opened state. Instead, other ways
  6223. of getting the desired information should be used.</para>
  6224. <para>For example, a common use for the <see cref="M:MailKit.Net.Imap.ImapFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/>
  6225. method is to get the number of unread messages in the folder. When the folder is open, however, it is
  6226. possible to use the <see cref="M:MailKit.Net.Imap.ImapFolder.Search(MailKit.Search.SearchQuery,System.Threading.CancellationToken)"/>
  6227. method to query for the list of unread messages.</para>
  6228. <para>For more information about the <c>STATUS</c> command, see
  6229. <a href="https://tools.ietf.org/html/rfc3501#section-6.3.10">rfc3501</a>.</para>
  6230. </remarks>
  6231. <param name="items">The items to update.</param>
  6232. <param name="cancellationToken">The cancellation token.</param>
  6233. <exception cref="T:System.ObjectDisposedException">
  6234. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6235. </exception>
  6236. <exception cref="T:MailKit.ServiceNotConnectedException">
  6237. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6238. </exception>
  6239. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6240. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6241. </exception>
  6242. <exception cref="T:MailKit.FolderNotFoundException">
  6243. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  6244. </exception>
  6245. <exception cref="T:System.NotSupportedException">
  6246. The IMAP server does not support the STATUS command.
  6247. </exception>
  6248. <exception cref="T:System.OperationCanceledException">
  6249. The operation was canceled via the cancellation token.
  6250. </exception>
  6251. <exception cref="T:System.IO.IOException">
  6252. An I/O error occurred.
  6253. </exception>
  6254. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6255. The server's response contained unexpected tokens.
  6256. </exception>
  6257. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6258. The server replied with a NO or BAD response.
  6259. </exception>
  6260. </member>
  6261. <member name="M:MailKit.Net.Imap.ImapFolder.StatusAsync(MailKit.StatusItems,System.Threading.CancellationToken)">
  6262. <summary>
  6263. Asynchronously update the values of the specified items.
  6264. </summary>
  6265. <remarks>
  6266. <para>Updates the values of the specified items.</para>
  6267. <para>The <see cref="M:MailKit.Net.Imap.ImapFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/> method
  6268. MUST NOT be used on a folder that is already in the opened state. Instead, other ways
  6269. of getting the desired information should be used.</para>
  6270. <para>For example, a common use for the <see cref="M:MailKit.Net.Imap.ImapFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/>
  6271. method is to get the number of unread messages in the folder. When the folder is open, however, it is
  6272. possible to use the <see cref="M:MailKit.Net.Imap.ImapFolder.Search(MailKit.Search.SearchQuery,System.Threading.CancellationToken)"/>
  6273. method to query for the list of unread messages.</para>
  6274. <para>For more information about the <c>STATUS</c> command, see
  6275. <a href="https://tools.ietf.org/html/rfc3501#section-6.3.10">rfc3501</a>.</para>
  6276. </remarks>
  6277. <returns>An awaitable task.</returns>
  6278. <param name="items">The items to update.</param>
  6279. <param name="cancellationToken">The cancellation token.</param>
  6280. <exception cref="T:System.ObjectDisposedException">
  6281. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6282. </exception>
  6283. <exception cref="T:MailKit.ServiceNotConnectedException">
  6284. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6285. </exception>
  6286. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6287. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6288. </exception>
  6289. <exception cref="T:MailKit.FolderNotFoundException">
  6290. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  6291. </exception>
  6292. <exception cref="T:System.NotSupportedException">
  6293. The IMAP server does not support the STATUS command.
  6294. </exception>
  6295. <exception cref="T:System.OperationCanceledException">
  6296. The operation was canceled via the cancellation token.
  6297. </exception>
  6298. <exception cref="T:System.IO.IOException">
  6299. An I/O error occurred.
  6300. </exception>
  6301. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6302. The server's response contained unexpected tokens.
  6303. </exception>
  6304. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6305. The server replied with a NO or BAD response.
  6306. </exception>
  6307. </member>
  6308. <member name="M:MailKit.Net.Imap.ImapFolder.GetAccessControlList(System.Threading.CancellationToken)">
  6309. <summary>
  6310. Get the complete access control list for the folder.
  6311. </summary>
  6312. <remarks>
  6313. Gets the complete access control list for the folder.
  6314. </remarks>
  6315. <returns>The access control list.</returns>
  6316. <param name="cancellationToken">The cancellation token.</param>
  6317. <exception cref="T:System.ObjectDisposedException">
  6318. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6319. </exception>
  6320. <exception cref="T:MailKit.ServiceNotConnectedException">
  6321. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6322. </exception>
  6323. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6324. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6325. </exception>
  6326. <exception cref="T:System.NotSupportedException">
  6327. The IMAP server does not support the ACL extension.
  6328. </exception>
  6329. <exception cref="T:System.OperationCanceledException">
  6330. The operation was canceled via the cancellation token.
  6331. </exception>
  6332. <exception cref="T:System.IO.IOException">
  6333. An I/O error occurred.
  6334. </exception>
  6335. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6336. The server's response contained unexpected tokens.
  6337. </exception>
  6338. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6339. The command failed.
  6340. </exception>
  6341. </member>
  6342. <member name="M:MailKit.Net.Imap.ImapFolder.GetAccessControlListAsync(System.Threading.CancellationToken)">
  6343. <summary>
  6344. Asynchronously get the complete access control list for the folder.
  6345. </summary>
  6346. <remarks>
  6347. Gets the complete access control list for the folder.
  6348. </remarks>
  6349. <returns>The access control list.</returns>
  6350. <param name="cancellationToken">The cancellation token.</param>
  6351. <exception cref="T:System.ObjectDisposedException">
  6352. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6353. </exception>
  6354. <exception cref="T:MailKit.ServiceNotConnectedException">
  6355. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6356. </exception>
  6357. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6358. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6359. </exception>
  6360. <exception cref="T:System.NotSupportedException">
  6361. The IMAP server does not support the ACL extension.
  6362. </exception>
  6363. <exception cref="T:System.OperationCanceledException">
  6364. The operation was canceled via the cancellation token.
  6365. </exception>
  6366. <exception cref="T:System.IO.IOException">
  6367. An I/O error occurred.
  6368. </exception>
  6369. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6370. The server's response contained unexpected tokens.
  6371. </exception>
  6372. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6373. The command failed.
  6374. </exception>
  6375. </member>
  6376. <member name="M:MailKit.Net.Imap.ImapFolder.GetAccessRights(System.String,System.Threading.CancellationToken)">
  6377. <summary>
  6378. Get the access rights for a particular identifier.
  6379. </summary>
  6380. <remarks>
  6381. Gets the access rights for a particular identifier.
  6382. </remarks>
  6383. <returns>The access rights.</returns>
  6384. <param name="name">The identifier name.</param>
  6385. <param name="cancellationToken">The cancellation token.</param>
  6386. <exception cref="T:System.ArgumentNullException">
  6387. <paramref name="name"/> is <c>null</c>.
  6388. </exception>
  6389. <exception cref="T:System.ObjectDisposedException">
  6390. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6391. </exception>
  6392. <exception cref="T:MailKit.ServiceNotConnectedException">
  6393. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6394. </exception>
  6395. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6396. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6397. </exception>
  6398. <exception cref="T:System.NotSupportedException">
  6399. The IMAP server does not support the ACL extension.
  6400. </exception>
  6401. <exception cref="T:System.OperationCanceledException">
  6402. The operation was canceled via the cancellation token.
  6403. </exception>
  6404. <exception cref="T:System.IO.IOException">
  6405. An I/O error occurred.
  6406. </exception>
  6407. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6408. The server's response contained unexpected tokens.
  6409. </exception>
  6410. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6411. The command failed.
  6412. </exception>
  6413. </member>
  6414. <member name="M:MailKit.Net.Imap.ImapFolder.GetAccessRightsAsync(System.String,System.Threading.CancellationToken)">
  6415. <summary>
  6416. Asynchronously get the access rights for a particular identifier.
  6417. </summary>
  6418. <remarks>
  6419. Gets the access rights for a particular identifier.
  6420. </remarks>
  6421. <returns>The access rights.</returns>
  6422. <param name="name">The identifier name.</param>
  6423. <param name="cancellationToken">The cancellation token.</param>
  6424. <exception cref="T:System.ArgumentNullException">
  6425. <paramref name="name"/> is <c>null</c>.
  6426. </exception>
  6427. <exception cref="T:System.ObjectDisposedException">
  6428. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6429. </exception>
  6430. <exception cref="T:MailKit.ServiceNotConnectedException">
  6431. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6432. </exception>
  6433. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6434. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6435. </exception>
  6436. <exception cref="T:System.NotSupportedException">
  6437. The IMAP server does not support the ACL extension.
  6438. </exception>
  6439. <exception cref="T:System.OperationCanceledException">
  6440. The operation was canceled via the cancellation token.
  6441. </exception>
  6442. <exception cref="T:System.IO.IOException">
  6443. An I/O error occurred.
  6444. </exception>
  6445. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6446. The server's response contained unexpected tokens.
  6447. </exception>
  6448. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6449. The command failed.
  6450. </exception>
  6451. </member>
  6452. <member name="M:MailKit.Net.Imap.ImapFolder.GetMyAccessRights(System.Threading.CancellationToken)">
  6453. <summary>
  6454. Get the access rights for the current authenticated user.
  6455. </summary>
  6456. <remarks>
  6457. Gets the access rights for the current authenticated user.
  6458. </remarks>
  6459. <returns>The access rights.</returns>
  6460. <param name="cancellationToken">The cancellation token.</param>
  6461. <exception cref="T:System.ObjectDisposedException">
  6462. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6463. </exception>
  6464. <exception cref="T:MailKit.ServiceNotConnectedException">
  6465. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6466. </exception>
  6467. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6468. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6469. </exception>
  6470. <exception cref="T:System.NotSupportedException">
  6471. The IMAP server does not support the ACL extension.
  6472. </exception>
  6473. <exception cref="T:System.OperationCanceledException">
  6474. The operation was canceled via the cancellation token.
  6475. </exception>
  6476. <exception cref="T:System.IO.IOException">
  6477. An I/O error occurred.
  6478. </exception>
  6479. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6480. The server's response contained unexpected tokens.
  6481. </exception>
  6482. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6483. The command failed.
  6484. </exception>
  6485. </member>
  6486. <member name="M:MailKit.Net.Imap.ImapFolder.GetMyAccessRightsAsync(System.Threading.CancellationToken)">
  6487. <summary>
  6488. Asynchronously get the access rights for the current authenticated user.
  6489. </summary>
  6490. <remarks>
  6491. Gets the access rights for the current authenticated user.
  6492. </remarks>
  6493. <returns>The access rights.</returns>
  6494. <param name="cancellationToken">The cancellation token.</param>
  6495. <exception cref="T:System.ObjectDisposedException">
  6496. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6497. </exception>
  6498. <exception cref="T:MailKit.ServiceNotConnectedException">
  6499. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6500. </exception>
  6501. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6502. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6503. </exception>
  6504. <exception cref="T:System.NotSupportedException">
  6505. The IMAP server does not support the ACL extension.
  6506. </exception>
  6507. <exception cref="T:System.OperationCanceledException">
  6508. The operation was canceled via the cancellation token.
  6509. </exception>
  6510. <exception cref="T:System.IO.IOException">
  6511. An I/O error occurred.
  6512. </exception>
  6513. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6514. The server's response contained unexpected tokens.
  6515. </exception>
  6516. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6517. The command failed.
  6518. </exception>
  6519. </member>
  6520. <member name="M:MailKit.Net.Imap.ImapFolder.AddAccessRights(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  6521. <summary>
  6522. Add access rights for the specified identity.
  6523. </summary>
  6524. <remarks>
  6525. Adds the given access rights for the specified identity.
  6526. </remarks>
  6527. <param name="name">The identity name.</param>
  6528. <param name="rights">The access rights.</param>
  6529. <param name="cancellationToken">The cancellation token.</param>
  6530. <exception cref="T:System.ArgumentNullException">
  6531. <para><paramref name="name"/> is <c>null</c>.</para>
  6532. <para>-or-</para>
  6533. <para><paramref name="rights"/> is <c>null</c>.</para>
  6534. </exception>
  6535. <exception cref="T:System.ArgumentException">
  6536. No rights were specified.
  6537. </exception>
  6538. <exception cref="T:System.ObjectDisposedException">
  6539. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6540. </exception>
  6541. <exception cref="T:MailKit.ServiceNotConnectedException">
  6542. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6543. </exception>
  6544. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6545. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6546. </exception>
  6547. <exception cref="T:System.NotSupportedException">
  6548. The IMAP server does not support the ACL extension.
  6549. </exception>
  6550. <exception cref="T:System.OperationCanceledException">
  6551. The operation was canceled via the cancellation token.
  6552. </exception>
  6553. <exception cref="T:System.IO.IOException">
  6554. An I/O error occurred.
  6555. </exception>
  6556. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6557. The server's response contained unexpected tokens.
  6558. </exception>
  6559. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6560. The command failed.
  6561. </exception>
  6562. </member>
  6563. <member name="M:MailKit.Net.Imap.ImapFolder.AddAccessRightsAsync(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  6564. <summary>
  6565. Asynchronously add access rights for the specified identity.
  6566. </summary>
  6567. <remarks>
  6568. Adds the given access rights for the specified identity.
  6569. </remarks>
  6570. <returns>An asynchronous task context.</returns>
  6571. <param name="name">The identity name.</param>
  6572. <param name="rights">The access rights.</param>
  6573. <param name="cancellationToken">The cancellation token.</param>
  6574. <exception cref="T:System.ArgumentNullException">
  6575. <para><paramref name="name"/> is <c>null</c>.</para>
  6576. <para>-or-</para>
  6577. <para><paramref name="rights"/> is <c>null</c>.</para>
  6578. </exception>
  6579. <exception cref="T:System.ArgumentException">
  6580. No rights were specified.
  6581. </exception>
  6582. <exception cref="T:System.ObjectDisposedException">
  6583. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6584. </exception>
  6585. <exception cref="T:MailKit.ServiceNotConnectedException">
  6586. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6587. </exception>
  6588. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6589. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6590. </exception>
  6591. <exception cref="T:System.NotSupportedException">
  6592. The IMAP server does not support the ACL extension.
  6593. </exception>
  6594. <exception cref="T:System.OperationCanceledException">
  6595. The operation was canceled via the cancellation token.
  6596. </exception>
  6597. <exception cref="T:System.IO.IOException">
  6598. An I/O error occurred.
  6599. </exception>
  6600. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6601. The server's response contained unexpected tokens.
  6602. </exception>
  6603. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6604. The command failed.
  6605. </exception>
  6606. </member>
  6607. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveAccessRights(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  6608. <summary>
  6609. Remove access rights for the specified identity.
  6610. </summary>
  6611. <remarks>
  6612. Removes the given access rights for the specified identity.
  6613. </remarks>
  6614. <param name="name">The identity name.</param>
  6615. <param name="rights">The access rights.</param>
  6616. <param name="cancellationToken">The cancellation token.</param>
  6617. <exception cref="T:System.ArgumentNullException">
  6618. <para><paramref name="name"/> is <c>null</c>.</para>
  6619. <para>-or-</para>
  6620. <para><paramref name="rights"/> is <c>null</c>.</para>
  6621. </exception>
  6622. <exception cref="T:System.ArgumentException">
  6623. No rights were specified.
  6624. </exception>
  6625. <exception cref="T:System.ObjectDisposedException">
  6626. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6627. </exception>
  6628. <exception cref="T:MailKit.ServiceNotConnectedException">
  6629. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6630. </exception>
  6631. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6632. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6633. </exception>
  6634. <exception cref="T:System.NotSupportedException">
  6635. The IMAP server does not support the ACL extension.
  6636. </exception>
  6637. <exception cref="T:System.OperationCanceledException">
  6638. The operation was canceled via the cancellation token.
  6639. </exception>
  6640. <exception cref="T:System.IO.IOException">
  6641. An I/O error occurred.
  6642. </exception>
  6643. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6644. The server's response contained unexpected tokens.
  6645. </exception>
  6646. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6647. The command failed.
  6648. </exception>
  6649. </member>
  6650. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveAccessRightsAsync(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  6651. <summary>
  6652. Asynchronously remove access rights for the specified identity.
  6653. </summary>
  6654. <remarks>
  6655. Removes the given access rights for the specified identity.
  6656. </remarks>
  6657. <returns>An asynchronous task context.</returns>
  6658. <param name="name">The identity name.</param>
  6659. <param name="rights">The access rights.</param>
  6660. <param name="cancellationToken">The cancellation token.</param>
  6661. <exception cref="T:System.ArgumentNullException">
  6662. <para><paramref name="name"/> is <c>null</c>.</para>
  6663. <para>-or-</para>
  6664. <para><paramref name="rights"/> is <c>null</c>.</para>
  6665. </exception>
  6666. <exception cref="T:System.ArgumentException">
  6667. No rights were specified.
  6668. </exception>
  6669. <exception cref="T:System.ObjectDisposedException">
  6670. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6671. </exception>
  6672. <exception cref="T:MailKit.ServiceNotConnectedException">
  6673. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6674. </exception>
  6675. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6676. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6677. </exception>
  6678. <exception cref="T:System.NotSupportedException">
  6679. The IMAP server does not support the ACL extension.
  6680. </exception>
  6681. <exception cref="T:System.OperationCanceledException">
  6682. The operation was canceled via the cancellation token.
  6683. </exception>
  6684. <exception cref="T:System.IO.IOException">
  6685. An I/O error occurred.
  6686. </exception>
  6687. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6688. The server's response contained unexpected tokens.
  6689. </exception>
  6690. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6691. The command failed.
  6692. </exception>
  6693. </member>
  6694. <member name="M:MailKit.Net.Imap.ImapFolder.SetAccessRights(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  6695. <summary>
  6696. Set the access rights for the specified identity.
  6697. </summary>
  6698. <remarks>
  6699. Sets the access rights for the specified identity.
  6700. </remarks>
  6701. <param name="name">The identity name.</param>
  6702. <param name="rights">The access rights.</param>
  6703. <param name="cancellationToken">The cancellation token.</param>
  6704. <exception cref="T:System.ArgumentNullException">
  6705. <para><paramref name="name"/> is <c>null</c>.</para>
  6706. <para>-or-</para>
  6707. <para><paramref name="rights"/> is <c>null</c>.</para>
  6708. </exception>
  6709. <exception cref="T:System.ObjectDisposedException">
  6710. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6711. </exception>
  6712. <exception cref="T:MailKit.ServiceNotConnectedException">
  6713. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6714. </exception>
  6715. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6716. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6717. </exception>
  6718. <exception cref="T:System.NotSupportedException">
  6719. The IMAP server does not support the ACL extension.
  6720. </exception>
  6721. <exception cref="T:System.OperationCanceledException">
  6722. The operation was canceled via the cancellation token.
  6723. </exception>
  6724. <exception cref="T:System.IO.IOException">
  6725. An I/O error occurred.
  6726. </exception>
  6727. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6728. The server's response contained unexpected tokens.
  6729. </exception>
  6730. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6731. The command failed.
  6732. </exception>
  6733. </member>
  6734. <member name="M:MailKit.Net.Imap.ImapFolder.SetAccessRightsAsync(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  6735. <summary>
  6736. Asynchronously get the access rights for the specified identity.
  6737. </summary>
  6738. <remarks>
  6739. Sets the access rights for the specified identity.
  6740. </remarks>
  6741. <returns>An awaitable task.</returns>
  6742. <param name="name">The identity name.</param>
  6743. <param name="rights">The access rights.</param>
  6744. <param name="cancellationToken">The cancellation token.</param>
  6745. <exception cref="T:System.ArgumentNullException">
  6746. <para><paramref name="name"/> is <c>null</c>.</para>
  6747. <para>-or-</para>
  6748. <para><paramref name="rights"/> is <c>null</c>.</para>
  6749. </exception>
  6750. <exception cref="T:System.ObjectDisposedException">
  6751. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6752. </exception>
  6753. <exception cref="T:MailKit.ServiceNotConnectedException">
  6754. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6755. </exception>
  6756. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6757. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6758. </exception>
  6759. <exception cref="T:System.NotSupportedException">
  6760. The IMAP server does not support the ACL extension.
  6761. </exception>
  6762. <exception cref="T:System.OperationCanceledException">
  6763. The operation was canceled via the cancellation token.
  6764. </exception>
  6765. <exception cref="T:System.IO.IOException">
  6766. An I/O error occurred.
  6767. </exception>
  6768. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6769. The server's response contained unexpected tokens.
  6770. </exception>
  6771. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6772. The command failed.
  6773. </exception>
  6774. </member>
  6775. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveAccess(System.String,System.Threading.CancellationToken)">
  6776. <summary>
  6777. Remove all access rights for the given identity.
  6778. </summary>
  6779. <remarks>
  6780. Removes all access rights for the given identity.
  6781. </remarks>
  6782. <param name="name">The identity name.</param>
  6783. <param name="cancellationToken">The cancellation token.</param>
  6784. <exception cref="T:System.ArgumentNullException">
  6785. <paramref name="name"/> is <c>null</c>.
  6786. </exception>
  6787. <exception cref="T:System.ObjectDisposedException">
  6788. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6789. </exception>
  6790. <exception cref="T:MailKit.ServiceNotConnectedException">
  6791. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6792. </exception>
  6793. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6794. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6795. </exception>
  6796. <exception cref="T:System.NotSupportedException">
  6797. The IMAP server does not support the ACL extension.
  6798. </exception>
  6799. <exception cref="T:System.OperationCanceledException">
  6800. The operation was canceled via the cancellation token.
  6801. </exception>
  6802. <exception cref="T:System.IO.IOException">
  6803. An I/O error occurred.
  6804. </exception>
  6805. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6806. The server's response contained unexpected tokens.
  6807. </exception>
  6808. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6809. The command failed.
  6810. </exception>
  6811. </member>
  6812. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveAccessAsync(System.String,System.Threading.CancellationToken)">
  6813. <summary>
  6814. Asynchronously remove all access rights for the given identity.
  6815. </summary>
  6816. <remarks>
  6817. Removes all access rights for the given identity.
  6818. </remarks>
  6819. <returns>An awaitable task.</returns>
  6820. <param name="name">The identity name.</param>
  6821. <param name="cancellationToken">The cancellation token.</param>
  6822. <exception cref="T:System.ArgumentNullException">
  6823. <paramref name="name"/> is <c>null</c>.
  6824. </exception>
  6825. <exception cref="T:System.ObjectDisposedException">
  6826. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6827. </exception>
  6828. <exception cref="T:MailKit.ServiceNotConnectedException">
  6829. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6830. </exception>
  6831. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6832. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6833. </exception>
  6834. <exception cref="T:System.NotSupportedException">
  6835. The IMAP server does not support the ACL extension.
  6836. </exception>
  6837. <exception cref="T:System.OperationCanceledException">
  6838. The operation was canceled via the cancellation token.
  6839. </exception>
  6840. <exception cref="T:System.IO.IOException">
  6841. An I/O error occurred.
  6842. </exception>
  6843. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6844. The server's response contained unexpected tokens.
  6845. </exception>
  6846. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6847. The command failed.
  6848. </exception>
  6849. </member>
  6850. <member name="M:MailKit.Net.Imap.ImapFolder.GetMetadata(MailKit.MetadataTag,System.Threading.CancellationToken)">
  6851. <summary>
  6852. Get the specified metadata.
  6853. </summary>
  6854. <remarks>
  6855. Gets the specified metadata.
  6856. </remarks>
  6857. <returns>The requested metadata value.</returns>
  6858. <param name="tag">The metadata tag.</param>
  6859. <param name="cancellationToken">The cancellation token.</param>
  6860. <exception cref="T:System.ObjectDisposedException">
  6861. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6862. </exception>
  6863. <exception cref="T:MailKit.ServiceNotConnectedException">
  6864. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6865. </exception>
  6866. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6867. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6868. </exception>
  6869. <exception cref="T:System.NotSupportedException">
  6870. The IMAP server does not support the METADATA extension.
  6871. </exception>
  6872. <exception cref="T:System.OperationCanceledException">
  6873. The operation was canceled via the cancellation token.
  6874. </exception>
  6875. <exception cref="T:System.IO.IOException">
  6876. An I/O error occurred.
  6877. </exception>
  6878. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6879. The server's response contained unexpected tokens.
  6880. </exception>
  6881. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6882. The server replied with a NO or BAD response.
  6883. </exception>
  6884. </member>
  6885. <member name="M:MailKit.Net.Imap.ImapFolder.GetMetadataAsync(MailKit.MetadataTag,System.Threading.CancellationToken)">
  6886. <summary>
  6887. Asynchronously get the specified metadata.
  6888. </summary>
  6889. <remarks>
  6890. Gets the specified metadata.
  6891. </remarks>
  6892. <returns>The requested metadata value.</returns>
  6893. <param name="tag">The metadata tag.</param>
  6894. <param name="cancellationToken">The cancellation token.</param>
  6895. <exception cref="T:System.ObjectDisposedException">
  6896. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6897. </exception>
  6898. <exception cref="T:MailKit.ServiceNotConnectedException">
  6899. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6900. </exception>
  6901. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6902. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6903. </exception>
  6904. <exception cref="T:System.NotSupportedException">
  6905. The IMAP server does not support the METADATA extension.
  6906. </exception>
  6907. <exception cref="T:System.OperationCanceledException">
  6908. The operation was canceled via the cancellation token.
  6909. </exception>
  6910. <exception cref="T:System.IO.IOException">
  6911. An I/O error occurred.
  6912. </exception>
  6913. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6914. The server's response contained unexpected tokens.
  6915. </exception>
  6916. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6917. The server replied with a NO or BAD response.
  6918. </exception>
  6919. </member>
  6920. <member name="M:MailKit.Net.Imap.ImapFolder.GetMetadata(MailKit.MetadataOptions,System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  6921. <summary>
  6922. Get the specified metadata.
  6923. </summary>
  6924. <remarks>
  6925. Gets the specified metadata.
  6926. </remarks>
  6927. <returns>The requested metadata.</returns>
  6928. <param name="options">The metadata options.</param>
  6929. <param name="tags">The metadata tags.</param>
  6930. <param name="cancellationToken">The cancellation token.</param>
  6931. <exception cref="T:System.ArgumentNullException">
  6932. <para><paramref name="options"/> is <c>null</c>.</para>
  6933. <para>-or-</para>
  6934. <para><paramref name="tags"/> is <c>null</c>.</para>
  6935. </exception>
  6936. <exception cref="T:System.ObjectDisposedException">
  6937. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6938. </exception>
  6939. <exception cref="T:MailKit.ServiceNotConnectedException">
  6940. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6941. </exception>
  6942. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6943. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6944. </exception>
  6945. <exception cref="T:System.NotSupportedException">
  6946. The IMAP server does not support the METADATA extension.
  6947. </exception>
  6948. <exception cref="T:System.OperationCanceledException">
  6949. The operation was canceled via the cancellation token.
  6950. </exception>
  6951. <exception cref="T:System.IO.IOException">
  6952. An I/O error occurred.
  6953. </exception>
  6954. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6955. The server's response contained unexpected tokens.
  6956. </exception>
  6957. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6958. The server replied with a NO or BAD response.
  6959. </exception>
  6960. </member>
  6961. <member name="M:MailKit.Net.Imap.ImapFolder.GetMetadataAsync(MailKit.MetadataOptions,System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  6962. <summary>
  6963. Asynchronously get the specified metadata.
  6964. </summary>
  6965. <remarks>
  6966. Gets the specified metadata.
  6967. </remarks>
  6968. <returns>The requested metadata.</returns>
  6969. <param name="options">The metadata options.</param>
  6970. <param name="tags">The metadata tags.</param>
  6971. <param name="cancellationToken">The cancellation token.</param>
  6972. <exception cref="T:System.ArgumentNullException">
  6973. <para><paramref name="options"/> is <c>null</c>.</para>
  6974. <para>-or-</para>
  6975. <para><paramref name="tags"/> is <c>null</c>.</para>
  6976. </exception>
  6977. <exception cref="T:System.ObjectDisposedException">
  6978. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  6979. </exception>
  6980. <exception cref="T:MailKit.ServiceNotConnectedException">
  6981. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  6982. </exception>
  6983. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  6984. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  6985. </exception>
  6986. <exception cref="T:System.NotSupportedException">
  6987. The IMAP server does not support the METADATA extension.
  6988. </exception>
  6989. <exception cref="T:System.OperationCanceledException">
  6990. The operation was canceled via the cancellation token.
  6991. </exception>
  6992. <exception cref="T:System.IO.IOException">
  6993. An I/O error occurred.
  6994. </exception>
  6995. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  6996. The server's response contained unexpected tokens.
  6997. </exception>
  6998. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  6999. The server replied with a NO or BAD response.
  7000. </exception>
  7001. </member>
  7002. <member name="M:MailKit.Net.Imap.ImapFolder.SetMetadata(MailKit.MetadataCollection,System.Threading.CancellationToken)">
  7003. <summary>
  7004. Set the specified metadata.
  7005. </summary>
  7006. <remarks>
  7007. Sets the specified metadata.
  7008. </remarks>
  7009. <param name="metadata">The metadata.</param>
  7010. <param name="cancellationToken">The cancellation token.</param>
  7011. <exception cref="T:System.ArgumentNullException">
  7012. <paramref name="metadata"/> is <c>null</c>.
  7013. </exception>
  7014. <exception cref="T:System.ObjectDisposedException">
  7015. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7016. </exception>
  7017. <exception cref="T:MailKit.ServiceNotConnectedException">
  7018. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7019. </exception>
  7020. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7021. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7022. </exception>
  7023. <exception cref="T:System.NotSupportedException">
  7024. The IMAP server does not support the METADATA extension.
  7025. </exception>
  7026. <exception cref="T:System.OperationCanceledException">
  7027. The operation was canceled via the cancellation token.
  7028. </exception>
  7029. <exception cref="T:System.IO.IOException">
  7030. An I/O error occurred.
  7031. </exception>
  7032. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7033. The server's response contained unexpected tokens.
  7034. </exception>
  7035. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7036. The server replied with a NO or BAD response.
  7037. </exception>
  7038. </member>
  7039. <member name="M:MailKit.Net.Imap.ImapFolder.SetMetadataAsync(MailKit.MetadataCollection,System.Threading.CancellationToken)">
  7040. <summary>
  7041. Asynchronously set the specified metadata.
  7042. </summary>
  7043. <remarks>
  7044. Sets the specified metadata.
  7045. </remarks>
  7046. <returns>An asynchronous task context.</returns>
  7047. <param name="metadata">The metadata.</param>
  7048. <param name="cancellationToken">The cancellation token.</param>
  7049. <exception cref="T:System.ArgumentNullException">
  7050. <paramref name="metadata"/> is <c>null</c>.
  7051. </exception>
  7052. <exception cref="T:System.ObjectDisposedException">
  7053. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7054. </exception>
  7055. <exception cref="T:MailKit.ServiceNotConnectedException">
  7056. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7057. </exception>
  7058. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7059. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7060. </exception>
  7061. <exception cref="T:System.NotSupportedException">
  7062. The IMAP server does not support the METADATA extension.
  7063. </exception>
  7064. <exception cref="T:System.OperationCanceledException">
  7065. The operation was canceled via the cancellation token.
  7066. </exception>
  7067. <exception cref="T:System.IO.IOException">
  7068. An I/O error occurred.
  7069. </exception>
  7070. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7071. The server's response contained unexpected tokens.
  7072. </exception>
  7073. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7074. The server replied with a NO or BAD response.
  7075. </exception>
  7076. </member>
  7077. <member name="M:MailKit.Net.Imap.ImapFolder.GetQuota(System.Threading.CancellationToken)">
  7078. <summary>
  7079. Get the quota information for the folder.
  7080. </summary>
  7081. <remarks>
  7082. <para>Gets the quota information for the folder.</para>
  7083. <para>To determine if a quotas are supported, check the
  7084. <see cref="P:MailKit.Net.Imap.ImapClient.SupportsQuotas"/> property.</para>
  7085. </remarks>
  7086. <returns>The folder quota.</returns>
  7087. <param name="cancellationToken">The cancellation token.</param>
  7088. <exception cref="T:System.ObjectDisposedException">
  7089. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7090. </exception>
  7091. <exception cref="T:MailKit.ServiceNotConnectedException">
  7092. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7093. </exception>
  7094. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7095. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7096. </exception>
  7097. <exception cref="T:System.NotSupportedException">
  7098. The IMAP server does not support the QUOTA extension.
  7099. </exception>
  7100. <exception cref="T:System.OperationCanceledException">
  7101. The operation was canceled via the cancellation token.
  7102. </exception>
  7103. <exception cref="T:System.IO.IOException">
  7104. An I/O error occurred.
  7105. </exception>
  7106. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7107. The server's response contained unexpected tokens.
  7108. </exception>
  7109. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7110. The server replied with a NO or BAD response.
  7111. </exception>
  7112. </member>
  7113. <member name="M:MailKit.Net.Imap.ImapFolder.GetQuotaAsync(System.Threading.CancellationToken)">
  7114. <summary>
  7115. Asynchronously get the quota information for the folder.
  7116. </summary>
  7117. <remarks>
  7118. <para>Gets the quota information for the folder.</para>
  7119. <para>To determine if a quotas are supported, check the
  7120. <see cref="P:MailKit.Net.Imap.ImapClient.SupportsQuotas"/> property.</para>
  7121. </remarks>
  7122. <returns>The folder quota.</returns>
  7123. <param name="cancellationToken">The cancellation token.</param>
  7124. <exception cref="T:System.ObjectDisposedException">
  7125. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7126. </exception>
  7127. <exception cref="T:MailKit.ServiceNotConnectedException">
  7128. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7129. </exception>
  7130. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7131. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7132. </exception>
  7133. <exception cref="T:System.NotSupportedException">
  7134. The IMAP server does not support the QUOTA extension.
  7135. </exception>
  7136. <exception cref="T:System.OperationCanceledException">
  7137. The operation was canceled via the cancellation token.
  7138. </exception>
  7139. <exception cref="T:System.IO.IOException">
  7140. An I/O error occurred.
  7141. </exception>
  7142. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7143. The server's response contained unexpected tokens.
  7144. </exception>
  7145. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7146. The server replied with a NO or BAD response.
  7147. </exception>
  7148. </member>
  7149. <member name="M:MailKit.Net.Imap.ImapFolder.SetQuota(System.Nullable{System.UInt32},System.Nullable{System.UInt32},System.Threading.CancellationToken)">
  7150. <summary>
  7151. Set the quota limits for the folder.
  7152. </summary>
  7153. <remarks>
  7154. <para>Sets the quota limits for the folder.</para>
  7155. <para>To determine if a quotas are supported, check the
  7156. <see cref="P:MailKit.Net.Imap.ImapClient.SupportsQuotas"/> property.</para>
  7157. </remarks>
  7158. <returns>The folder quota.</returns>
  7159. <param name="messageLimit">If not <c>null</c>, sets the maximum number of messages to allow.</param>
  7160. <param name="storageLimit">If not <c>null</c>, sets the maximum storage size (in kilobytes).</param>
  7161. <param name="cancellationToken">The cancellation token.</param>
  7162. <exception cref="T:System.ObjectDisposedException">
  7163. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7164. </exception>
  7165. <exception cref="T:MailKit.ServiceNotConnectedException">
  7166. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7167. </exception>
  7168. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7169. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7170. </exception>
  7171. <exception cref="T:System.NotSupportedException">
  7172. The IMAP server does not support the QUOTA extension.
  7173. </exception>
  7174. <exception cref="T:System.OperationCanceledException">
  7175. The operation was canceled via the cancellation token.
  7176. </exception>
  7177. <exception cref="T:System.IO.IOException">
  7178. An I/O error occurred.
  7179. </exception>
  7180. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7181. The server's response contained unexpected tokens.
  7182. </exception>
  7183. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7184. The server replied with a NO or BAD response.
  7185. </exception>
  7186. </member>
  7187. <member name="M:MailKit.Net.Imap.ImapFolder.SetQuotaAsync(System.Nullable{System.UInt32},System.Nullable{System.UInt32},System.Threading.CancellationToken)">
  7188. <summary>
  7189. Asynchronously set the quota limits for the folder.
  7190. </summary>
  7191. <remarks>
  7192. <para>Sets the quota limits for the folder.</para>
  7193. <para>To determine if a quotas are supported, check the
  7194. <see cref="P:MailKit.Net.Imap.ImapClient.SupportsQuotas"/> property.</para>
  7195. </remarks>
  7196. <returns>The folder quota.</returns>
  7197. <param name="messageLimit">If not <c>null</c>, sets the maximum number of messages to allow.</param>
  7198. <param name="storageLimit">If not <c>null</c>, sets the maximum storage size (in kilobytes).</param>
  7199. <param name="cancellationToken">The cancellation token.</param>
  7200. <exception cref="T:System.ObjectDisposedException">
  7201. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7202. </exception>
  7203. <exception cref="T:MailKit.ServiceNotConnectedException">
  7204. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7205. </exception>
  7206. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7207. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7208. </exception>
  7209. <exception cref="T:System.NotSupportedException">
  7210. The IMAP server does not support the QUOTA extension.
  7211. </exception>
  7212. <exception cref="T:System.OperationCanceledException">
  7213. The operation was canceled via the cancellation token.
  7214. </exception>
  7215. <exception cref="T:System.IO.IOException">
  7216. An I/O error occurred.
  7217. </exception>
  7218. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7219. The server's response contained unexpected tokens.
  7220. </exception>
  7221. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7222. The server replied with a NO or BAD response.
  7223. </exception>
  7224. </member>
  7225. <member name="M:MailKit.Net.Imap.ImapFolder.Expunge(System.Threading.CancellationToken)">
  7226. <summary>
  7227. Expunge the folder, permanently removing all messages marked for deletion.
  7228. </summary>
  7229. <remarks>
  7230. <para>The <c>EXPUNGE</c> command permanently removes all messages in the folder
  7231. that have the <see cref="F:MailKit.MessageFlags.Deleted"/> flag set.</para>
  7232. <para>For more information about the <c>EXPUNGE</c> command, see
  7233. <a href="https://tools.ietf.org/html/rfc3501#section-6.4.3">rfc3501</a>.</para>
  7234. <note type="note">Normally, a <see cref="E:MailKit.MailFolder.MessageExpunged"/> event will be emitted
  7235. for each message that is expunged. However, if the IMAP server supports the QRESYNC extension
  7236. and it has been enabled via the <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/>
  7237. method, then the <see cref="E:MailKit.MailFolder.MessagesVanished"/> event will be emitted rather than
  7238. the <see cref="E:MailKit.MailFolder.MessageExpunged"/> event.</note>
  7239. </remarks>
  7240. <param name="cancellationToken">The cancellation token.</param>
  7241. <exception cref="T:System.ObjectDisposedException">
  7242. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7243. </exception>
  7244. <exception cref="T:MailKit.FolderNotOpenException">
  7245. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  7246. </exception>
  7247. <exception cref="T:MailKit.ServiceNotConnectedException">
  7248. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7249. </exception>
  7250. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7251. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7252. </exception>
  7253. <exception cref="T:System.OperationCanceledException">
  7254. The operation was canceled via the cancellation token.
  7255. </exception>
  7256. <exception cref="T:System.IO.IOException">
  7257. An I/O error occurred.
  7258. </exception>
  7259. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7260. The server's response contained unexpected tokens.
  7261. </exception>
  7262. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7263. The server replied with a NO or BAD response.
  7264. </exception>
  7265. </member>
  7266. <member name="M:MailKit.Net.Imap.ImapFolder.ExpungeAsync(System.Threading.CancellationToken)">
  7267. <summary>
  7268. Asynchronously expunge the folder, permanently removing all messages marked for deletion.
  7269. </summary>
  7270. <remarks>
  7271. <para>The <c>EXPUNGE</c> command permanently removes all messages in the folder
  7272. that have the <see cref="F:MailKit.MessageFlags.Deleted"/> flag set.</para>
  7273. <para>For more information about the <c>EXPUNGE</c> command, see
  7274. <a href="https://tools.ietf.org/html/rfc3501#section-6.4.3">rfc3501</a>.</para>
  7275. <note type="note">Normally, a <see cref="E:MailKit.MailFolder.MessageExpunged"/> event will be emitted
  7276. for each message that is expunged. However, if the IMAP server supports the QRESYNC extension
  7277. and it has been enabled via the <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/>
  7278. method, then the <see cref="E:MailKit.MailFolder.MessagesVanished"/> event will be emitted rather than
  7279. the <see cref="E:MailKit.MailFolder.MessageExpunged"/> event.</note>
  7280. </remarks>
  7281. <returns>An asynchronous task context.</returns>
  7282. <param name="cancellationToken">The cancellation token.</param>
  7283. <exception cref="T:System.ObjectDisposedException">
  7284. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7285. </exception>
  7286. <exception cref="T:MailKit.FolderNotOpenException">
  7287. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  7288. </exception>
  7289. <exception cref="T:MailKit.ServiceNotConnectedException">
  7290. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7291. </exception>
  7292. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7293. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7294. </exception>
  7295. <exception cref="T:System.OperationCanceledException">
  7296. The operation was canceled via the cancellation token.
  7297. </exception>
  7298. <exception cref="T:System.IO.IOException">
  7299. An I/O error occurred.
  7300. </exception>
  7301. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7302. The server's response contained unexpected tokens.
  7303. </exception>
  7304. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7305. The server replied with a NO or BAD response.
  7306. </exception>
  7307. </member>
  7308. <member name="M:MailKit.Net.Imap.ImapFolder.Expunge(System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)">
  7309. <summary>
  7310. Expunge the specified uids, permanently removing them from the folder.
  7311. </summary>
  7312. <remarks>
  7313. <para>Expunges the specified uids, permanently removing them from the folder.</para>
  7314. <para>If the IMAP server supports the UIDPLUS extension (check the
  7315. <see cref="P:MailKit.Net.Imap.ImapClient.Capabilities"/> for the <see cref="F:MailKit.Net.Imap.ImapCapabilities.UidPlus"/>
  7316. flag), then this operation is atomic. Otherwise, MailKit implements this operation
  7317. by first searching for the full list of message uids in the folder that are marked for
  7318. deletion, unmarking the set of message uids that are not within the specified list of
  7319. uids to be be expunged, expunging the folder (thus expunging the requested uids), and
  7320. finally restoring the deleted flag on the collection of message uids that were originally
  7321. marked for deletion that were not included in the list of uids provided. For this reason,
  7322. it is advisable for clients that wish to maintain state to implement this themselves when
  7323. the IMAP server does not support the UIDPLUS extension.</para>
  7324. <para>For more information about the <c>UID EXPUNGE</c> command, see
  7325. <a href="https://tools.ietf.org/html/rfc4315#section-2.1">rfc4315</a>.</para>
  7326. <note type="note">Normally, a <see cref="E:MailKit.MailFolder.MessageExpunged"/> event will be emitted
  7327. for each message that is expunged. However, if the IMAP server supports the QRESYNC extension
  7328. and it has been enabled via the <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/>
  7329. method, then the <see cref="E:MailKit.MailFolder.MessagesVanished"/> event will be emitted rather than
  7330. the <see cref="E:MailKit.MailFolder.MessageExpunged"/> event.</note>
  7331. </remarks>
  7332. <param name="uids">The message uids.</param>
  7333. <param name="cancellationToken">The cancellation token.</param>
  7334. <exception cref="T:System.ArgumentNullException">
  7335. <paramref name="uids"/> is <c>null</c>.
  7336. </exception>
  7337. <exception cref="T:System.ArgumentException">
  7338. One or more of the <paramref name="uids"/> is invalid.
  7339. </exception>
  7340. <exception cref="T:System.ObjectDisposedException">
  7341. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7342. </exception>
  7343. <exception cref="T:MailKit.ServiceNotConnectedException">
  7344. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7345. </exception>
  7346. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7347. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7348. </exception>
  7349. <exception cref="T:MailKit.FolderNotOpenException">
  7350. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  7351. </exception>
  7352. <exception cref="T:System.OperationCanceledException">
  7353. The operation was canceled via the cancellation token.
  7354. </exception>
  7355. <exception cref="T:System.IO.IOException">
  7356. An I/O error occurred.
  7357. </exception>
  7358. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7359. The server's response contained unexpected tokens.
  7360. </exception>
  7361. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7362. The server replied with a NO or BAD response.
  7363. </exception>
  7364. </member>
  7365. <member name="M:MailKit.Net.Imap.ImapFolder.ExpungeAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)">
  7366. <summary>
  7367. Asynchronously expunge the specified uids, permanently removing them from the folder.
  7368. </summary>
  7369. <remarks>
  7370. <para>Expunges the specified uids, permanently removing them from the folder.</para>
  7371. <para>If the IMAP server supports the UIDPLUS extension (check the
  7372. <see cref="P:MailKit.Net.Imap.ImapClient.Capabilities"/> for the <see cref="F:MailKit.Net.Imap.ImapCapabilities.UidPlus"/>
  7373. flag), then this operation is atomic. Otherwise, MailKit implements this operation
  7374. by first searching for the full list of message uids in the folder that are marked for
  7375. deletion, unmarking the set of message uids that are not within the specified list of
  7376. uids to be be expunged, expunging the folder (thus expunging the requested uids), and
  7377. finally restoring the deleted flag on the collection of message uids that were originally
  7378. marked for deletion that were not included in the list of uids provided. For this reason,
  7379. it is advisable for clients that wish to maintain state to implement this themselves when
  7380. the IMAP server does not support the UIDPLUS extension.</para>
  7381. <para>For more information about the <c>UID EXPUNGE</c> command, see
  7382. <a href="https://tools.ietf.org/html/rfc4315#section-2.1">rfc4315</a>.</para>
  7383. <note type="note">Normally, a <see cref="E:MailKit.MailFolder.MessageExpunged"/> event will be emitted
  7384. for each message that is expunged. However, if the IMAP server supports the QRESYNC extension
  7385. and it has been enabled via the <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/>
  7386. method, then the <see cref="E:MailKit.MailFolder.MessagesVanished"/> event will be emitted rather than
  7387. the <see cref="E:MailKit.MailFolder.MessageExpunged"/> event.</note>
  7388. </remarks>
  7389. <returns>An asynchronous task context.</returns>
  7390. <param name="uids">The message uids.</param>
  7391. <param name="cancellationToken">The cancellation token.</param>
  7392. <exception cref="T:System.ArgumentNullException">
  7393. <paramref name="uids"/> is <c>null</c>.
  7394. </exception>
  7395. <exception cref="T:System.ArgumentException">
  7396. One or more of the <paramref name="uids"/> is invalid.
  7397. </exception>
  7398. <exception cref="T:System.ObjectDisposedException">
  7399. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7400. </exception>
  7401. <exception cref="T:MailKit.ServiceNotConnectedException">
  7402. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7403. </exception>
  7404. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7405. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7406. </exception>
  7407. <exception cref="T:MailKit.FolderNotOpenException">
  7408. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  7409. </exception>
  7410. <exception cref="T:System.OperationCanceledException">
  7411. The operation was canceled via the cancellation token.
  7412. </exception>
  7413. <exception cref="T:System.IO.IOException">
  7414. An I/O error occurred.
  7415. </exception>
  7416. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7417. The server's response contained unexpected tokens.
  7418. </exception>
  7419. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7420. The server replied with a NO or BAD response.
  7421. </exception>
  7422. </member>
  7423. <member name="M:MailKit.Net.Imap.ImapFolder.Append(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  7424. <summary>
  7425. Append the specified message to the folder.
  7426. </summary>
  7427. <remarks>
  7428. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  7429. </remarks>
  7430. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  7431. <param name="options">The formatting options.</param>
  7432. <param name="message">The message.</param>
  7433. <param name="flags">The message flags.</param>
  7434. <param name="cancellationToken">The cancellation token.</param>
  7435. <param name="progress">The progress reporting mechanism.</param>
  7436. <exception cref="T:System.ArgumentNullException">
  7437. <para><paramref name="options"/> is <c>null</c>.</para>
  7438. <para>-or-</para>
  7439. <para><paramref name="message"/> is <c>null</c>.</para>
  7440. </exception>
  7441. <exception cref="T:System.ObjectDisposedException">
  7442. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7443. </exception>
  7444. <exception cref="T:MailKit.ServiceNotConnectedException">
  7445. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7446. </exception>
  7447. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7448. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7449. </exception>
  7450. <exception cref="T:System.InvalidOperationException">
  7451. Internationalized formatting was requested but has not been enabled.
  7452. </exception>
  7453. <exception cref="T:MailKit.FolderNotFoundException">
  7454. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  7455. </exception>
  7456. <exception cref="T:System.OperationCanceledException">
  7457. The operation was canceled via the cancellation token.
  7458. </exception>
  7459. <exception cref="T:System.NotSupportedException">
  7460. Internationalized formatting was requested but is not supported by the server.
  7461. </exception>
  7462. <exception cref="T:System.IO.IOException">
  7463. An I/O error occurred.
  7464. </exception>
  7465. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7466. The server's response contained unexpected tokens.
  7467. </exception>
  7468. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7469. The server replied with a NO or BAD response.
  7470. </exception>
  7471. </member>
  7472. <member name="M:MailKit.Net.Imap.ImapFolder.AppendAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  7473. <summary>
  7474. Asynchronously append the specified message to the folder.
  7475. </summary>
  7476. <remarks>
  7477. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  7478. </remarks>
  7479. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  7480. <param name="options">The formatting options.</param>
  7481. <param name="message">The message.</param>
  7482. <param name="flags">The message flags.</param>
  7483. <param name="cancellationToken">The cancellation token.</param>
  7484. <param name="progress">The progress reporting mechanism.</param>
  7485. <exception cref="T:System.ArgumentNullException">
  7486. <para><paramref name="options"/> is <c>null</c>.</para>
  7487. <para>-or-</para>
  7488. <para><paramref name="message"/> is <c>null</c>.</para>
  7489. </exception>
  7490. <exception cref="T:System.ObjectDisposedException">
  7491. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7492. </exception>
  7493. <exception cref="T:MailKit.ServiceNotConnectedException">
  7494. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7495. </exception>
  7496. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7497. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7498. </exception>
  7499. <exception cref="T:System.InvalidOperationException">
  7500. Internationalized formatting was requested but has not been enabled.
  7501. </exception>
  7502. <exception cref="T:MailKit.FolderNotFoundException">
  7503. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  7504. </exception>
  7505. <exception cref="T:System.OperationCanceledException">
  7506. The operation was canceled via the cancellation token.
  7507. </exception>
  7508. <exception cref="T:System.NotSupportedException">
  7509. Internationalized formatting was requested but is not supported by the server.
  7510. </exception>
  7511. <exception cref="T:System.IO.IOException">
  7512. An I/O error occurred.
  7513. </exception>
  7514. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7515. The server's response contained unexpected tokens.
  7516. </exception>
  7517. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7518. The server replied with a NO or BAD response.
  7519. </exception>
  7520. </member>
  7521. <member name="M:MailKit.Net.Imap.ImapFolder.Append(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.DateTimeOffset,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  7522. <summary>
  7523. Append the specified message to the folder.
  7524. </summary>
  7525. <remarks>
  7526. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  7527. </remarks>
  7528. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  7529. <param name="options">The formatting options.</param>
  7530. <param name="message">The message.</param>
  7531. <param name="flags">The message flags.</param>
  7532. <param name="date">The received date of the message.</param>
  7533. <param name="cancellationToken">The cancellation token.</param>
  7534. <param name="progress">The progress reporting mechanism.</param>
  7535. <exception cref="T:System.ArgumentNullException">
  7536. <para><paramref name="options"/> is <c>null</c>.</para>
  7537. <para>-or-</para>
  7538. <para><paramref name="message"/> is <c>null</c>.</para>
  7539. </exception>
  7540. <exception cref="T:System.ObjectDisposedException">
  7541. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7542. </exception>
  7543. <exception cref="T:MailKit.ServiceNotConnectedException">
  7544. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7545. </exception>
  7546. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7547. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7548. </exception>
  7549. <exception cref="T:System.InvalidOperationException">
  7550. Internationalized formatting was requested but has not been enabled.
  7551. </exception>
  7552. <exception cref="T:MailKit.FolderNotFoundException">
  7553. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  7554. </exception>
  7555. <exception cref="T:System.OperationCanceledException">
  7556. The operation was canceled via the cancellation token.
  7557. </exception>
  7558. <exception cref="T:System.NotSupportedException">
  7559. Internationalized formatting was requested but is not supported by the server.
  7560. </exception>
  7561. <exception cref="T:System.IO.IOException">
  7562. An I/O error occurred.
  7563. </exception>
  7564. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7565. The server's response contained unexpected tokens.
  7566. </exception>
  7567. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7568. The server replied with a NO or BAD response.
  7569. </exception>
  7570. </member>
  7571. <member name="M:MailKit.Net.Imap.ImapFolder.AppendAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.DateTimeOffset,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  7572. <summary>
  7573. Asynchronously append the specified message to the folder.
  7574. </summary>
  7575. <remarks>
  7576. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  7577. </remarks>
  7578. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  7579. <param name="options">The formatting options.</param>
  7580. <param name="message">The message.</param>
  7581. <param name="flags">The message flags.</param>
  7582. <param name="date">The received date of the message.</param>
  7583. <param name="cancellationToken">The cancellation token.</param>
  7584. <param name="progress">The progress reporting mechanism.</param>
  7585. <exception cref="T:System.ArgumentNullException">
  7586. <para><paramref name="options"/> is <c>null</c>.</para>
  7587. <para>-or-</para>
  7588. <para><paramref name="message"/> is <c>null</c>.</para>
  7589. </exception>
  7590. <exception cref="T:System.ObjectDisposedException">
  7591. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7592. </exception>
  7593. <exception cref="T:MailKit.ServiceNotConnectedException">
  7594. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7595. </exception>
  7596. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7597. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7598. </exception>
  7599. <exception cref="T:System.InvalidOperationException">
  7600. Internationalized formatting was requested but has not been enabled.
  7601. </exception>
  7602. <exception cref="T:MailKit.FolderNotFoundException">
  7603. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  7604. </exception>
  7605. <exception cref="T:System.OperationCanceledException">
  7606. The operation was canceled via the cancellation token.
  7607. </exception>
  7608. <exception cref="T:System.NotSupportedException">
  7609. Internationalized formatting was requested but is not supported by the server.
  7610. </exception>
  7611. <exception cref="T:System.IO.IOException">
  7612. An I/O error occurred.
  7613. </exception>
  7614. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7615. The server's response contained unexpected tokens.
  7616. </exception>
  7617. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7618. The server replied with a NO or BAD response.
  7619. </exception>
  7620. </member>
  7621. <member name="M:MailKit.Net.Imap.ImapFolder.Append(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.Nullable{System.DateTimeOffset},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  7622. <summary>
  7623. Append the specified message to the folder.
  7624. </summary>
  7625. <remarks>
  7626. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  7627. </remarks>
  7628. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  7629. <param name="options">The formatting options.</param>
  7630. <param name="message">The message.</param>
  7631. <param name="flags">The message flags.</param>
  7632. <param name="date">The received date of the message.</param>
  7633. <param name="annotations">The message annotations.</param>
  7634. <param name="cancellationToken">The cancellation token.</param>
  7635. <param name="progress">The progress reporting mechanism.</param>
  7636. <exception cref="T:System.ArgumentNullException">
  7637. <para><paramref name="options"/> is <c>null</c>.</para>
  7638. <para>-or-</para>
  7639. <para><paramref name="message"/> is <c>null</c>.</para>
  7640. </exception>
  7641. <exception cref="T:System.ObjectDisposedException">
  7642. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7643. </exception>
  7644. <exception cref="T:MailKit.ServiceNotConnectedException">
  7645. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7646. </exception>
  7647. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7648. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7649. </exception>
  7650. <exception cref="T:System.InvalidOperationException">
  7651. Internationalized formatting was requested but has not been enabled.
  7652. </exception>
  7653. <exception cref="T:MailKit.FolderNotFoundException">
  7654. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  7655. </exception>
  7656. <exception cref="T:System.OperationCanceledException">
  7657. The operation was canceled via the cancellation token.
  7658. </exception>
  7659. <exception cref="T:System.NotSupportedException">
  7660. Internationalized formatting was requested but is not supported by the server.
  7661. </exception>
  7662. <exception cref="T:System.IO.IOException">
  7663. An I/O error occurred.
  7664. </exception>
  7665. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7666. The server's response contained unexpected tokens.
  7667. </exception>
  7668. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7669. The server replied with a NO or BAD response.
  7670. </exception>
  7671. </member>
  7672. <member name="M:MailKit.Net.Imap.ImapFolder.AppendAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.Nullable{System.DateTimeOffset},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  7673. <summary>
  7674. Asynchronously append the specified message to the folder.
  7675. </summary>
  7676. <remarks>
  7677. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  7678. </remarks>
  7679. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  7680. <param name="options">The formatting options.</param>
  7681. <param name="message">The message.</param>
  7682. <param name="flags">The message flags.</param>
  7683. <param name="date">The received date of the message.</param>
  7684. <param name="annotations">The message annotations.</param>
  7685. <param name="cancellationToken">The cancellation token.</param>
  7686. <param name="progress">The progress reporting mechanism.</param>
  7687. <exception cref="T:System.ArgumentNullException">
  7688. <para><paramref name="options"/> is <c>null</c>.</para>
  7689. <para>-or-</para>
  7690. <para><paramref name="message"/> is <c>null</c>.</para>
  7691. </exception>
  7692. <exception cref="T:System.ObjectDisposedException">
  7693. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7694. </exception>
  7695. <exception cref="T:MailKit.ServiceNotConnectedException">
  7696. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7697. </exception>
  7698. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7699. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7700. </exception>
  7701. <exception cref="T:System.InvalidOperationException">
  7702. Internationalized formatting was requested but has not been enabled.
  7703. </exception>
  7704. <exception cref="T:MailKit.FolderNotFoundException">
  7705. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  7706. </exception>
  7707. <exception cref="T:System.OperationCanceledException">
  7708. The operation was canceled via the cancellation token.
  7709. </exception>
  7710. <exception cref="T:System.NotSupportedException">
  7711. Internationalized formatting was requested but is not supported by the server.
  7712. </exception>
  7713. <exception cref="T:System.IO.IOException">
  7714. An I/O error occurred.
  7715. </exception>
  7716. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7717. The server's response contained unexpected tokens.
  7718. </exception>
  7719. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7720. The server replied with a NO or BAD response.
  7721. </exception>
  7722. </member>
  7723. <member name="M:MailKit.Net.Imap.ImapFolder.Append(MimeKit.FormatOptions,System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  7724. <summary>
  7725. Append the specified messages to the folder.
  7726. </summary>
  7727. <remarks>
  7728. Appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  7729. </remarks>
  7730. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  7731. <param name="options">The formatting options.</param>
  7732. <param name="messages">The list of messages to append to the folder.</param>
  7733. <param name="flags">The message flags to use for each message.</param>
  7734. <param name="cancellationToken">The cancellation token.</param>
  7735. <param name="progress">The progress reporting mechanism.</param>
  7736. <exception cref="T:System.ArgumentNullException">
  7737. <para><paramref name="options"/> is <c>null</c>.</para>
  7738. <para>-or-</para>
  7739. <para><paramref name="messages"/> is <c>null</c>.</para>
  7740. <para>-or-</para>
  7741. <para><paramref name="flags"/> is <c>null</c>.</para>
  7742. </exception>
  7743. <exception cref="T:System.ArgumentException">
  7744. <para>One or more of the <paramref name="messages"/> is null.</para>
  7745. <para>-or-</para>
  7746. <para>The number of messages does not match the number of flags.</para>
  7747. </exception>
  7748. <exception cref="T:System.ObjectDisposedException">
  7749. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7750. </exception>
  7751. <exception cref="T:MailKit.ServiceNotConnectedException">
  7752. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7753. </exception>
  7754. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7755. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7756. </exception>
  7757. <exception cref="T:System.InvalidOperationException">
  7758. Internationalized formatting was requested but has not been enabled.
  7759. </exception>
  7760. <exception cref="T:MailKit.FolderNotFoundException">
  7761. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  7762. </exception>
  7763. <exception cref="T:System.OperationCanceledException">
  7764. The operation was canceled via the cancellation token.
  7765. </exception>
  7766. <exception cref="T:System.NotSupportedException">
  7767. Internationalized formatting was requested but is not supported by the server.
  7768. </exception>
  7769. <exception cref="T:System.IO.IOException">
  7770. An I/O error occurred.
  7771. </exception>
  7772. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7773. The server's response contained unexpected tokens.
  7774. </exception>
  7775. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7776. The server replied with a NO or BAD response.
  7777. </exception>
  7778. </member>
  7779. <member name="M:MailKit.Net.Imap.ImapFolder.AppendAsync(MimeKit.FormatOptions,System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  7780. <summary>
  7781. Asynchronously append the specified messages to the folder.
  7782. </summary>
  7783. <remarks>
  7784. Appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  7785. </remarks>
  7786. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  7787. <param name="options">The formatting options.</param>
  7788. <param name="messages">The list of messages to append to the folder.</param>
  7789. <param name="flags">The message flags to use for each message.</param>
  7790. <param name="cancellationToken">The cancellation token.</param>
  7791. <param name="progress">The progress reporting mechanism.</param>
  7792. <exception cref="T:System.ArgumentNullException">
  7793. <para><paramref name="options"/> is <c>null</c>.</para>
  7794. <para>-or-</para>
  7795. <para><paramref name="messages"/> is <c>null</c>.</para>
  7796. <para>-or-</para>
  7797. <para><paramref name="flags"/> is <c>null</c>.</para>
  7798. </exception>
  7799. <exception cref="T:System.ArgumentException">
  7800. <para>One or more of the <paramref name="messages"/> is null.</para>
  7801. <para>-or-</para>
  7802. <para>The number of messages does not match the number of flags.</para>
  7803. </exception>
  7804. <exception cref="T:System.ObjectDisposedException">
  7805. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7806. </exception>
  7807. <exception cref="T:MailKit.ServiceNotConnectedException">
  7808. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7809. </exception>
  7810. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7811. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7812. </exception>
  7813. <exception cref="T:System.InvalidOperationException">
  7814. Internationalized formatting was requested but has not been enabled.
  7815. </exception>
  7816. <exception cref="T:MailKit.FolderNotFoundException">
  7817. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  7818. </exception>
  7819. <exception cref="T:System.OperationCanceledException">
  7820. The operation was canceled via the cancellation token.
  7821. </exception>
  7822. <exception cref="T:System.NotSupportedException">
  7823. Internationalized formatting was requested but is not supported by the server.
  7824. </exception>
  7825. <exception cref="T:System.IO.IOException">
  7826. An I/O error occurred.
  7827. </exception>
  7828. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7829. The server's response contained unexpected tokens.
  7830. </exception>
  7831. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7832. The server replied with a NO or BAD response.
  7833. </exception>
  7834. </member>
  7835. <member name="M:MailKit.Net.Imap.ImapFolder.Append(MimeKit.FormatOptions,System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Collections.Generic.IList{System.DateTimeOffset},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  7836. <summary>
  7837. Append the specified messages to the folder.
  7838. </summary>
  7839. <remarks>
  7840. Appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  7841. </remarks>
  7842. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  7843. <param name="options">The formatting options.</param>
  7844. <param name="messages">The list of messages to append to the folder.</param>
  7845. <param name="flags">The message flags to use for each of the messages.</param>
  7846. <param name="dates">The received dates to use for each of the messages.</param>
  7847. <param name="cancellationToken">The cancellation token.</param>
  7848. <param name="progress">The progress reporting mechanism.</param>
  7849. <exception cref="T:System.ArgumentNullException">
  7850. <para><paramref name="options"/> is <c>null</c>.</para>
  7851. <para>-or-</para>
  7852. <para><paramref name="messages"/> is <c>null</c>.</para>
  7853. <para>-or-</para>
  7854. <para><paramref name="flags"/> is <c>null</c>.</para>
  7855. <para>-or-</para>
  7856. <para><paramref name="dates"/> is <c>null</c>.</para>
  7857. </exception>
  7858. <exception cref="T:System.ArgumentException">
  7859. <para>One or more of the <paramref name="messages"/> is null.</para>
  7860. <para>-or-</para>
  7861. <para>The number of messages, flags, and dates do not match.</para>
  7862. </exception>
  7863. <exception cref="T:System.ObjectDisposedException">
  7864. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7865. </exception>
  7866. <exception cref="T:MailKit.ServiceNotConnectedException">
  7867. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7868. </exception>
  7869. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7870. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7871. </exception>
  7872. <exception cref="T:System.InvalidOperationException">
  7873. Internationalized formatting was requested but has not been enabled.
  7874. </exception>
  7875. <exception cref="T:MailKit.FolderNotFoundException">
  7876. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  7877. </exception>
  7878. <exception cref="T:System.OperationCanceledException">
  7879. The operation was canceled via the cancellation token.
  7880. </exception>
  7881. <exception cref="T:System.NotSupportedException">
  7882. Internationalized formatting was requested but is not supported by the server.
  7883. </exception>
  7884. <exception cref="T:System.IO.IOException">
  7885. An I/O error occurred.
  7886. </exception>
  7887. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7888. The server's response contained unexpected tokens.
  7889. </exception>
  7890. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7891. The server replied with a NO or BAD response.
  7892. </exception>
  7893. </member>
  7894. <member name="M:MailKit.Net.Imap.ImapFolder.AppendAsync(MimeKit.FormatOptions,System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Collections.Generic.IList{System.DateTimeOffset},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  7895. <summary>
  7896. Asynchronously append the specified messages to the folder.
  7897. </summary>
  7898. <remarks>
  7899. Appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  7900. </remarks>
  7901. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  7902. <param name="options">The formatting options.</param>
  7903. <param name="messages">The list of messages to append to the folder.</param>
  7904. <param name="flags">The message flags to use for each of the messages.</param>
  7905. <param name="dates">The received dates to use for each of the messages.</param>
  7906. <param name="cancellationToken">The cancellation token.</param>
  7907. <param name="progress">The progress reporting mechanism.</param>
  7908. <exception cref="T:System.ArgumentNullException">
  7909. <para><paramref name="options"/> is <c>null</c>.</para>
  7910. <para>-or-</para>
  7911. <para><paramref name="messages"/> is <c>null</c>.</para>
  7912. <para>-or-</para>
  7913. <para><paramref name="flags"/> is <c>null</c>.</para>
  7914. <para>-or-</para>
  7915. <para><paramref name="dates"/> is <c>null</c>.</para>
  7916. </exception>
  7917. <exception cref="T:System.ArgumentException">
  7918. <para>One or more of the <paramref name="messages"/> is null.</para>
  7919. <para>-or-</para>
  7920. <para>The number of messages, flags, and dates do not match.</para>
  7921. </exception>
  7922. <exception cref="T:System.ObjectDisposedException">
  7923. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7924. </exception>
  7925. <exception cref="T:MailKit.ServiceNotConnectedException">
  7926. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7927. </exception>
  7928. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7929. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7930. </exception>
  7931. <exception cref="T:System.InvalidOperationException">
  7932. Internationalized formatting was requested but has not been enabled.
  7933. </exception>
  7934. <exception cref="T:MailKit.FolderNotFoundException">
  7935. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not exist.
  7936. </exception>
  7937. <exception cref="T:System.OperationCanceledException">
  7938. The operation was canceled via the cancellation token.
  7939. </exception>
  7940. <exception cref="T:System.NotSupportedException">
  7941. Internationalized formatting was requested but is not supported by the server.
  7942. </exception>
  7943. <exception cref="T:System.IO.IOException">
  7944. An I/O error occurred.
  7945. </exception>
  7946. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7947. The server's response contained unexpected tokens.
  7948. </exception>
  7949. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  7950. The server replied with a NO or BAD response.
  7951. </exception>
  7952. </member>
  7953. <member name="M:MailKit.Net.Imap.ImapFolder.CopyTo(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.IMailFolder,System.Threading.CancellationToken)">
  7954. <summary>
  7955. Copy the specified messages to the destination folder.
  7956. </summary>
  7957. <remarks>
  7958. Copies the specified messages to the destination folder.
  7959. </remarks>
  7960. <returns>The UID mapping of the messages in the destination folder, if available; otherwise an empty mapping.</returns>
  7961. <param name="uids">The UIDs of the messages to copy.</param>
  7962. <param name="destination">The destination folder.</param>
  7963. <param name="cancellationToken">The cancellation token.</param>
  7964. <exception cref="T:System.ArgumentNullException">
  7965. <para><paramref name="uids"/> is <c>null</c>.</para>
  7966. <para>-or-</para>
  7967. <para><paramref name="destination"/> is <c>null</c>.</para>
  7968. </exception>
  7969. <exception cref="T:System.ArgumentException">
  7970. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  7971. <para>-or-</para>
  7972. <para>The destination folder does not belong to the <see cref="T:MailKit.Net.Imap.ImapClient"/>.</para>
  7973. </exception>
  7974. <exception cref="T:System.ObjectDisposedException">
  7975. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  7976. </exception>
  7977. <exception cref="T:MailKit.ServiceNotConnectedException">
  7978. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  7979. </exception>
  7980. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  7981. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  7982. </exception>
  7983. <exception cref="T:MailKit.FolderNotFoundException">
  7984. <paramref name="destination"/> does not exist.
  7985. </exception>
  7986. <exception cref="T:MailKit.FolderNotOpenException">
  7987. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  7988. </exception>
  7989. <exception cref="T:System.NotSupportedException">
  7990. The IMAP server does not support the UIDPLUS extension.
  7991. </exception>
  7992. <exception cref="T:System.OperationCanceledException">
  7993. The operation was canceled via the cancellation token.
  7994. </exception>
  7995. <exception cref="T:System.IO.IOException">
  7996. An I/O error occurred.
  7997. </exception>
  7998. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  7999. The server's response contained unexpected tokens.
  8000. </exception>
  8001. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8002. The server replied with a NO or BAD response.
  8003. </exception>
  8004. </member>
  8005. <member name="M:MailKit.Net.Imap.ImapFolder.CopyToAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.IMailFolder,System.Threading.CancellationToken)">
  8006. <summary>
  8007. Asynchronously copy the specified messages to the destination folder.
  8008. </summary>
  8009. <remarks>
  8010. Copies the specified messages to the destination folder.
  8011. </remarks>
  8012. <returns>The UID mapping of the messages in the destination folder, if available; otherwise an empty mapping.</returns>
  8013. <param name="uids">The UIDs of the messages to copy.</param>
  8014. <param name="destination">The destination folder.</param>
  8015. <param name="cancellationToken">The cancellation token.</param>
  8016. <exception cref="T:System.ArgumentNullException">
  8017. <para><paramref name="uids"/> is <c>null</c>.</para>
  8018. <para>-or-</para>
  8019. <para><paramref name="destination"/> is <c>null</c>.</para>
  8020. </exception>
  8021. <exception cref="T:System.ArgumentException">
  8022. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  8023. <para>-or-</para>
  8024. <para>The destination folder does not belong to the <see cref="T:MailKit.Net.Imap.ImapClient"/>.</para>
  8025. </exception>
  8026. <exception cref="T:System.ObjectDisposedException">
  8027. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8028. </exception>
  8029. <exception cref="T:MailKit.ServiceNotConnectedException">
  8030. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8031. </exception>
  8032. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8033. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8034. </exception>
  8035. <exception cref="T:MailKit.FolderNotFoundException">
  8036. <paramref name="destination"/> does not exist.
  8037. </exception>
  8038. <exception cref="T:MailKit.FolderNotOpenException">
  8039. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  8040. </exception>
  8041. <exception cref="T:System.NotSupportedException">
  8042. The IMAP server does not support the UIDPLUS extension.
  8043. </exception>
  8044. <exception cref="T:System.OperationCanceledException">
  8045. The operation was canceled via the cancellation token.
  8046. </exception>
  8047. <exception cref="T:System.IO.IOException">
  8048. An I/O error occurred.
  8049. </exception>
  8050. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8051. The server's response contained unexpected tokens.
  8052. </exception>
  8053. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8054. The server replied with a NO or BAD response.
  8055. </exception>
  8056. </member>
  8057. <member name="M:MailKit.Net.Imap.ImapFolder.MoveTo(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.IMailFolder,System.Threading.CancellationToken)">
  8058. <summary>
  8059. Move the specified messages to the destination folder.
  8060. </summary>
  8061. <remarks>
  8062. <para>Moves the specified messages to the destination folder.</para>
  8063. <para>If the IMAP server supports the MOVE extension (check the <see cref="P:MailKit.Net.Imap.ImapClient.Capabilities"/>
  8064. property for the <see cref="F:MailKit.Net.Imap.ImapCapabilities.Move"/> flag), then this operation will be atomic.
  8065. Otherwise, MailKit implements this by first copying the messages to the destination folder, then
  8066. marking them for deletion in the originating folder, and finally expunging them (see
  8067. <see cref="M:MailKit.Net.Imap.ImapFolder.Expunge(System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)"/> for more information about how a
  8068. subset of messages are expunged). Since the server could disconnect at any point between those 3
  8069. (or more) commands, it is advisable for clients to implement their own logic for moving messages when
  8070. the IMAP server does not support the MOVE command in order to better handle spontanious server
  8071. disconnects and other error conditions.</para>
  8072. </remarks>
  8073. <returns>The UID mapping of the messages in the destination folder, if available; otherwise an empty mapping.</returns>
  8074. <param name="uids">The UIDs of the messages to move.</param>
  8075. <param name="destination">The destination folder.</param>
  8076. <param name="cancellationToken">The cancellation token.</param>
  8077. <exception cref="T:System.ArgumentNullException">
  8078. <para><paramref name="uids"/> is <c>null</c>.</para>
  8079. <para>-or-</para>
  8080. <para><paramref name="destination"/> is <c>null</c>.</para>
  8081. </exception>
  8082. <exception cref="T:System.ArgumentException">
  8083. <para><paramref name="uids"/> is empty.</para>
  8084. <para>-or-</para>
  8085. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  8086. <para>-or-</para>
  8087. <para>The destination folder does not belong to the <see cref="T:MailKit.Net.Imap.ImapClient"/>.</para>
  8088. </exception>
  8089. <exception cref="T:System.ObjectDisposedException">
  8090. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8091. </exception>
  8092. <exception cref="T:MailKit.ServiceNotConnectedException">
  8093. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8094. </exception>
  8095. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8096. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8097. </exception>
  8098. <exception cref="T:MailKit.FolderNotFoundException">
  8099. <paramref name="destination"/> does not exist.
  8100. </exception>
  8101. <exception cref="T:MailKit.FolderNotOpenException">
  8102. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  8103. </exception>
  8104. <exception cref="T:System.OperationCanceledException">
  8105. The operation was canceled via the cancellation token.
  8106. </exception>
  8107. <exception cref="T:System.IO.IOException">
  8108. An I/O error occurred.
  8109. </exception>
  8110. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8111. The server's response contained unexpected tokens.
  8112. </exception>
  8113. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8114. The server replied with a NO or BAD response.
  8115. </exception>
  8116. </member>
  8117. <member name="M:MailKit.Net.Imap.ImapFolder.MoveToAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.IMailFolder,System.Threading.CancellationToken)">
  8118. <summary>
  8119. Asynchronously move the specified messages to the destination folder.
  8120. </summary>
  8121. <remarks>
  8122. <para>Moves the specified messages to the destination folder.</para>
  8123. <para>If the IMAP server supports the MOVE extension (check the <see cref="P:MailKit.Net.Imap.ImapClient.Capabilities"/>
  8124. property for the <see cref="F:MailKit.Net.Imap.ImapCapabilities.Move"/> flag), then this operation will be atomic.
  8125. Otherwise, MailKit implements this by first copying the messages to the destination folder, then
  8126. marking them for deletion in the originating folder, and finally expunging them (see
  8127. <see cref="M:MailKit.Net.Imap.ImapFolder.Expunge(System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)"/> for more information about how a
  8128. subset of messages are expunged). Since the server could disconnect at any point between those 3
  8129. (or more) commands, it is advisable for clients to implement their own logic for moving messages when
  8130. the IMAP server does not support the MOVE command in order to better handle spontanious server
  8131. disconnects and other error conditions.</para>
  8132. </remarks>
  8133. <returns>The UID mapping of the messages in the destination folder, if available; otherwise an empty mapping.</returns>
  8134. <param name="uids">The UIDs of the messages to move.</param>
  8135. <param name="destination">The destination folder.</param>
  8136. <param name="cancellationToken">The cancellation token.</param>
  8137. <exception cref="T:System.ArgumentNullException">
  8138. <para><paramref name="uids"/> is <c>null</c>.</para>
  8139. <para>-or-</para>
  8140. <para><paramref name="destination"/> is <c>null</c>.</para>
  8141. </exception>
  8142. <exception cref="T:System.ArgumentException">
  8143. <para><paramref name="uids"/> is empty.</para>
  8144. <para>-or-</para>
  8145. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  8146. <para>-or-</para>
  8147. <para>The destination folder does not belong to the <see cref="T:MailKit.Net.Imap.ImapClient"/>.</para>
  8148. </exception>
  8149. <exception cref="T:System.ObjectDisposedException">
  8150. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8151. </exception>
  8152. <exception cref="T:MailKit.ServiceNotConnectedException">
  8153. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8154. </exception>
  8155. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8156. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8157. </exception>
  8158. <exception cref="T:MailKit.FolderNotFoundException">
  8159. <paramref name="destination"/> does not exist.
  8160. </exception>
  8161. <exception cref="T:MailKit.FolderNotOpenException">
  8162. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  8163. </exception>
  8164. <exception cref="T:System.OperationCanceledException">
  8165. The operation was canceled via the cancellation token.
  8166. </exception>
  8167. <exception cref="T:System.IO.IOException">
  8168. An I/O error occurred.
  8169. </exception>
  8170. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8171. The server's response contained unexpected tokens.
  8172. </exception>
  8173. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8174. The server replied with a NO or BAD response.
  8175. </exception>
  8176. </member>
  8177. <member name="M:MailKit.Net.Imap.ImapFolder.CopyTo(System.Collections.Generic.IList{System.Int32},MailKit.IMailFolder,System.Threading.CancellationToken)">
  8178. <summary>
  8179. Copy the specified messages to the destination folder.
  8180. </summary>
  8181. <remarks>
  8182. Copies the specified messages to the destination folder.
  8183. </remarks>
  8184. <param name="indexes">The indexes of the messages to copy.</param>
  8185. <param name="destination">The destination folder.</param>
  8186. <param name="cancellationToken">The cancellation token.</param>
  8187. <exception cref="T:System.ArgumentNullException">
  8188. <para><paramref name="indexes"/> is <c>null</c>.</para>
  8189. <para>-or-</para>
  8190. <para><paramref name="destination"/> is <c>null</c>.</para>
  8191. </exception>
  8192. <exception cref="T:System.ArgumentException">
  8193. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  8194. <para>-or-</para>
  8195. <para>The destination folder does not belong to the <see cref="T:MailKit.Net.Imap.ImapClient"/>.</para>
  8196. </exception>
  8197. <exception cref="T:System.ObjectDisposedException">
  8198. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8199. </exception>
  8200. <exception cref="T:MailKit.FolderNotOpenException">
  8201. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  8202. </exception>
  8203. <exception cref="T:MailKit.ServiceNotConnectedException">
  8204. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8205. </exception>
  8206. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8207. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8208. </exception>
  8209. <exception cref="T:MailKit.FolderNotFoundException">
  8210. <paramref name="destination"/> does not exist.
  8211. </exception>
  8212. <exception cref="T:MailKit.FolderNotOpenException">
  8213. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  8214. </exception>
  8215. <exception cref="T:System.OperationCanceledException">
  8216. The operation was canceled via the cancellation token.
  8217. </exception>
  8218. <exception cref="T:System.IO.IOException">
  8219. An I/O error occurred.
  8220. </exception>
  8221. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8222. The server's response contained unexpected tokens.
  8223. </exception>
  8224. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8225. The server replied with a NO or BAD response.
  8226. </exception>
  8227. </member>
  8228. <member name="M:MailKit.Net.Imap.ImapFolder.CopyToAsync(System.Collections.Generic.IList{System.Int32},MailKit.IMailFolder,System.Threading.CancellationToken)">
  8229. <summary>
  8230. Asynchronously copy the specified messages to the destination folder.
  8231. </summary>
  8232. <remarks>
  8233. Copies the specified messages to the destination folder.
  8234. </remarks>
  8235. <returns>An awaitable task.</returns>
  8236. <param name="indexes">The indexes of the messages to copy.</param>
  8237. <param name="destination">The destination folder.</param>
  8238. <param name="cancellationToken">The cancellation token.</param>
  8239. <exception cref="T:System.ArgumentNullException">
  8240. <para><paramref name="indexes"/> is <c>null</c>.</para>
  8241. <para>-or-</para>
  8242. <para><paramref name="destination"/> is <c>null</c>.</para>
  8243. </exception>
  8244. <exception cref="T:System.ArgumentException">
  8245. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  8246. <para>-or-</para>
  8247. <para>The destination folder does not belong to the <see cref="T:MailKit.Net.Imap.ImapClient"/>.</para>
  8248. </exception>
  8249. <exception cref="T:System.ObjectDisposedException">
  8250. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8251. </exception>
  8252. <exception cref="T:MailKit.FolderNotOpenException">
  8253. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  8254. </exception>
  8255. <exception cref="T:MailKit.ServiceNotConnectedException">
  8256. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8257. </exception>
  8258. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8259. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8260. </exception>
  8261. <exception cref="T:MailKit.FolderNotFoundException">
  8262. <paramref name="destination"/> does not exist.
  8263. </exception>
  8264. <exception cref="T:MailKit.FolderNotOpenException">
  8265. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  8266. </exception>
  8267. <exception cref="T:System.OperationCanceledException">
  8268. The operation was canceled via the cancellation token.
  8269. </exception>
  8270. <exception cref="T:System.IO.IOException">
  8271. An I/O error occurred.
  8272. </exception>
  8273. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8274. The server's response contained unexpected tokens.
  8275. </exception>
  8276. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8277. The server replied with a NO or BAD response.
  8278. </exception>
  8279. </member>
  8280. <member name="M:MailKit.Net.Imap.ImapFolder.MoveTo(System.Collections.Generic.IList{System.Int32},MailKit.IMailFolder,System.Threading.CancellationToken)">
  8281. <summary>
  8282. Move the specified messages to the destination folder.
  8283. </summary>
  8284. <remarks>
  8285. <para>If the IMAP server supports the MOVE command, then the MOVE command will be used. Otherwise,
  8286. the messages will first be copied to the destination folder and then marked as \Deleted in the
  8287. originating folder. Since the server could disconnect at any point between those 2 operations, it
  8288. may be advisable to implement your own logic for moving messages in this case in order to better
  8289. handle spontanious server disconnects and other error conditions.</para>
  8290. </remarks>
  8291. <param name="indexes">The indexes of the messages to move.</param>
  8292. <param name="destination">The destination folder.</param>
  8293. <param name="cancellationToken">The cancellation token.</param>
  8294. <exception cref="T:System.ArgumentNullException">
  8295. <para><paramref name="indexes"/> is <c>null</c>.</para>
  8296. <para>-or-</para>
  8297. <para><paramref name="destination"/> is <c>null</c>.</para>
  8298. </exception>
  8299. <exception cref="T:System.ArgumentException">
  8300. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  8301. <para>-or-</para>
  8302. <para>The destination folder does not belong to the <see cref="T:MailKit.Net.Imap.ImapClient"/>.</para>
  8303. </exception>
  8304. <exception cref="T:System.ObjectDisposedException">
  8305. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8306. </exception>
  8307. <exception cref="T:MailKit.ServiceNotConnectedException">
  8308. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8309. </exception>
  8310. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8311. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8312. </exception>
  8313. <exception cref="T:MailKit.FolderNotFoundException">
  8314. <paramref name="destination"/> does not exist.
  8315. </exception>
  8316. <exception cref="T:MailKit.FolderNotOpenException">
  8317. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  8318. </exception>
  8319. <exception cref="T:System.OperationCanceledException">
  8320. The operation was canceled via the cancellation token.
  8321. </exception>
  8322. <exception cref="T:System.IO.IOException">
  8323. An I/O error occurred.
  8324. </exception>
  8325. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8326. The server's response contained unexpected tokens.
  8327. </exception>
  8328. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8329. The server replied with a NO or BAD response.
  8330. </exception>
  8331. </member>
  8332. <member name="M:MailKit.Net.Imap.ImapFolder.MoveToAsync(System.Collections.Generic.IList{System.Int32},MailKit.IMailFolder,System.Threading.CancellationToken)">
  8333. <summary>
  8334. Asynchronously move the specified messages to the destination folder.
  8335. </summary>
  8336. <remarks>
  8337. <para>If the IMAP server supports the MOVE command, then the MOVE command will be used. Otherwise,
  8338. the messages will first be copied to the destination folder and then marked as \Deleted in the
  8339. originating folder. Since the server could disconnect at any point between those 2 operations, it
  8340. may be advisable to implement your own logic for moving messages in this case in order to better
  8341. handle spontanious server disconnects and other error conditions.</para>
  8342. </remarks>
  8343. <returns>An awaitable task.</returns>
  8344. <param name="indexes">The indexes of the messages to move.</param>
  8345. <param name="destination">The destination folder.</param>
  8346. <param name="cancellationToken">The cancellation token.</param>
  8347. <exception cref="T:System.ArgumentNullException">
  8348. <para><paramref name="indexes"/> is <c>null</c>.</para>
  8349. <para>-or-</para>
  8350. <para><paramref name="destination"/> is <c>null</c>.</para>
  8351. </exception>
  8352. <exception cref="T:System.ArgumentException">
  8353. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  8354. <para>-or-</para>
  8355. <para>The destination folder does not belong to the <see cref="T:MailKit.Net.Imap.ImapClient"/>.</para>
  8356. </exception>
  8357. <exception cref="T:System.ObjectDisposedException">
  8358. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8359. </exception>
  8360. <exception cref="T:MailKit.ServiceNotConnectedException">
  8361. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8362. </exception>
  8363. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8364. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8365. </exception>
  8366. <exception cref="T:MailKit.FolderNotFoundException">
  8367. <paramref name="destination"/> does not exist.
  8368. </exception>
  8369. <exception cref="T:MailKit.FolderNotOpenException">
  8370. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  8371. </exception>
  8372. <exception cref="T:System.OperationCanceledException">
  8373. The operation was canceled via the cancellation token.
  8374. </exception>
  8375. <exception cref="T:System.IO.IOException">
  8376. An I/O error occurred.
  8377. </exception>
  8378. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8379. The server's response contained unexpected tokens.
  8380. </exception>
  8381. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8382. The server replied with a NO or BAD response.
  8383. </exception>
  8384. </member>
  8385. <member name="M:MailKit.Net.Imap.ImapFolder.GetEnumerator">
  8386. <summary>
  8387. Get an enumerator for the messages in the folder.
  8388. </summary>
  8389. <remarks>
  8390. Gets an enumerator for the messages in the folder.
  8391. </remarks>
  8392. <returns>The enumerator.</returns>
  8393. <exception cref="T:System.ObjectDisposedException">
  8394. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8395. </exception>
  8396. <exception cref="T:MailKit.ServiceNotConnectedException">
  8397. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8398. </exception>
  8399. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8400. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8401. </exception>
  8402. <exception cref="T:MailKit.FolderNotOpenException">
  8403. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  8404. </exception>
  8405. </member>
  8406. <member name="M:MailKit.Net.Imap.ImapFolder.Store(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  8407. <summary>
  8408. Store the annotations for the specified messages.
  8409. </summary>
  8410. <remarks>
  8411. Stores the annotations for the specified messages.
  8412. </remarks>
  8413. <param name="uids">The UIDs of the messages.</param>
  8414. <param name="annotations">The annotations to store.</param>
  8415. <param name="cancellationToken">The cancellation token.</param>
  8416. <exception cref="T:System.ArgumentNullException">
  8417. <para><paramref name="uids"/> is <c>null</c>.</para>
  8418. <para>-or-</para>
  8419. <para><paramref name="annotations"/> is <c>null</c>.</para>
  8420. </exception>
  8421. <exception cref="T:System.ArgumentException">
  8422. One or more of the <paramref name="uids"/> is invalid.
  8423. </exception>
  8424. <exception cref="T:System.ObjectDisposedException">
  8425. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8426. </exception>
  8427. <exception cref="T:MailKit.ServiceNotConnectedException">
  8428. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8429. </exception>
  8430. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8431. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8432. </exception>
  8433. <exception cref="T:MailKit.FolderNotOpenException">
  8434. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  8435. </exception>
  8436. <exception cref="T:System.InvalidOperationException">
  8437. Cannot store annotations without any properties defined.
  8438. </exception>
  8439. <exception cref="T:System.NotSupportedException">
  8440. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support annotations.
  8441. </exception>
  8442. <exception cref="T:System.OperationCanceledException">
  8443. The operation was canceled via the cancellation token.
  8444. </exception>
  8445. <exception cref="T:System.IO.IOException">
  8446. An I/O error occurred.
  8447. </exception>
  8448. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8449. The server's response contained unexpected tokens.
  8450. </exception>
  8451. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8452. The server replied with a NO or BAD response.
  8453. </exception>
  8454. </member>
  8455. <member name="M:MailKit.Net.Imap.ImapFolder.StoreAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  8456. <summary>
  8457. Asynchronously store the annotations for the specified messages.
  8458. </summary>
  8459. <remarks>
  8460. Asynchronously stores the annotations for the specified messages.
  8461. </remarks>
  8462. <returns>An asynchronous task context.</returns>
  8463. <param name="uids">The UIDs of the messages.</param>
  8464. <param name="annotations">The annotations to store.</param>
  8465. <param name="cancellationToken">The cancellation token.</param>
  8466. <exception cref="T:System.ArgumentNullException">
  8467. <para><paramref name="uids"/> is <c>null</c>.</para>
  8468. <para>-or-</para>
  8469. <para><paramref name="annotations"/> is <c>null</c>.</para>
  8470. </exception>
  8471. <exception cref="T:System.ArgumentException">
  8472. One or more of the <paramref name="uids"/> is invalid.
  8473. </exception>
  8474. <exception cref="T:System.ObjectDisposedException">
  8475. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8476. </exception>
  8477. <exception cref="T:MailKit.ServiceNotConnectedException">
  8478. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8479. </exception>
  8480. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8481. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8482. </exception>
  8483. <exception cref="T:MailKit.FolderNotOpenException">
  8484. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  8485. </exception>
  8486. <exception cref="T:System.InvalidOperationException">
  8487. Cannot store annotations without any properties defined.
  8488. </exception>
  8489. <exception cref="T:System.NotSupportedException">
  8490. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support annotations.
  8491. </exception>
  8492. <exception cref="T:System.OperationCanceledException">
  8493. The operation was canceled via the cancellation token.
  8494. </exception>
  8495. <exception cref="T:System.IO.IOException">
  8496. An I/O error occurred.
  8497. </exception>
  8498. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8499. The server's response contained unexpected tokens.
  8500. </exception>
  8501. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8502. The server replied with a NO or BAD response.
  8503. </exception>
  8504. </member>
  8505. <member name="M:MailKit.Net.Imap.ImapFolder.Store(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  8506. <summary>
  8507. Store the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  8508. </summary>
  8509. <remarks>
  8510. Stores the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  8511. </remarks>
  8512. <returns>The unique IDs of the messages that were not updated.</returns>
  8513. <param name="uids">The UIDs of the messages.</param>
  8514. <param name="modseq">The mod-sequence value.</param>
  8515. <param name="annotations">The annotations to store.</param>
  8516. <param name="cancellationToken">The cancellation token.</param>
  8517. <exception cref="T:System.ArgumentNullException">
  8518. <para><paramref name="uids"/> is <c>null</c>.</para>
  8519. <para>-or-</para>
  8520. <para><paramref name="annotations"/> is <c>null</c>.</para>
  8521. </exception>
  8522. <exception cref="T:System.ArgumentException">
  8523. One or more of the <paramref name="uids"/> is invalid.
  8524. </exception>
  8525. <exception cref="T:System.ObjectDisposedException">
  8526. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8527. </exception>
  8528. <exception cref="T:MailKit.ServiceNotConnectedException">
  8529. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8530. </exception>
  8531. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8532. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8533. </exception>
  8534. <exception cref="T:MailKit.FolderNotOpenException">
  8535. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  8536. </exception>
  8537. <exception cref="T:System.InvalidOperationException">
  8538. Cannot store annotations without any properties defined.
  8539. </exception>
  8540. <exception cref="T:System.NotSupportedException">
  8541. <para>The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support annotations.</para>
  8542. <para>-or-</para>
  8543. <para>The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.</para>
  8544. </exception>
  8545. <exception cref="T:System.OperationCanceledException">
  8546. The operation was canceled via the cancellation token.
  8547. </exception>
  8548. <exception cref="T:System.IO.IOException">
  8549. An I/O error occurred.
  8550. </exception>
  8551. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8552. The server's response contained unexpected tokens.
  8553. </exception>
  8554. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8555. The server replied with a NO or BAD response.
  8556. </exception>
  8557. </member>
  8558. <member name="M:MailKit.Net.Imap.ImapFolder.StoreAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  8559. <summary>
  8560. Asynchronously store the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  8561. </summary>
  8562. <remarks>
  8563. Asynchronously stores the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  8564. </remarks>
  8565. <returns>The unique IDs of the messages that were not updated.</returns>
  8566. <param name="uids">The UIDs of the messages.</param>
  8567. <param name="modseq">The mod-sequence value.</param>
  8568. <param name="annotations">The annotations to store.</param>
  8569. <param name="cancellationToken">The cancellation token.</param>
  8570. <exception cref="T:System.ArgumentNullException">
  8571. <para><paramref name="uids"/> is <c>null</c>.</para>
  8572. <para>-or-</para>
  8573. <para><paramref name="annotations"/> is <c>null</c>.</para>
  8574. </exception>
  8575. <exception cref="T:System.ArgumentException">
  8576. One or more of the <paramref name="uids"/> is invalid.
  8577. </exception>
  8578. <exception cref="T:System.ObjectDisposedException">
  8579. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8580. </exception>
  8581. <exception cref="T:MailKit.ServiceNotConnectedException">
  8582. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8583. </exception>
  8584. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8585. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8586. </exception>
  8587. <exception cref="T:MailKit.FolderNotOpenException">
  8588. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  8589. </exception>
  8590. <exception cref="T:System.InvalidOperationException">
  8591. Cannot store annotations without any properties defined.
  8592. </exception>
  8593. <exception cref="T:System.NotSupportedException">
  8594. <para>The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support annotations.</para>
  8595. <para>-or-</para>
  8596. <para>The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.</para>
  8597. </exception>
  8598. <exception cref="T:System.OperationCanceledException">
  8599. The operation was canceled via the cancellation token.
  8600. </exception>
  8601. <exception cref="T:System.IO.IOException">
  8602. An I/O error occurred.
  8603. </exception>
  8604. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8605. The server's response contained unexpected tokens.
  8606. </exception>
  8607. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8608. The server replied with a NO or BAD response.
  8609. </exception>
  8610. </member>
  8611. <member name="M:MailKit.Net.Imap.ImapFolder.Store(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  8612. <summary>
  8613. Store the annotations for the specified messages.
  8614. </summary>
  8615. <remarks>
  8616. Stores the annotations for the specified messages.
  8617. </remarks>
  8618. <param name="indexes">The indexes of the messages.</param>
  8619. <param name="annotations">The annotations to store.</param>
  8620. <param name="cancellationToken">The cancellation token.</param>
  8621. <exception cref="T:System.ArgumentNullException">
  8622. <para><paramref name="indexes"/> is <c>null</c>.</para>
  8623. <para>-or-</para>
  8624. <para><paramref name="annotations"/> is <c>null</c>.</para>
  8625. </exception>
  8626. <exception cref="T:System.ArgumentException">
  8627. One or more of the <paramref name="indexes"/> is invalid.
  8628. </exception>
  8629. <exception cref="T:System.ObjectDisposedException">
  8630. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8631. </exception>
  8632. <exception cref="T:MailKit.ServiceNotConnectedException">
  8633. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8634. </exception>
  8635. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8636. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8637. </exception>
  8638. <exception cref="T:MailKit.FolderNotOpenException">
  8639. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  8640. </exception>
  8641. <exception cref="T:System.InvalidOperationException">
  8642. Cannot store annotations without any properties defined.
  8643. </exception>
  8644. <exception cref="T:System.NotSupportedException">
  8645. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support annotations.
  8646. </exception>
  8647. <exception cref="T:System.OperationCanceledException">
  8648. The operation was canceled via the cancellation token.
  8649. </exception>
  8650. <exception cref="T:System.IO.IOException">
  8651. An I/O error occurred.
  8652. </exception>
  8653. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8654. The server's response contained unexpected tokens.
  8655. </exception>
  8656. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8657. The server replied with a NO or BAD response.
  8658. </exception>
  8659. </member>
  8660. <member name="M:MailKit.Net.Imap.ImapFolder.StoreAsync(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  8661. <summary>
  8662. Asynchronously store the annotations for the specified messages.
  8663. </summary>
  8664. <remarks>
  8665. Asynchronously stores the annotations for the specified messages.
  8666. </remarks>
  8667. <returns>An asynchronous task context.</returns>
  8668. <param name="indexes">The indexes of the messages.</param>
  8669. <param name="annotations">The annotations to store.</param>
  8670. <param name="cancellationToken">The cancellation token.</param>
  8671. <exception cref="T:System.ArgumentNullException">
  8672. <para><paramref name="indexes"/> is <c>null</c>.</para>
  8673. <para>-or-</para>
  8674. <para><paramref name="annotations"/> is <c>null</c>.</para>
  8675. </exception>
  8676. <exception cref="T:System.ArgumentException">
  8677. One or more of the <paramref name="indexes"/> is invalid.
  8678. </exception>
  8679. <exception cref="T:System.ObjectDisposedException">
  8680. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8681. </exception>
  8682. <exception cref="T:MailKit.ServiceNotConnectedException">
  8683. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8684. </exception>
  8685. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8686. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8687. </exception>
  8688. <exception cref="T:MailKit.FolderNotOpenException">
  8689. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  8690. </exception>
  8691. <exception cref="T:System.InvalidOperationException">
  8692. Cannot store annotations without any properties defined.
  8693. </exception>
  8694. <exception cref="T:System.NotSupportedException">
  8695. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support annotations.
  8696. </exception>
  8697. <exception cref="T:System.OperationCanceledException">
  8698. The operation was canceled via the cancellation token.
  8699. </exception>
  8700. <exception cref="T:System.IO.IOException">
  8701. An I/O error occurred.
  8702. </exception>
  8703. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8704. The server's response contained unexpected tokens.
  8705. </exception>
  8706. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8707. The server replied with a NO or BAD response.
  8708. </exception>
  8709. </member>
  8710. <member name="M:MailKit.Net.Imap.ImapFolder.Store(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  8711. <summary>
  8712. Store the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  8713. </summary>
  8714. <remarks>
  8715. Stores the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  8716. </remarks>
  8717. <returns>The indexes of the messages that were not updated.</returns>
  8718. <param name="indexes">The indexes of the messages.</param>
  8719. <param name="modseq">The mod-sequence value.</param>
  8720. <param name="annotations">The annotations to store.</param>
  8721. <param name="cancellationToken">The cancellation token.</param>
  8722. <exception cref="T:System.ArgumentNullException">
  8723. <para><paramref name="indexes"/> is <c>null</c>.</para>
  8724. <para>-or-</para>
  8725. <para><paramref name="annotations"/> is <c>null</c>.</para>
  8726. </exception>
  8727. <exception cref="T:System.ArgumentException">
  8728. One or more of the <paramref name="indexes"/> is invalid.
  8729. </exception>
  8730. <exception cref="T:System.ObjectDisposedException">
  8731. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8732. </exception>
  8733. <exception cref="T:MailKit.ServiceNotConnectedException">
  8734. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8735. </exception>
  8736. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8737. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8738. </exception>
  8739. <exception cref="T:MailKit.FolderNotOpenException">
  8740. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  8741. </exception>
  8742. <exception cref="T:System.InvalidOperationException">
  8743. Cannot store annotations without any properties defined.
  8744. </exception>
  8745. <exception cref="T:System.NotSupportedException">
  8746. <para>The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support annotations.</para>
  8747. <para>-or-</para>
  8748. <para>The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.</para>
  8749. </exception>
  8750. <exception cref="T:System.OperationCanceledException">
  8751. The operation was canceled via the cancellation token.
  8752. </exception>
  8753. <exception cref="T:System.IO.IOException">
  8754. An I/O error occurred.
  8755. </exception>
  8756. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8757. The server's response contained unexpected tokens.
  8758. </exception>
  8759. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8760. The server replied with a NO or BAD response.
  8761. </exception>
  8762. </member>
  8763. <member name="M:MailKit.Net.Imap.ImapFolder.StoreAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  8764. <summary>
  8765. Asynchronously store the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  8766. </summary>
  8767. <remarks>
  8768. Asynchronously stores the annotations for the specified messages only if their mod-sequence value is less than the specified value.s
  8769. </remarks>
  8770. <returns>The indexes of the messages that were not updated.</returns>
  8771. <param name="indexes">The indexes of the messages.</param>
  8772. <param name="modseq">The mod-sequence value.</param>
  8773. <param name="annotations">The annotations to store.</param>
  8774. <param name="cancellationToken">The cancellation token.</param>
  8775. <exception cref="T:System.ArgumentNullException">
  8776. <para><paramref name="indexes"/> is <c>null</c>.</para>
  8777. <para>-or-</para>
  8778. <para><paramref name="annotations"/> is <c>null</c>.</para>
  8779. </exception>
  8780. <exception cref="T:System.ArgumentException">
  8781. One or more of the <paramref name="indexes"/> is invalid.
  8782. </exception>
  8783. <exception cref="T:System.ObjectDisposedException">
  8784. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8785. </exception>
  8786. <exception cref="T:MailKit.ServiceNotConnectedException">
  8787. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8788. </exception>
  8789. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8790. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8791. </exception>
  8792. <exception cref="T:MailKit.FolderNotOpenException">
  8793. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  8794. </exception>
  8795. <exception cref="T:System.InvalidOperationException">
  8796. Cannot store annotations without any properties defined.
  8797. </exception>
  8798. <exception cref="T:System.NotSupportedException">
  8799. <para>The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support annotations.</para>
  8800. <para>-or-</para>
  8801. <para>The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.</para>
  8802. </exception>
  8803. <exception cref="T:System.OperationCanceledException">
  8804. The operation was canceled via the cancellation token.
  8805. </exception>
  8806. <exception cref="T:System.IO.IOException">
  8807. An I/O error occurred.
  8808. </exception>
  8809. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8810. The server's response contained unexpected tokens.
  8811. </exception>
  8812. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8813. The server replied with a NO or BAD response.
  8814. </exception>
  8815. </member>
  8816. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  8817. <summary>
  8818. Fetches the message summaries for the specified message UIDs.
  8819. </summary>
  8820. <remarks>
  8821. <para>Fetches the message summaries for the specified message UIDs.</para>
  8822. <para>It should be noted that if another client has modified any message
  8823. in the folder, the IMAP server may choose to return information that was
  8824. not explicitly requested. It is therefore important to be prepared to
  8825. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  8826. messages that were requested as well as summaries for messages that were
  8827. not requested at all.</para>
  8828. </remarks>
  8829. <example>
  8830. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  8831. </example>
  8832. <returns>An enumeration of summaries for the requested messages.</returns>
  8833. <param name="uids">The UIDs.</param>
  8834. <param name="items">The message summary items to fetch.</param>
  8835. <param name="cancellationToken">The cancellation token.</param>
  8836. <exception cref="T:System.ArgumentNullException">
  8837. <paramref name="uids"/> is <c>null</c>.
  8838. </exception>
  8839. <exception cref="T:System.ArgumentOutOfRangeException">
  8840. <paramref name="items"/> is empty.
  8841. </exception>
  8842. <exception cref="T:System.ArgumentException">
  8843. One or more of the <paramref name="uids"/> is invalid.
  8844. </exception>
  8845. <exception cref="T:System.ObjectDisposedException">
  8846. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8847. </exception>
  8848. <exception cref="T:MailKit.FolderNotOpenException">
  8849. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  8850. </exception>
  8851. <exception cref="T:MailKit.ServiceNotConnectedException">
  8852. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8853. </exception>
  8854. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8855. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8856. </exception>
  8857. <exception cref="T:System.OperationCanceledException">
  8858. The operation was canceled via the cancellation token.
  8859. </exception>
  8860. <exception cref="T:System.IO.IOException">
  8861. An I/O error occurred.
  8862. </exception>
  8863. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8864. The server's response contained unexpected tokens.
  8865. </exception>
  8866. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8867. The server replied with a NO or BAD response.
  8868. </exception>
  8869. </member>
  8870. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  8871. <summary>
  8872. Asynchronously fetches the message summaries for the specified message UIDs.
  8873. </summary>
  8874. <remarks>
  8875. <para>Fetches the message summaries for the specified message UIDs.</para>
  8876. <para>It should be noted that if another client has modified any message
  8877. in the folder, the IMAP server may choose to return information that was
  8878. not explicitly requested. It is therefore important to be prepared to
  8879. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  8880. messages that were requested as well as summaries for messages that were
  8881. not requested at all.</para>
  8882. </remarks>
  8883. <example>
  8884. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  8885. </example>
  8886. <returns>An enumeration of summaries for the requested messages.</returns>
  8887. <param name="uids">The UIDs.</param>
  8888. <param name="items">The message summary items to fetch.</param>
  8889. <param name="cancellationToken">The cancellation token.</param>
  8890. <exception cref="T:System.ArgumentNullException">
  8891. <paramref name="uids"/> is <c>null</c>.
  8892. </exception>
  8893. <exception cref="T:System.ArgumentOutOfRangeException">
  8894. <paramref name="items"/> is empty.
  8895. </exception>
  8896. <exception cref="T:System.ArgumentException">
  8897. One or more of the <paramref name="uids"/> is invalid.
  8898. </exception>
  8899. <exception cref="T:System.ObjectDisposedException">
  8900. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8901. </exception>
  8902. <exception cref="T:MailKit.FolderNotOpenException">
  8903. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  8904. </exception>
  8905. <exception cref="T:MailKit.ServiceNotConnectedException">
  8906. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8907. </exception>
  8908. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8909. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8910. </exception>
  8911. <exception cref="T:System.OperationCanceledException">
  8912. The operation was canceled via the cancellation token.
  8913. </exception>
  8914. <exception cref="T:System.IO.IOException">
  8915. An I/O error occurred.
  8916. </exception>
  8917. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8918. The server's response contained unexpected tokens.
  8919. </exception>
  8920. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8921. The server replied with a NO or BAD response.
  8922. </exception>
  8923. </member>
  8924. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  8925. <summary>
  8926. Fetches the message summaries for the specified message UIDs.
  8927. </summary>
  8928. <remarks>
  8929. <para>Fetches the message summaries for the specified message UIDs.</para>
  8930. <para>It should be noted that if another client has modified any message
  8931. in the folder, the IMAP server may choose to return information that was
  8932. not explicitly requested. It is therefore important to be prepared to
  8933. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  8934. messages that were requested as well as summaries for messages that were
  8935. not requested at all.</para>
  8936. </remarks>
  8937. <returns>An enumeration of summaries for the requested messages.</returns>
  8938. <param name="uids">The UIDs.</param>
  8939. <param name="items">The message summary items to fetch.</param>
  8940. <param name="headers">The desired header fields.</param>
  8941. <param name="cancellationToken">The cancellation token.</param>
  8942. <exception cref="T:System.ArgumentNullException">
  8943. <para><paramref name="uids"/> is <c>null</c>.</para>
  8944. <para>-or-</para>
  8945. <para><paramref name="headers"/> is <c>null</c>.</para>
  8946. </exception>
  8947. <exception cref="T:System.ArgumentException">
  8948. One or more of the <paramref name="uids"/> is invalid.
  8949. </exception>
  8950. <exception cref="T:System.ObjectDisposedException">
  8951. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  8952. </exception>
  8953. <exception cref="T:MailKit.ServiceNotConnectedException">
  8954. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  8955. </exception>
  8956. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  8957. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  8958. </exception>
  8959. <exception cref="T:MailKit.FolderNotOpenException">
  8960. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  8961. </exception>
  8962. <exception cref="T:System.OperationCanceledException">
  8963. The operation was canceled via the cancellation token.
  8964. </exception>
  8965. <exception cref="T:System.IO.IOException">
  8966. An I/O error occurred.
  8967. </exception>
  8968. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  8969. The server's response contained unexpected tokens.
  8970. </exception>
  8971. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  8972. The server replied with a NO or BAD response.
  8973. </exception>
  8974. </member>
  8975. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  8976. <summary>
  8977. Asynchronously fetches the message summaries for the specified message UIDs.
  8978. </summary>
  8979. <remarks>
  8980. <para>Fetches the message summaries for the specified message UIDs.</para>
  8981. <para>It should be noted that if another client has modified any message
  8982. in the folder, the IMAP server may choose to return information that was
  8983. not explicitly requested. It is therefore important to be prepared to
  8984. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  8985. messages that were requested as well as summaries for messages that were
  8986. not requested at all.</para>
  8987. </remarks>
  8988. <returns>An enumeration of summaries for the requested messages.</returns>
  8989. <param name="uids">The UIDs.</param>
  8990. <param name="items">The message summary items to fetch.</param>
  8991. <param name="headers">The desired header fields.</param>
  8992. <param name="cancellationToken">The cancellation token.</param>
  8993. <exception cref="T:System.ArgumentNullException">
  8994. <para><paramref name="uids"/> is <c>null</c>.</para>
  8995. <para>-or-</para>
  8996. <para><paramref name="headers"/> is <c>null</c>.</para>
  8997. </exception>
  8998. <exception cref="T:System.ArgumentException">
  8999. One or more of the <paramref name="uids"/> is invalid.
  9000. </exception>
  9001. <exception cref="T:System.ObjectDisposedException">
  9002. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9003. </exception>
  9004. <exception cref="T:MailKit.ServiceNotConnectedException">
  9005. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9006. </exception>
  9007. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9008. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9009. </exception>
  9010. <exception cref="T:MailKit.FolderNotOpenException">
  9011. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9012. </exception>
  9013. <exception cref="T:System.OperationCanceledException">
  9014. The operation was canceled via the cancellation token.
  9015. </exception>
  9016. <exception cref="T:System.IO.IOException">
  9017. An I/O error occurred.
  9018. </exception>
  9019. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9020. The server's response contained unexpected tokens.
  9021. </exception>
  9022. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9023. The server replied with a NO or BAD response.
  9024. </exception>
  9025. </member>
  9026. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  9027. <summary>
  9028. Fetches the message summaries for the specified message UIDs.
  9029. </summary>
  9030. <remarks>
  9031. <para>Fetches the message summaries for the specified message UIDs.</para>
  9032. <para>It should be noted that if another client has modified any message
  9033. in the folder, the IMAP server may choose to return information that was
  9034. not explicitly requested. It is therefore important to be prepared to
  9035. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9036. messages that were requested as well as summaries for messages that were
  9037. not requested at all.</para>
  9038. </remarks>
  9039. <returns>An enumeration of summaries for the requested messages.</returns>
  9040. <param name="uids">The UIDs.</param>
  9041. <param name="items">The message summary items to fetch.</param>
  9042. <param name="headers">The desired header fields.</param>
  9043. <param name="cancellationToken">The cancellation token.</param>
  9044. <exception cref="T:System.ArgumentNullException">
  9045. <para><paramref name="uids"/> is <c>null</c>.</para>
  9046. <para>-or-</para>
  9047. <para><paramref name="headers"/> is <c>null</c>.</para>
  9048. </exception>
  9049. <exception cref="T:System.ArgumentException">
  9050. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  9051. <para>-or-</para>
  9052. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  9053. </exception>
  9054. <exception cref="T:System.ObjectDisposedException">
  9055. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9056. </exception>
  9057. <exception cref="T:MailKit.ServiceNotConnectedException">
  9058. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9059. </exception>
  9060. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9061. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9062. </exception>
  9063. <exception cref="T:MailKit.FolderNotOpenException">
  9064. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9065. </exception>
  9066. <exception cref="T:System.OperationCanceledException">
  9067. The operation was canceled via the cancellation token.
  9068. </exception>
  9069. <exception cref="T:System.IO.IOException">
  9070. An I/O error occurred.
  9071. </exception>
  9072. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9073. The server's response contained unexpected tokens.
  9074. </exception>
  9075. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9076. The server replied with a NO or BAD response.
  9077. </exception>
  9078. </member>
  9079. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  9080. <summary>
  9081. Asynchronously fetches the message summaries for the specified message UIDs.
  9082. </summary>
  9083. <remarks>
  9084. <para>Fetches the message summaries for the specified message UIDs.</para>
  9085. <para>It should be noted that if another client has modified any message
  9086. in the folder, the IMAP server may choose to return information that was
  9087. not explicitly requested. It is therefore important to be prepared to
  9088. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9089. messages that were requested as well as summaries for messages that were
  9090. not requested at all.</para>
  9091. </remarks>
  9092. <returns>An enumeration of summaries for the requested messages.</returns>
  9093. <param name="uids">The UIDs.</param>
  9094. <param name="items">The message summary items to fetch.</param>
  9095. <param name="headers">The desired header fields.</param>
  9096. <param name="cancellationToken">The cancellation token.</param>
  9097. <exception cref="T:System.ArgumentNullException">
  9098. <para><paramref name="uids"/> is <c>null</c>.</para>
  9099. <para>-or-</para>
  9100. <para><paramref name="headers"/> is <c>null</c>.</para>
  9101. </exception>
  9102. <exception cref="T:System.ArgumentException">
  9103. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  9104. <para>-or-</para>
  9105. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  9106. </exception>
  9107. <exception cref="T:System.ObjectDisposedException">
  9108. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9109. </exception>
  9110. <exception cref="T:MailKit.ServiceNotConnectedException">
  9111. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9112. </exception>
  9113. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9114. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9115. </exception>
  9116. <exception cref="T:MailKit.FolderNotOpenException">
  9117. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9118. </exception>
  9119. <exception cref="T:System.OperationCanceledException">
  9120. The operation was canceled via the cancellation token.
  9121. </exception>
  9122. <exception cref="T:System.IO.IOException">
  9123. An I/O error occurred.
  9124. </exception>
  9125. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9126. The server's response contained unexpected tokens.
  9127. </exception>
  9128. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9129. The server replied with a NO or BAD response.
  9130. </exception>
  9131. </member>
  9132. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  9133. <summary>
  9134. Fetches the message summaries for the specified message UIDs that have a
  9135. higher mod-sequence value than the one specified.
  9136. </summary>
  9137. <remarks>
  9138. <para>Fetches the message summaries for the specified message UIDs that
  9139. have a higher mod-sequence value than the one specified.</para>
  9140. <para>If the IMAP server supports the QRESYNC extension and the application has
  9141. enabled this feature via <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/>,
  9142. then this method will emit <see cref="E:MailKit.MailFolder.MessagesVanished"/> events for messages
  9143. that have vanished since the specified mod-sequence value.</para>
  9144. <para>It should be noted that if another client has modified any message
  9145. in the folder, the IMAP server may choose to return information that was
  9146. not explicitly requested. It is therefore important to be prepared to
  9147. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9148. messages that were requested as well as summaries for messages that were
  9149. not requested at all.</para>
  9150. </remarks>
  9151. <returns>An enumeration of summaries for the requested messages.</returns>
  9152. <param name="uids">The UIDs.</param>
  9153. <param name="modseq">The mod-sequence value.</param>
  9154. <param name="items">The message summary items to fetch.</param>
  9155. <param name="cancellationToken">The cancellation token.</param>
  9156. <exception cref="T:System.ArgumentNullException">
  9157. <paramref name="uids"/> is <c>null</c>.
  9158. </exception>
  9159. <exception cref="T:System.ArgumentOutOfRangeException">
  9160. <paramref name="items"/> is empty.
  9161. </exception>
  9162. <exception cref="T:System.ArgumentException">
  9163. One or more of the <paramref name="uids"/> is invalid.
  9164. </exception>
  9165. <exception cref="T:System.ObjectDisposedException">
  9166. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9167. </exception>
  9168. <exception cref="T:MailKit.ServiceNotConnectedException">
  9169. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9170. </exception>
  9171. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9172. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9173. </exception>
  9174. <exception cref="T:MailKit.FolderNotOpenException">
  9175. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9176. </exception>
  9177. <exception cref="T:System.NotSupportedException">
  9178. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  9179. </exception>
  9180. <exception cref="T:System.OperationCanceledException">
  9181. The operation was canceled via the cancellation token.
  9182. </exception>
  9183. <exception cref="T:System.IO.IOException">
  9184. An I/O error occurred.
  9185. </exception>
  9186. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9187. The server's response contained unexpected tokens.
  9188. </exception>
  9189. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9190. The server replied with a NO or BAD response.
  9191. </exception>
  9192. </member>
  9193. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  9194. <summary>
  9195. Asynchronously fetches the message summaries for the specified message UIDs that have a
  9196. higher mod-sequence value than the one specified.
  9197. </summary>
  9198. <remarks>
  9199. <para>Fetches the message summaries for the specified message UIDs that
  9200. have a higher mod-sequence value than the one specified.</para>
  9201. <para>If the IMAP server supports the QRESYNC extension and the application has
  9202. enabled this feature via <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/>,
  9203. then this method will emit <see cref="E:MailKit.MailFolder.MessagesVanished"/> events for messages
  9204. that have vanished since the specified mod-sequence value.</para>
  9205. <para>It should be noted that if another client has modified any message
  9206. in the folder, the IMAP server may choose to return information that was
  9207. not explicitly requested. It is therefore important to be prepared to
  9208. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9209. messages that were requested as well as summaries for messages that were
  9210. not requested at all.</para>
  9211. </remarks>
  9212. <returns>An enumeration of summaries for the requested messages.</returns>
  9213. <param name="uids">The UIDs.</param>
  9214. <param name="modseq">The mod-sequence value.</param>
  9215. <param name="items">The message summary items to fetch.</param>
  9216. <param name="cancellationToken">The cancellation token.</param>
  9217. <exception cref="T:System.ArgumentNullException">
  9218. <paramref name="uids"/> is <c>null</c>.
  9219. </exception>
  9220. <exception cref="T:System.ArgumentOutOfRangeException">
  9221. <paramref name="items"/> is empty.
  9222. </exception>
  9223. <exception cref="T:System.ArgumentException">
  9224. One or more of the <paramref name="uids"/> is invalid.
  9225. </exception>
  9226. <exception cref="T:System.ObjectDisposedException">
  9227. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9228. </exception>
  9229. <exception cref="T:MailKit.ServiceNotConnectedException">
  9230. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9231. </exception>
  9232. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9233. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9234. </exception>
  9235. <exception cref="T:MailKit.FolderNotOpenException">
  9236. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9237. </exception>
  9238. <exception cref="T:System.NotSupportedException">
  9239. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  9240. </exception>
  9241. <exception cref="T:System.OperationCanceledException">
  9242. The operation was canceled via the cancellation token.
  9243. </exception>
  9244. <exception cref="T:System.IO.IOException">
  9245. An I/O error occurred.
  9246. </exception>
  9247. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9248. The server's response contained unexpected tokens.
  9249. </exception>
  9250. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9251. The server replied with a NO or BAD response.
  9252. </exception>
  9253. </member>
  9254. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  9255. <summary>
  9256. Fetches the message summaries for the specified message UIDs that have a
  9257. higher mod-sequence value than the one specified.
  9258. </summary>
  9259. <remarks>
  9260. <para>Fetches the message summaries for the specified message UIDs that
  9261. have a higher mod-sequence value than the one specified.</para>
  9262. <para>If the IMAP server supports the QRESYNC extension and the application has
  9263. enabled this feature via <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/>,
  9264. then this method will emit <see cref="E:MailKit.MailFolder.MessagesVanished"/> events for messages
  9265. that have vanished since the specified mod-sequence value.</para>
  9266. <para>It should be noted that if another client has modified any message
  9267. in the folder, the IMAP server may choose to return information that was
  9268. not explicitly requested. It is therefore important to be prepared to
  9269. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9270. messages that were requested as well as summaries for messages that were
  9271. not requested at all.</para>
  9272. </remarks>
  9273. <returns>An enumeration of summaries for the requested messages.</returns>
  9274. <param name="uids">The UIDs.</param>
  9275. <param name="modseq">The mod-sequence value.</param>
  9276. <param name="items">The message summary items to fetch.</param>
  9277. <param name="headers">The desired header fields.</param>
  9278. <param name="cancellationToken">The cancellation token.</param>
  9279. <exception cref="T:System.ArgumentNullException">
  9280. <para><paramref name="uids"/> is <c>null</c>.</para>
  9281. <para>-or-</para>
  9282. <para><paramref name="headers"/> is <c>null</c>.</para>
  9283. </exception>
  9284. <exception cref="T:System.ArgumentException">
  9285. One or more of the <paramref name="uids"/> is invalid.
  9286. </exception>
  9287. <exception cref="T:System.ObjectDisposedException">
  9288. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9289. </exception>
  9290. <exception cref="T:MailKit.ServiceNotConnectedException">
  9291. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9292. </exception>
  9293. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9294. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9295. </exception>
  9296. <exception cref="T:MailKit.FolderNotOpenException">
  9297. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9298. </exception>
  9299. <exception cref="T:System.NotSupportedException">
  9300. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  9301. </exception>
  9302. <exception cref="T:System.OperationCanceledException">
  9303. The operation was canceled via the cancellation token.
  9304. </exception>
  9305. <exception cref="T:System.IO.IOException">
  9306. An I/O error occurred.
  9307. </exception>
  9308. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9309. The server's response contained unexpected tokens.
  9310. </exception>
  9311. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9312. The server replied with a NO or BAD response.
  9313. </exception>
  9314. </member>
  9315. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  9316. <summary>
  9317. Asynchronously fetches the message summaries for the specified message UIDs that have a
  9318. higher mod-sequence value than the one specified.
  9319. </summary>
  9320. <remarks>
  9321. <para>Fetches the message summaries for the specified message UIDs that
  9322. have a higher mod-sequence value than the one specified.</para>
  9323. <para>If the IMAP server supports the QRESYNC extension and the application has
  9324. enabled this feature via <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/>,
  9325. then this method will emit <see cref="E:MailKit.MailFolder.MessagesVanished"/> events for messages
  9326. that have vanished since the specified mod-sequence value.</para>
  9327. <para>It should be noted that if another client has modified any message
  9328. in the folder, the IMAP server may choose to return information that was
  9329. not explicitly requested. It is therefore important to be prepared to
  9330. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9331. messages that were requested as well as summaries for messages that were
  9332. not requested at all.</para>
  9333. </remarks>
  9334. <returns>An enumeration of summaries for the requested messages.</returns>
  9335. <param name="uids">The UIDs.</param>
  9336. <param name="modseq">The mod-sequence value.</param>
  9337. <param name="items">The message summary items to fetch.</param>
  9338. <param name="headers">The desired header fields.</param>
  9339. <param name="cancellationToken">The cancellation token.</param>
  9340. <exception cref="T:System.ArgumentNullException">
  9341. <para><paramref name="uids"/> is <c>null</c>.</para>
  9342. <para>-or-</para>
  9343. <para><paramref name="headers"/> is <c>null</c>.</para>
  9344. </exception>
  9345. <exception cref="T:System.ArgumentException">
  9346. One or more of the <paramref name="uids"/> is invalid.
  9347. </exception>
  9348. <exception cref="T:System.ObjectDisposedException">
  9349. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9350. </exception>
  9351. <exception cref="T:MailKit.ServiceNotConnectedException">
  9352. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9353. </exception>
  9354. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9355. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9356. </exception>
  9357. <exception cref="T:MailKit.FolderNotOpenException">
  9358. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9359. </exception>
  9360. <exception cref="T:System.NotSupportedException">
  9361. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  9362. </exception>
  9363. <exception cref="T:System.OperationCanceledException">
  9364. The operation was canceled via the cancellation token.
  9365. </exception>
  9366. <exception cref="T:System.IO.IOException">
  9367. An I/O error occurred.
  9368. </exception>
  9369. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9370. The server's response contained unexpected tokens.
  9371. </exception>
  9372. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9373. The server replied with a NO or BAD response.
  9374. </exception>
  9375. </member>
  9376. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  9377. <summary>
  9378. Fetches the message summaries for the specified message UIDs that have a
  9379. higher mod-sequence value than the one specified.
  9380. </summary>
  9381. <remarks>
  9382. <para>Fetches the message summaries for the specified message UIDs that
  9383. have a higher mod-sequence value than the one specified.</para>
  9384. <para>If the IMAP server supports the QRESYNC extension and the application has
  9385. enabled this feature via <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/>,
  9386. then this method will emit <see cref="E:MailKit.MailFolder.MessagesVanished"/> events for messages
  9387. that have vanished since the specified mod-sequence value.</para>
  9388. <para>It should be noted that if another client has modified any message
  9389. in the folder, the IMAP server may choose to return information that was
  9390. not explicitly requested. It is therefore important to be prepared to
  9391. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9392. messages that were requested as well as summaries for messages that were
  9393. not requested at all.</para>
  9394. </remarks>
  9395. <returns>An enumeration of summaries for the requested messages.</returns>
  9396. <param name="uids">The UIDs.</param>
  9397. <param name="modseq">The mod-sequence value.</param>
  9398. <param name="items">The message summary items to fetch.</param>
  9399. <param name="headers">The desired header fields.</param>
  9400. <param name="cancellationToken">The cancellation token.</param>
  9401. <exception cref="T:System.ArgumentNullException">
  9402. <para><paramref name="uids"/> is <c>null</c>.</para>
  9403. <para>-or-</para>
  9404. <para><paramref name="headers"/> is <c>null</c>.</para>
  9405. </exception>
  9406. <exception cref="T:System.ArgumentException">
  9407. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  9408. <para>-or-</para>
  9409. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  9410. </exception>
  9411. <exception cref="T:System.ObjectDisposedException">
  9412. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9413. </exception>
  9414. <exception cref="T:MailKit.ServiceNotConnectedException">
  9415. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9416. </exception>
  9417. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9418. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9419. </exception>
  9420. <exception cref="T:MailKit.FolderNotOpenException">
  9421. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9422. </exception>
  9423. <exception cref="T:System.NotSupportedException">
  9424. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  9425. </exception>
  9426. <exception cref="T:System.OperationCanceledException">
  9427. The operation was canceled via the cancellation token.
  9428. </exception>
  9429. <exception cref="T:System.IO.IOException">
  9430. An I/O error occurred.
  9431. </exception>
  9432. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9433. The server's response contained unexpected tokens.
  9434. </exception>
  9435. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9436. The server replied with a NO or BAD response.
  9437. </exception>
  9438. </member>
  9439. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  9440. <summary>
  9441. Asynchronously fetches the message summaries for the specified message UIDs that have a
  9442. higher mod-sequence value than the one specified.
  9443. </summary>
  9444. <remarks>
  9445. <para>Fetches the message summaries for the specified message UIDs that
  9446. have a higher mod-sequence value than the one specified.</para>
  9447. <para>If the IMAP server supports the QRESYNC extension and the application has
  9448. enabled this feature via <see cref="M:MailKit.Net.Imap.ImapClient.EnableQuickResync(System.Threading.CancellationToken)"/>,
  9449. then this method will emit <see cref="E:MailKit.MailFolder.MessagesVanished"/> events for messages
  9450. that have vanished since the specified mod-sequence value.</para>
  9451. <para>It should be noted that if another client has modified any message
  9452. in the folder, the IMAP server may choose to return information that was
  9453. not explicitly requested. It is therefore important to be prepared to
  9454. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9455. messages that were requested as well as summaries for messages that were
  9456. not requested at all.</para>
  9457. </remarks>
  9458. <returns>An enumeration of summaries for the requested messages.</returns>
  9459. <param name="uids">The UIDs.</param>
  9460. <param name="modseq">The mod-sequence value.</param>
  9461. <param name="items">The message summary items to fetch.</param>
  9462. <param name="headers">The desired header fields.</param>
  9463. <param name="cancellationToken">The cancellation token.</param>
  9464. <exception cref="T:System.ArgumentNullException">
  9465. <para><paramref name="uids"/> is <c>null</c>.</para>
  9466. <para>-or-</para>
  9467. <para><paramref name="headers"/> is <c>null</c>.</para>
  9468. </exception>
  9469. <exception cref="T:System.ArgumentException">
  9470. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  9471. <para>-or-</para>
  9472. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  9473. </exception>
  9474. <exception cref="T:System.ObjectDisposedException">
  9475. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9476. </exception>
  9477. <exception cref="T:MailKit.ServiceNotConnectedException">
  9478. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9479. </exception>
  9480. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9481. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9482. </exception>
  9483. <exception cref="T:MailKit.FolderNotOpenException">
  9484. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9485. </exception>
  9486. <exception cref="T:System.NotSupportedException">
  9487. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  9488. </exception>
  9489. <exception cref="T:System.OperationCanceledException">
  9490. The operation was canceled via the cancellation token.
  9491. </exception>
  9492. <exception cref="T:System.IO.IOException">
  9493. An I/O error occurred.
  9494. </exception>
  9495. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9496. The server's response contained unexpected tokens.
  9497. </exception>
  9498. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9499. The server replied with a NO or BAD response.
  9500. </exception>
  9501. </member>
  9502. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  9503. <summary>
  9504. Fetches the message summaries for the specified message indexes.
  9505. </summary>
  9506. <remarks>
  9507. <para>Fetches the message summaries for the specified message indexes.</para>
  9508. <para>It should be noted that if another client has modified any message
  9509. in the folder, the IMAP server may choose to return information that was
  9510. not explicitly requested. It is therefore important to be prepared to
  9511. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9512. messages that were requested as well as summaries for messages that were
  9513. not requested at all.</para>
  9514. </remarks>
  9515. <returns>An enumeration of summaries for the requested messages.</returns>
  9516. <param name="indexes">The indexes.</param>
  9517. <param name="items">The message summary items to fetch.</param>
  9518. <param name="cancellationToken">The cancellation token.</param>
  9519. <exception cref="T:System.ArgumentNullException">
  9520. <paramref name="indexes"/> is <c>null</c>.
  9521. </exception>
  9522. <exception cref="T:System.ArgumentOutOfRangeException">
  9523. <paramref name="items"/> is empty.
  9524. </exception>
  9525. <exception cref="T:System.ArgumentException">
  9526. One or more of the <paramref name="indexes"/> is invalid.
  9527. </exception>
  9528. <exception cref="T:System.ObjectDisposedException">
  9529. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9530. </exception>
  9531. <exception cref="T:MailKit.ServiceNotConnectedException">
  9532. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9533. </exception>
  9534. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9535. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9536. </exception>
  9537. <exception cref="T:MailKit.FolderNotOpenException">
  9538. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9539. </exception>
  9540. <exception cref="T:System.OperationCanceledException">
  9541. The operation was canceled via the cancellation token.
  9542. </exception>
  9543. <exception cref="T:System.IO.IOException">
  9544. An I/O error occurred.
  9545. </exception>
  9546. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9547. The server's response contained unexpected tokens.
  9548. </exception>
  9549. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9550. The server replied with a NO or BAD response.
  9551. </exception>
  9552. </member>
  9553. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  9554. <summary>
  9555. Asynchronously fetches the message summaries for the specified message indexes.
  9556. </summary>
  9557. <remarks>
  9558. <para>Fetches the message summaries for the specified message indexes.</para>
  9559. <para>It should be noted that if another client has modified any message
  9560. in the folder, the IMAP server may choose to return information that was
  9561. not explicitly requested. It is therefore important to be prepared to
  9562. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9563. messages that were requested as well as summaries for messages that were
  9564. not requested at all.</para>
  9565. </remarks>
  9566. <returns>An enumeration of summaries for the requested messages.</returns>
  9567. <param name="indexes">The indexes.</param>
  9568. <param name="items">The message summary items to fetch.</param>
  9569. <param name="cancellationToken">The cancellation token.</param>
  9570. <exception cref="T:System.ArgumentNullException">
  9571. <paramref name="indexes"/> is <c>null</c>.
  9572. </exception>
  9573. <exception cref="T:System.ArgumentOutOfRangeException">
  9574. <paramref name="items"/> is empty.
  9575. </exception>
  9576. <exception cref="T:System.ArgumentException">
  9577. One or more of the <paramref name="indexes"/> is invalid.
  9578. </exception>
  9579. <exception cref="T:System.ObjectDisposedException">
  9580. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9581. </exception>
  9582. <exception cref="T:MailKit.ServiceNotConnectedException">
  9583. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9584. </exception>
  9585. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9586. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9587. </exception>
  9588. <exception cref="T:MailKit.FolderNotOpenException">
  9589. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9590. </exception>
  9591. <exception cref="T:System.OperationCanceledException">
  9592. The operation was canceled via the cancellation token.
  9593. </exception>
  9594. <exception cref="T:System.IO.IOException">
  9595. An I/O error occurred.
  9596. </exception>
  9597. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9598. The server's response contained unexpected tokens.
  9599. </exception>
  9600. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9601. The server replied with a NO or BAD response.
  9602. </exception>
  9603. </member>
  9604. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  9605. <summary>
  9606. Fetches the message summaries for the specified message indexes.
  9607. </summary>
  9608. <remarks>
  9609. <para>Fetches the message summaries for the specified message indexes.</para>
  9610. <para>It should be noted that if another client has modified any message
  9611. in the folder, the IMAP server may choose to return information that was
  9612. not explicitly requested. It is therefore important to be prepared to
  9613. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9614. messages that were requested as well as summaries for messages that were
  9615. not requested at all.</para>
  9616. </remarks>
  9617. <returns>An enumeration of summaries for the requested messages.</returns>
  9618. <param name="indexes">The indexes.</param>
  9619. <param name="items">The message summary items to fetch.</param>
  9620. <param name="headers">The desired header fields.</param>
  9621. <param name="cancellationToken">The cancellation token.</param>
  9622. <exception cref="T:System.ArgumentNullException">
  9623. <para><paramref name="indexes"/> is <c>null</c>.</para>
  9624. <para>-or-</para>
  9625. <para><paramref name="headers"/> is <c>null</c>.</para>
  9626. </exception>
  9627. <exception cref="T:System.ArgumentException">
  9628. One or more of the <paramref name="indexes"/> is invalid.
  9629. </exception>
  9630. <exception cref="T:System.ObjectDisposedException">
  9631. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9632. </exception>
  9633. <exception cref="T:MailKit.ServiceNotConnectedException">
  9634. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9635. </exception>
  9636. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9637. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9638. </exception>
  9639. <exception cref="T:MailKit.FolderNotOpenException">
  9640. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9641. </exception>
  9642. <exception cref="T:System.OperationCanceledException">
  9643. The operation was canceled via the cancellation token.
  9644. </exception>
  9645. <exception cref="T:System.IO.IOException">
  9646. An I/O error occurred.
  9647. </exception>
  9648. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9649. The server's response contained unexpected tokens.
  9650. </exception>
  9651. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9652. The server replied with a NO or BAD response.
  9653. </exception>
  9654. </member>
  9655. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  9656. <summary>
  9657. Asynchronously fetches the message summaries for the specified message indexes.
  9658. </summary>
  9659. <remarks>
  9660. <para>Fetches the message summaries for the specified message indexes.</para>
  9661. <para>It should be noted that if another client has modified any message
  9662. in the folder, the IMAP server may choose to return information that was
  9663. not explicitly requested. It is therefore important to be prepared to
  9664. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9665. messages that were requested as well as summaries for messages that were
  9666. not requested at all.</para>
  9667. </remarks>
  9668. <returns>An enumeration of summaries for the requested messages.</returns>
  9669. <param name="indexes">The indexes.</param>
  9670. <param name="items">The message summary items to fetch.</param>
  9671. <param name="headers">The desired header fields.</param>
  9672. <param name="cancellationToken">The cancellation token.</param>
  9673. <exception cref="T:System.ArgumentNullException">
  9674. <para><paramref name="indexes"/> is <c>null</c>.</para>
  9675. <para>-or-</para>
  9676. <para><paramref name="headers"/> is <c>null</c>.</para>
  9677. </exception>
  9678. <exception cref="T:System.ArgumentException">
  9679. One or more of the <paramref name="indexes"/> is invalid.
  9680. </exception>
  9681. <exception cref="T:System.ObjectDisposedException">
  9682. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9683. </exception>
  9684. <exception cref="T:MailKit.ServiceNotConnectedException">
  9685. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9686. </exception>
  9687. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9688. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9689. </exception>
  9690. <exception cref="T:MailKit.FolderNotOpenException">
  9691. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9692. </exception>
  9693. <exception cref="T:System.OperationCanceledException">
  9694. The operation was canceled via the cancellation token.
  9695. </exception>
  9696. <exception cref="T:System.IO.IOException">
  9697. An I/O error occurred.
  9698. </exception>
  9699. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9700. The server's response contained unexpected tokens.
  9701. </exception>
  9702. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9703. The server replied with a NO or BAD response.
  9704. </exception>
  9705. </member>
  9706. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  9707. <summary>
  9708. Fetches the message summaries for the specified message indexes.
  9709. </summary>
  9710. <remarks>
  9711. <para>Fetches the message summaries for the specified message indexes.</para>
  9712. <para>It should be noted that if another client has modified any message
  9713. in the folder, the IMAP server may choose to return information that was
  9714. not explicitly requested. It is therefore important to be prepared to
  9715. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9716. messages that were requested as well as summaries for messages that were
  9717. not requested at all.</para>
  9718. </remarks>
  9719. <returns>An enumeration of summaries for the requested messages.</returns>
  9720. <param name="indexes">The indexes.</param>
  9721. <param name="items">The message summary items to fetch.</param>
  9722. <param name="headers">The desired header fields.</param>
  9723. <param name="cancellationToken">The cancellation token.</param>
  9724. <exception cref="T:System.ArgumentNullException">
  9725. <para><paramref name="indexes"/> is <c>null</c>.</para>
  9726. <para>-or-</para>
  9727. <para><paramref name="headers"/> is <c>null</c>.</para>
  9728. </exception>
  9729. <exception cref="T:System.ArgumentException">
  9730. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  9731. <para>-or-</para>
  9732. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  9733. </exception>
  9734. <exception cref="T:System.ObjectDisposedException">
  9735. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9736. </exception>
  9737. <exception cref="T:MailKit.ServiceNotConnectedException">
  9738. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9739. </exception>
  9740. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9741. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9742. </exception>
  9743. <exception cref="T:MailKit.FolderNotOpenException">
  9744. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9745. </exception>
  9746. <exception cref="T:System.OperationCanceledException">
  9747. The operation was canceled via the cancellation token.
  9748. </exception>
  9749. <exception cref="T:System.IO.IOException">
  9750. An I/O error occurred.
  9751. </exception>
  9752. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9753. The server's response contained unexpected tokens.
  9754. </exception>
  9755. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9756. The server replied with a NO or BAD response.
  9757. </exception>
  9758. </member>
  9759. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  9760. <summary>
  9761. Asynchronously fetches the message summaries for the specified message indexes.
  9762. </summary>
  9763. <remarks>
  9764. <para>Fetches the message summaries for the specified message indexes.</para>
  9765. <para>It should be noted that if another client has modified any message
  9766. in the folder, the IMAP server may choose to return information that was
  9767. not explicitly requested. It is therefore important to be prepared to
  9768. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9769. messages that were requested as well as summaries for messages that were
  9770. not requested at all.</para>
  9771. </remarks>
  9772. <returns>An enumeration of summaries for the requested messages.</returns>
  9773. <param name="indexes">The indexes.</param>
  9774. <param name="items">The message summary items to fetch.</param>
  9775. <param name="headers">The desired header fields.</param>
  9776. <param name="cancellationToken">The cancellation token.</param>
  9777. <exception cref="T:System.ArgumentNullException">
  9778. <para><paramref name="indexes"/> is <c>null</c>.</para>
  9779. <para>-or-</para>
  9780. <para><paramref name="headers"/> is <c>null</c>.</para>
  9781. </exception>
  9782. <exception cref="T:System.ArgumentException">
  9783. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  9784. <para>-or-</para>
  9785. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  9786. </exception>
  9787. <exception cref="T:System.ObjectDisposedException">
  9788. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9789. </exception>
  9790. <exception cref="T:MailKit.ServiceNotConnectedException">
  9791. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9792. </exception>
  9793. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9794. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9795. </exception>
  9796. <exception cref="T:MailKit.FolderNotOpenException">
  9797. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9798. </exception>
  9799. <exception cref="T:System.OperationCanceledException">
  9800. The operation was canceled via the cancellation token.
  9801. </exception>
  9802. <exception cref="T:System.IO.IOException">
  9803. An I/O error occurred.
  9804. </exception>
  9805. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9806. The server's response contained unexpected tokens.
  9807. </exception>
  9808. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9809. The server replied with a NO or BAD response.
  9810. </exception>
  9811. </member>
  9812. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  9813. <summary>
  9814. Fetches the message summaries for the specified message indexes that have a
  9815. higher mod-sequence value than the one specified.
  9816. </summary>
  9817. <remarks>
  9818. <para>Fetches the message summaries for the specified message indexes that
  9819. have a higher mod-sequence value than the one specified.</para>
  9820. <para>It should be noted that if another client has modified any message
  9821. in the folder, the IMAP server may choose to return information that was
  9822. not explicitly requested. It is therefore important to be prepared to
  9823. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9824. messages that were requested as well as summaries for messages that were
  9825. not requested at all.</para>
  9826. </remarks>
  9827. <returns>An enumeration of summaries for the requested messages.</returns>
  9828. <param name="indexes">The indexes.</param>
  9829. <param name="modseq">The mod-sequence value.</param>
  9830. <param name="items">The message summary items to fetch.</param>
  9831. <param name="cancellationToken">The cancellation token.</param>
  9832. <exception cref="T:System.ArgumentNullException">
  9833. <paramref name="indexes"/> is <c>null</c>.
  9834. </exception>
  9835. <exception cref="T:System.ArgumentOutOfRangeException">
  9836. <paramref name="items"/> is empty.
  9837. </exception>
  9838. <exception cref="T:System.ArgumentException">
  9839. One or more of the <paramref name="indexes"/> is invalid.
  9840. </exception>
  9841. <exception cref="T:System.ObjectDisposedException">
  9842. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9843. </exception>
  9844. <exception cref="T:MailKit.ServiceNotConnectedException">
  9845. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9846. </exception>
  9847. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9848. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9849. </exception>
  9850. <exception cref="T:MailKit.FolderNotOpenException">
  9851. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9852. </exception>
  9853. <exception cref="T:System.NotSupportedException">
  9854. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  9855. </exception>
  9856. <exception cref="T:System.OperationCanceledException">
  9857. The operation was canceled via the cancellation token.
  9858. </exception>
  9859. <exception cref="T:System.IO.IOException">
  9860. An I/O error occurred.
  9861. </exception>
  9862. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9863. The server's response contained unexpected tokens.
  9864. </exception>
  9865. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9866. The server replied with a NO or BAD response.
  9867. </exception>
  9868. </member>
  9869. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  9870. <summary>
  9871. Asynchronously fetches the message summaries for the specified message indexes that have a
  9872. higher mod-sequence value than the one specified.
  9873. </summary>
  9874. <remarks>
  9875. <para>Fetches the message summaries for the specified message indexes that
  9876. have a higher mod-sequence value than the one specified.</para>
  9877. <para>It should be noted that if another client has modified any message
  9878. in the folder, the IMAP server may choose to return information that was
  9879. not explicitly requested. It is therefore important to be prepared to
  9880. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9881. messages that were requested as well as summaries for messages that were
  9882. not requested at all.</para>
  9883. </remarks>
  9884. <returns>An enumeration of summaries for the requested messages.</returns>
  9885. <param name="indexes">The indexes.</param>
  9886. <param name="modseq">The mod-sequence value.</param>
  9887. <param name="items">The message summary items to fetch.</param>
  9888. <param name="cancellationToken">The cancellation token.</param>
  9889. <exception cref="T:System.ArgumentNullException">
  9890. <paramref name="indexes"/> is <c>null</c>.
  9891. </exception>
  9892. <exception cref="T:System.ArgumentOutOfRangeException">
  9893. <paramref name="items"/> is empty.
  9894. </exception>
  9895. <exception cref="T:System.ArgumentException">
  9896. One or more of the <paramref name="indexes"/> is invalid.
  9897. </exception>
  9898. <exception cref="T:System.ObjectDisposedException">
  9899. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9900. </exception>
  9901. <exception cref="T:MailKit.ServiceNotConnectedException">
  9902. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9903. </exception>
  9904. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9905. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9906. </exception>
  9907. <exception cref="T:MailKit.FolderNotOpenException">
  9908. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9909. </exception>
  9910. <exception cref="T:System.NotSupportedException">
  9911. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  9912. </exception>
  9913. <exception cref="T:System.OperationCanceledException">
  9914. The operation was canceled via the cancellation token.
  9915. </exception>
  9916. <exception cref="T:System.IO.IOException">
  9917. An I/O error occurred.
  9918. </exception>
  9919. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9920. The server's response contained unexpected tokens.
  9921. </exception>
  9922. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9923. The server replied with a NO or BAD response.
  9924. </exception>
  9925. </member>
  9926. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  9927. <summary>
  9928. Fetches the message summaries for the specified message indexes that have a
  9929. higher mod-sequence value than the one specified.
  9930. </summary>
  9931. <remarks>
  9932. <para>Fetches the message summaries for the specified message indexes that
  9933. have a higher mod-sequence value than the one specified.</para>
  9934. <para>It should be noted that if another client has modified any message
  9935. in the folder, the IMAP server may choose to return information that was
  9936. not explicitly requested. It is therefore important to be prepared to
  9937. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9938. messages that were requested as well as summaries for messages that were
  9939. not requested at all.</para>
  9940. </remarks>
  9941. <returns>An enumeration of summaries for the requested messages.</returns>
  9942. <param name="indexes">The indexes.</param>
  9943. <param name="modseq">The mod-sequence value.</param>
  9944. <param name="items">The message summary items to fetch.</param>
  9945. <param name="headers">The desired header fields.</param>
  9946. <param name="cancellationToken">The cancellation token.</param>
  9947. <exception cref="T:System.ArgumentNullException">
  9948. <para><paramref name="indexes"/> is <c>null</c>.</para>
  9949. <para>-or-</para>
  9950. <para><paramref name="headers"/> is <c>null</c>.</para>
  9951. </exception>
  9952. <exception cref="T:System.ArgumentException">
  9953. One or more of the <paramref name="indexes"/> is invalid.
  9954. </exception>
  9955. <exception cref="T:System.ObjectDisposedException">
  9956. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  9957. </exception>
  9958. <exception cref="T:MailKit.ServiceNotConnectedException">
  9959. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  9960. </exception>
  9961. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  9962. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  9963. </exception>
  9964. <exception cref="T:MailKit.FolderNotOpenException">
  9965. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  9966. </exception>
  9967. <exception cref="T:System.NotSupportedException">
  9968. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  9969. </exception>
  9970. <exception cref="T:System.OperationCanceledException">
  9971. The operation was canceled via the cancellation token.
  9972. </exception>
  9973. <exception cref="T:System.IO.IOException">
  9974. An I/O error occurred.
  9975. </exception>
  9976. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  9977. The server's response contained unexpected tokens.
  9978. </exception>
  9979. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  9980. The server replied with a NO or BAD response.
  9981. </exception>
  9982. </member>
  9983. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  9984. <summary>
  9985. Asynchronously fetches the message summaries for the specified message indexes that have a
  9986. higher mod-sequence value than the one specified.
  9987. </summary>
  9988. <remarks>
  9989. <para>Fetches the message summaries for the specified message indexes that
  9990. have a higher mod-sequence value than the one specified.</para>
  9991. <para>It should be noted that if another client has modified any message
  9992. in the folder, the IMAP server may choose to return information that was
  9993. not explicitly requested. It is therefore important to be prepared to
  9994. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  9995. messages that were requested as well as summaries for messages that were
  9996. not requested at all.</para>
  9997. </remarks>
  9998. <returns>An enumeration of summaries for the requested messages.</returns>
  9999. <param name="indexes">The indexes.</param>
  10000. <param name="modseq">The mod-sequence value.</param>
  10001. <param name="items">The message summary items to fetch.</param>
  10002. <param name="headers">The desired header fields.</param>
  10003. <param name="cancellationToken">The cancellation token.</param>
  10004. <exception cref="T:System.ArgumentNullException">
  10005. <para><paramref name="indexes"/> is <c>null</c>.</para>
  10006. <para>-or-</para>
  10007. <para><paramref name="headers"/> is <c>null</c>.</para>
  10008. </exception>
  10009. <exception cref="T:System.ArgumentException">
  10010. One or more of the <paramref name="indexes"/> is invalid.
  10011. </exception>
  10012. <exception cref="T:System.ObjectDisposedException">
  10013. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10014. </exception>
  10015. <exception cref="T:MailKit.ServiceNotConnectedException">
  10016. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10017. </exception>
  10018. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10019. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10020. </exception>
  10021. <exception cref="T:MailKit.FolderNotOpenException">
  10022. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10023. </exception>
  10024. <exception cref="T:System.NotSupportedException">
  10025. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  10026. </exception>
  10027. <exception cref="T:System.OperationCanceledException">
  10028. The operation was canceled via the cancellation token.
  10029. </exception>
  10030. <exception cref="T:System.IO.IOException">
  10031. An I/O error occurred.
  10032. </exception>
  10033. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10034. The server's response contained unexpected tokens.
  10035. </exception>
  10036. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10037. The server replied with a NO or BAD response.
  10038. </exception>
  10039. </member>
  10040. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  10041. <summary>
  10042. Fetches the message summaries for the specified message indexes that have a
  10043. higher mod-sequence value than the one specified.
  10044. </summary>
  10045. <remarks>
  10046. <para>Fetches the message summaries for the specified message indexes that
  10047. have a higher mod-sequence value than the one specified.</para>
  10048. <para>It should be noted that if another client has modified any message
  10049. in the folder, the IMAP server may choose to return information that was
  10050. not explicitly requested. It is therefore important to be prepared to
  10051. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  10052. messages that were requested as well as summaries for messages that were
  10053. not requested at all.</para>
  10054. </remarks>
  10055. <returns>An enumeration of summaries for the requested messages.</returns>
  10056. <param name="indexes">The indexes.</param>
  10057. <param name="modseq">The mod-sequence value.</param>
  10058. <param name="items">The message summary items to fetch.</param>
  10059. <param name="headers">The desired header fields.</param>
  10060. <param name="cancellationToken">The cancellation token.</param>
  10061. <exception cref="T:System.ArgumentNullException">
  10062. <para><paramref name="indexes"/> is <c>null</c>.</para>
  10063. <para>-or-</para>
  10064. <para><paramref name="headers"/> is <c>null</c>.</para>
  10065. </exception>
  10066. <exception cref="T:System.ArgumentException">
  10067. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  10068. <para>-or-</para>
  10069. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  10070. </exception>
  10071. <exception cref="T:System.ObjectDisposedException">
  10072. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10073. </exception>
  10074. <exception cref="T:MailKit.ServiceNotConnectedException">
  10075. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10076. </exception>
  10077. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10078. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10079. </exception>
  10080. <exception cref="T:MailKit.FolderNotOpenException">
  10081. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10082. </exception>
  10083. <exception cref="T:System.NotSupportedException">
  10084. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  10085. </exception>
  10086. <exception cref="T:System.OperationCanceledException">
  10087. The operation was canceled via the cancellation token.
  10088. </exception>
  10089. <exception cref="T:System.IO.IOException">
  10090. An I/O error occurred.
  10091. </exception>
  10092. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10093. The server's response contained unexpected tokens.
  10094. </exception>
  10095. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10096. The server replied with a NO or BAD response.
  10097. </exception>
  10098. </member>
  10099. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  10100. <summary>
  10101. Asynchronously fetches the message summaries for the specified message indexes that have a
  10102. higher mod-sequence value than the one specified.
  10103. </summary>
  10104. <remarks>
  10105. <para>Fetches the message summaries for the specified message indexes that
  10106. have a higher mod-sequence value than the one specified.</para>
  10107. <para>It should be noted that if another client has modified any message
  10108. in the folder, the IMAP server may choose to return information that was
  10109. not explicitly requested. It is therefore important to be prepared to
  10110. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  10111. messages that were requested as well as summaries for messages that were
  10112. not requested at all.</para>
  10113. </remarks>
  10114. <returns>An enumeration of summaries for the requested messages.</returns>
  10115. <param name="indexes">The indexes.</param>
  10116. <param name="modseq">The mod-sequence value.</param>
  10117. <param name="items">The message summary items to fetch.</param>
  10118. <param name="headers">The desired header fields.</param>
  10119. <param name="cancellationToken">The cancellation token.</param>
  10120. <exception cref="T:System.ArgumentNullException">
  10121. <para><paramref name="indexes"/> is <c>null</c>.</para>
  10122. <para>-or-</para>
  10123. <para><paramref name="headers"/> is <c>null</c>.</para>
  10124. </exception>
  10125. <exception cref="T:System.ArgumentException">
  10126. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  10127. <para>-or-</para>
  10128. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  10129. </exception>
  10130. <exception cref="T:System.ObjectDisposedException">
  10131. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10132. </exception>
  10133. <exception cref="T:MailKit.ServiceNotConnectedException">
  10134. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10135. </exception>
  10136. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10137. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10138. </exception>
  10139. <exception cref="T:MailKit.FolderNotOpenException">
  10140. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10141. </exception>
  10142. <exception cref="T:System.NotSupportedException">
  10143. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  10144. </exception>
  10145. <exception cref="T:System.OperationCanceledException">
  10146. The operation was canceled via the cancellation token.
  10147. </exception>
  10148. <exception cref="T:System.IO.IOException">
  10149. An I/O error occurred.
  10150. </exception>
  10151. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10152. The server's response contained unexpected tokens.
  10153. </exception>
  10154. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10155. The server replied with a NO or BAD response.
  10156. </exception>
  10157. </member>
  10158. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  10159. <summary>
  10160. Fetches the message summaries for the messages between the two indexes, inclusive.
  10161. </summary>
  10162. <remarks>
  10163. <para>Fetches the message summaries for the messages between the two
  10164. indexes, inclusive.</para>
  10165. <para>It should be noted that if another client has modified any message
  10166. in the folder, the IMAP server may choose to return information that was
  10167. not explicitly requested. It is therefore important to be prepared to
  10168. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  10169. messages that were requested as well as summaries for messages that were
  10170. not requested at all.</para>
  10171. </remarks>
  10172. <returns>An enumeration of summaries for the requested messages.</returns>
  10173. <param name="min">The minimum index.</param>
  10174. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  10175. <param name="items">The message summary items to fetch.</param>
  10176. <param name="cancellationToken">The cancellation token.</param>
  10177. <exception cref="T:System.ArgumentOutOfRangeException">
  10178. <para><paramref name="min"/> is out of range.</para>
  10179. <para>-or-</para>
  10180. <para><paramref name="max"/> is out of range.</para>
  10181. <para>-or-</para>
  10182. <para><paramref name="items"/> is empty.</para>
  10183. </exception>
  10184. <exception cref="T:System.ObjectDisposedException">
  10185. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10186. </exception>
  10187. <exception cref="T:MailKit.ServiceNotConnectedException">
  10188. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10189. </exception>
  10190. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10191. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10192. </exception>
  10193. <exception cref="T:MailKit.FolderNotOpenException">
  10194. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10195. </exception>
  10196. <exception cref="T:System.OperationCanceledException">
  10197. The operation was canceled via the cancellation token.
  10198. </exception>
  10199. <exception cref="T:System.IO.IOException">
  10200. An I/O error occurred.
  10201. </exception>
  10202. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10203. The server's response contained unexpected tokens.
  10204. </exception>
  10205. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10206. The server replied with a NO or BAD response.
  10207. </exception>
  10208. </member>
  10209. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  10210. <summary>
  10211. Asynchronously fetches the message summaries for the messages between the two indexes, inclusive.
  10212. </summary>
  10213. <remarks>
  10214. <para>Fetches the message summaries for the messages between the two
  10215. indexes, inclusive.</para>
  10216. <para>It should be noted that if another client has modified any message
  10217. in the folder, the IMAP server may choose to return information that was
  10218. not explicitly requested. It is therefore important to be prepared to
  10219. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  10220. messages that were requested as well as summaries for messages that were
  10221. not requested at all.</para>
  10222. </remarks>
  10223. <returns>An enumeration of summaries for the requested messages.</returns>
  10224. <param name="min">The minimum index.</param>
  10225. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  10226. <param name="items">The message summary items to fetch.</param>
  10227. <param name="cancellationToken">The cancellation token.</param>
  10228. <exception cref="T:System.ArgumentOutOfRangeException">
  10229. <para><paramref name="min"/> is out of range.</para>
  10230. <para>-or-</para>
  10231. <para><paramref name="max"/> is out of range.</para>
  10232. <para>-or-</para>
  10233. <para><paramref name="items"/> is empty.</para>
  10234. </exception>
  10235. <exception cref="T:System.ObjectDisposedException">
  10236. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10237. </exception>
  10238. <exception cref="T:MailKit.ServiceNotConnectedException">
  10239. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10240. </exception>
  10241. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10242. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10243. </exception>
  10244. <exception cref="T:MailKit.FolderNotOpenException">
  10245. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10246. </exception>
  10247. <exception cref="T:System.OperationCanceledException">
  10248. The operation was canceled via the cancellation token.
  10249. </exception>
  10250. <exception cref="T:System.IO.IOException">
  10251. An I/O error occurred.
  10252. </exception>
  10253. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10254. The server's response contained unexpected tokens.
  10255. </exception>
  10256. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10257. The server replied with a NO or BAD response.
  10258. </exception>
  10259. </member>
  10260. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  10261. <summary>
  10262. Fetches the message summaries for the messages between the two indexes, inclusive.
  10263. </summary>
  10264. <remarks>
  10265. <para>Fetches the message summaries for the messages between the two
  10266. indexes, inclusive.</para>
  10267. <para>It should be noted that if another client has modified any message
  10268. in the folder, the IMAP server may choose to return information that was
  10269. not explicitly requested. It is therefore important to be prepared to
  10270. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  10271. messages that were requested as well as summaries for messages that were
  10272. not requested at all.</para>
  10273. </remarks>
  10274. <returns>An enumeration of summaries for the requested messages.</returns>
  10275. <param name="min">The minimum index.</param>
  10276. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  10277. <param name="items">The message summary items to fetch.</param>
  10278. <param name="headers">The desired header fields.</param>
  10279. <param name="cancellationToken">The cancellation token.</param>
  10280. <exception cref="T:System.ArgumentOutOfRangeException">
  10281. <para><paramref name="min"/> is out of range.</para>
  10282. <para>-or-</para>
  10283. <para><paramref name="max"/> is out of range.</para>
  10284. </exception>
  10285. <exception cref="T:System.ArgumentNullException">
  10286. <paramref name="headers"/> is <c>null</c>.
  10287. </exception>
  10288. <exception cref="T:System.ObjectDisposedException">
  10289. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10290. </exception>
  10291. <exception cref="T:MailKit.ServiceNotConnectedException">
  10292. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10293. </exception>
  10294. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10295. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10296. </exception>
  10297. <exception cref="T:MailKit.FolderNotOpenException">
  10298. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10299. </exception>
  10300. <exception cref="T:System.OperationCanceledException">
  10301. The operation was canceled via the cancellation token.
  10302. </exception>
  10303. <exception cref="T:System.IO.IOException">
  10304. An I/O error occurred.
  10305. </exception>
  10306. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10307. The server's response contained unexpected tokens.
  10308. </exception>
  10309. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10310. The server replied with a NO or BAD response.
  10311. </exception>
  10312. </member>
  10313. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  10314. <summary>
  10315. Asynchronously fetches the message summaries for the messages between the two indexes, inclusive.
  10316. </summary>
  10317. <remarks>
  10318. <para>Fetches the message summaries for the messages between the two
  10319. indexes, inclusive.</para>
  10320. <para>It should be noted that if another client has modified any message
  10321. in the folder, the IMAP server may choose to return information that was
  10322. not explicitly requested. It is therefore important to be prepared to
  10323. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  10324. messages that were requested as well as summaries for messages that were
  10325. not requested at all.</para>
  10326. </remarks>
  10327. <returns>An enumeration of summaries for the requested messages.</returns>
  10328. <param name="min">The minimum index.</param>
  10329. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  10330. <param name="items">The message summary items to fetch.</param>
  10331. <param name="headers">The desired header fields.</param>
  10332. <param name="cancellationToken">The cancellation token.</param>
  10333. <exception cref="T:System.ArgumentOutOfRangeException">
  10334. <para><paramref name="min"/> is out of range.</para>
  10335. <para>-or-</para>
  10336. <para><paramref name="max"/> is out of range.</para>
  10337. </exception>
  10338. <exception cref="T:System.ArgumentNullException">
  10339. <paramref name="headers"/> is <c>null</c>.
  10340. </exception>
  10341. <exception cref="T:System.ObjectDisposedException">
  10342. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10343. </exception>
  10344. <exception cref="T:MailKit.ServiceNotConnectedException">
  10345. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10346. </exception>
  10347. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10348. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10349. </exception>
  10350. <exception cref="T:MailKit.FolderNotOpenException">
  10351. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10352. </exception>
  10353. <exception cref="T:System.OperationCanceledException">
  10354. The operation was canceled via the cancellation token.
  10355. </exception>
  10356. <exception cref="T:System.IO.IOException">
  10357. An I/O error occurred.
  10358. </exception>
  10359. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10360. The server's response contained unexpected tokens.
  10361. </exception>
  10362. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10363. The server replied with a NO or BAD response.
  10364. </exception>
  10365. </member>
  10366. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  10367. <summary>
  10368. Fetches the message summaries for the messages between the two indexes, inclusive.
  10369. </summary>
  10370. <remarks>
  10371. <para>Fetches the message summaries for the messages between the two
  10372. indexes, inclusive.</para>
  10373. <para>It should be noted that if another client has modified any message
  10374. in the folder, the IMAP server may choose to return information that was
  10375. not explicitly requested. It is therefore important to be prepared to
  10376. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  10377. messages that were requested as well as summaries for messages that were
  10378. not requested at all.</para>
  10379. </remarks>
  10380. <returns>An enumeration of summaries for the requested messages.</returns>
  10381. <param name="min">The minimum index.</param>
  10382. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  10383. <param name="items">The message summary items to fetch.</param>
  10384. <param name="headers">The desired header fields.</param>
  10385. <param name="cancellationToken">The cancellation token.</param>
  10386. <exception cref="T:System.ArgumentOutOfRangeException">
  10387. <para><paramref name="min"/> is out of range.</para>
  10388. <para>-or-</para>
  10389. <para><paramref name="max"/> is out of range.</para>
  10390. </exception>
  10391. <exception cref="T:System.ArgumentNullException">
  10392. <paramref name="headers"/> is <c>null</c>.
  10393. </exception>
  10394. <exception cref="T:System.ArgumentException">
  10395. One or more of the specified <paramref name="headers"/> is invalid.
  10396. </exception>
  10397. <exception cref="T:System.ObjectDisposedException">
  10398. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10399. </exception>
  10400. <exception cref="T:MailKit.ServiceNotConnectedException">
  10401. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10402. </exception>
  10403. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10404. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10405. </exception>
  10406. <exception cref="T:MailKit.FolderNotOpenException">
  10407. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10408. </exception>
  10409. <exception cref="T:System.OperationCanceledException">
  10410. The operation was canceled via the cancellation token.
  10411. </exception>
  10412. <exception cref="T:System.IO.IOException">
  10413. An I/O error occurred.
  10414. </exception>
  10415. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10416. The server's response contained unexpected tokens.
  10417. </exception>
  10418. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10419. The server replied with a NO or BAD response.
  10420. </exception>
  10421. </member>
  10422. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  10423. <summary>
  10424. Asynchronously fetches the message summaries for the messages between the two indexes, inclusive.
  10425. </summary>
  10426. <remarks>
  10427. <para>Fetches the message summaries for the messages between the two
  10428. indexes, inclusive.</para>
  10429. <para>It should be noted that if another client has modified any message
  10430. in the folder, the IMAP server may choose to return information that was
  10431. not explicitly requested. It is therefore important to be prepared to
  10432. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  10433. messages that were requested as well as summaries for messages that were
  10434. not requested at all.</para>
  10435. </remarks>
  10436. <returns>An enumeration of summaries for the requested messages.</returns>
  10437. <param name="min">The minimum index.</param>
  10438. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  10439. <param name="items">The message summary items to fetch.</param>
  10440. <param name="headers">The desired header fields.</param>
  10441. <param name="cancellationToken">The cancellation token.</param>
  10442. <exception cref="T:System.ArgumentOutOfRangeException">
  10443. <para><paramref name="min"/> is out of range.</para>
  10444. <para>-or-</para>
  10445. <para><paramref name="max"/> is out of range.</para>
  10446. </exception>
  10447. <exception cref="T:System.ArgumentNullException">
  10448. <paramref name="headers"/> is <c>null</c>.
  10449. </exception>
  10450. <exception cref="T:System.ArgumentException">
  10451. One or more of the specified <paramref name="headers"/> is invalid.
  10452. </exception>
  10453. <exception cref="T:System.ObjectDisposedException">
  10454. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10455. </exception>
  10456. <exception cref="T:MailKit.ServiceNotConnectedException">
  10457. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10458. </exception>
  10459. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10460. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10461. </exception>
  10462. <exception cref="T:MailKit.FolderNotOpenException">
  10463. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10464. </exception>
  10465. <exception cref="T:System.OperationCanceledException">
  10466. The operation was canceled via the cancellation token.
  10467. </exception>
  10468. <exception cref="T:System.IO.IOException">
  10469. An I/O error occurred.
  10470. </exception>
  10471. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10472. The server's response contained unexpected tokens.
  10473. </exception>
  10474. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10475. The server replied with a NO or BAD response.
  10476. </exception>
  10477. </member>
  10478. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  10479. <summary>
  10480. Fetches the message summaries for the messages between the two indexes (inclusive)
  10481. that have a higher mod-sequence value than the one specified.
  10482. </summary>
  10483. <remarks>
  10484. <para>Fetches the message summaries for the messages between the two
  10485. indexes (inclusive) that have a higher mod-sequence value than the one
  10486. specified.</para>
  10487. <para>It should be noted that if another client has modified any message
  10488. in the folder, the IMAP server may choose to return information that was
  10489. not explicitly requested. It is therefore important to be prepared to
  10490. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  10491. messages that were requested as well as summaries for messages that were
  10492. not requested at all.</para>
  10493. </remarks>
  10494. <returns>An enumeration of summaries for the requested messages.</returns>
  10495. <param name="min">The minimum index.</param>
  10496. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  10497. <param name="modseq">The mod-sequence value.</param>
  10498. <param name="items">The message summary items to fetch.</param>
  10499. <param name="cancellationToken">The cancellation token.</param>
  10500. <exception cref="T:System.ArgumentOutOfRangeException">
  10501. <para><paramref name="min"/> is out of range.</para>
  10502. <para>-or-</para>
  10503. <para><paramref name="max"/> is out of range.</para>
  10504. <para>-or-</para>
  10505. <para><paramref name="items"/> is empty.</para>
  10506. </exception>
  10507. <exception cref="T:System.ObjectDisposedException">
  10508. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10509. </exception>
  10510. <exception cref="T:MailKit.ServiceNotConnectedException">
  10511. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10512. </exception>
  10513. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10514. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10515. </exception>
  10516. <exception cref="T:MailKit.FolderNotOpenException">
  10517. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10518. </exception>
  10519. <exception cref="T:System.NotSupportedException">
  10520. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  10521. </exception>
  10522. <exception cref="T:System.OperationCanceledException">
  10523. The operation was canceled via the cancellation token.
  10524. </exception>
  10525. <exception cref="T:System.IO.IOException">
  10526. An I/O error occurred.
  10527. </exception>
  10528. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10529. The server's response contained unexpected tokens.
  10530. </exception>
  10531. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10532. The server replied with a NO or BAD response.
  10533. </exception>
  10534. </member>
  10535. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  10536. <summary>
  10537. Asynchronously fetches the message summaries for the messages between the two indexes (inclusive)
  10538. that have a higher mod-sequence value than the one specified.
  10539. </summary>
  10540. <remarks>
  10541. <para>Fetches the message summaries for the messages between the two
  10542. indexes (inclusive) that have a higher mod-sequence value than the one
  10543. specified.</para>
  10544. <para>It should be noted that if another client has modified any message
  10545. in the folder, the IMAP server may choose to return information that was
  10546. not explicitly requested. It is therefore important to be prepared to
  10547. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  10548. messages that were requested as well as summaries for messages that were
  10549. not requested at all.</para>
  10550. </remarks>
  10551. <returns>An enumeration of summaries for the requested messages.</returns>
  10552. <param name="min">The minimum index.</param>
  10553. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  10554. <param name="modseq">The mod-sequence value.</param>
  10555. <param name="items">The message summary items to fetch.</param>
  10556. <param name="cancellationToken">The cancellation token.</param>
  10557. <exception cref="T:System.ArgumentOutOfRangeException">
  10558. <para><paramref name="min"/> is out of range.</para>
  10559. <para>-or-</para>
  10560. <para><paramref name="max"/> is out of range.</para>
  10561. <para>-or-</para>
  10562. <para><paramref name="items"/> is empty.</para>
  10563. </exception>
  10564. <exception cref="T:System.ObjectDisposedException">
  10565. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10566. </exception>
  10567. <exception cref="T:MailKit.ServiceNotConnectedException">
  10568. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10569. </exception>
  10570. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10571. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10572. </exception>
  10573. <exception cref="T:MailKit.FolderNotOpenException">
  10574. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10575. </exception>
  10576. <exception cref="T:System.NotSupportedException">
  10577. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  10578. </exception>
  10579. <exception cref="T:System.OperationCanceledException">
  10580. The operation was canceled via the cancellation token.
  10581. </exception>
  10582. <exception cref="T:System.IO.IOException">
  10583. An I/O error occurred.
  10584. </exception>
  10585. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10586. The server's response contained unexpected tokens.
  10587. </exception>
  10588. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10589. The server replied with a NO or BAD response.
  10590. </exception>
  10591. </member>
  10592. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  10593. <summary>
  10594. Fetches the message summaries for the messages between the two indexes (inclusive)
  10595. that have a higher mod-sequence value than the one specified.
  10596. </summary>
  10597. <remarks>
  10598. <para>Fetches the message summaries for the messages between the two
  10599. indexes (inclusive) that have a higher mod-sequence value than the one
  10600. specified.</para>
  10601. <para>It should be noted that if another client has modified any message
  10602. in the folder, the IMAP server may choose to return information that was
  10603. not explicitly requested. It is therefore important to be prepared to
  10604. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  10605. messages that were requested as well as summaries for messages that were
  10606. not requested at all.</para>
  10607. </remarks>
  10608. <returns>An enumeration of summaries for the requested messages.</returns>
  10609. <param name="min">The minimum index.</param>
  10610. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  10611. <param name="modseq">The mod-sequence value.</param>
  10612. <param name="items">The message summary items to fetch.</param>
  10613. <param name="headers">The desired header fields.</param>
  10614. <param name="cancellationToken">The cancellation token.</param>
  10615. <exception cref="T:System.ArgumentOutOfRangeException">
  10616. <para><paramref name="min"/> is out of range.</para>
  10617. <para>-or-</para>
  10618. <para><paramref name="max"/> is out of range.</para>
  10619. </exception>
  10620. <exception cref="T:System.ArgumentNullException">
  10621. <paramref name="headers"/> is <c>null</c>.
  10622. </exception>
  10623. <exception cref="T:System.ObjectDisposedException">
  10624. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10625. </exception>
  10626. <exception cref="T:MailKit.ServiceNotConnectedException">
  10627. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10628. </exception>
  10629. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10630. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10631. </exception>
  10632. <exception cref="T:MailKit.FolderNotOpenException">
  10633. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10634. </exception>
  10635. <exception cref="T:System.NotSupportedException">
  10636. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  10637. </exception>
  10638. <exception cref="T:System.OperationCanceledException">
  10639. The operation was canceled via the cancellation token.
  10640. </exception>
  10641. <exception cref="T:System.IO.IOException">
  10642. An I/O error occurred.
  10643. </exception>
  10644. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10645. The server's response contained unexpected tokens.
  10646. </exception>
  10647. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10648. The server replied with a NO or BAD response.
  10649. </exception>
  10650. </member>
  10651. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  10652. <summary>
  10653. Asynchronously fetches the message summaries for the messages between the two indexes (inclusive)
  10654. that have a higher mod-sequence value than the one specified.
  10655. </summary>
  10656. <remarks>
  10657. <para>Fetches the message summaries for the messages between the two
  10658. indexes (inclusive) that have a higher mod-sequence value than the one
  10659. specified.</para>
  10660. <para>It should be noted that if another client has modified any message
  10661. in the folder, the IMAP server may choose to return information that was
  10662. not explicitly requested. It is therefore important to be prepared to
  10663. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  10664. messages that were requested as well as summaries for messages that were
  10665. not requested at all.</para>
  10666. </remarks>
  10667. <returns>An enumeration of summaries for the requested messages.</returns>
  10668. <param name="min">The minimum index.</param>
  10669. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  10670. <param name="modseq">The mod-sequence value.</param>
  10671. <param name="items">The message summary items to fetch.</param>
  10672. <param name="headers">The desired header fields.</param>
  10673. <param name="cancellationToken">The cancellation token.</param>
  10674. <exception cref="T:System.ArgumentOutOfRangeException">
  10675. <para><paramref name="min"/> is out of range.</para>
  10676. <para>-or-</para>
  10677. <para><paramref name="max"/> is out of range.</para>
  10678. </exception>
  10679. <exception cref="T:System.ArgumentNullException">
  10680. <paramref name="headers"/> is <c>null</c>.
  10681. </exception>
  10682. <exception cref="T:System.ObjectDisposedException">
  10683. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10684. </exception>
  10685. <exception cref="T:MailKit.ServiceNotConnectedException">
  10686. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10687. </exception>
  10688. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10689. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10690. </exception>
  10691. <exception cref="T:MailKit.FolderNotOpenException">
  10692. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10693. </exception>
  10694. <exception cref="T:System.NotSupportedException">
  10695. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  10696. </exception>
  10697. <exception cref="T:System.OperationCanceledException">
  10698. The operation was canceled via the cancellation token.
  10699. </exception>
  10700. <exception cref="T:System.IO.IOException">
  10701. An I/O error occurred.
  10702. </exception>
  10703. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10704. The server's response contained unexpected tokens.
  10705. </exception>
  10706. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10707. The server replied with a NO or BAD response.
  10708. </exception>
  10709. </member>
  10710. <member name="M:MailKit.Net.Imap.ImapFolder.Fetch(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  10711. <summary>
  10712. Fetches the message summaries for the messages between the two indexes (inclusive)
  10713. that have a higher mod-sequence value than the one specified.
  10714. </summary>
  10715. <remarks>
  10716. <para>Fetches the message summaries for the messages between the two
  10717. indexes (inclusive) that have a higher mod-sequence value than the one
  10718. specified.</para>
  10719. <para>It should be noted that if another client has modified any message
  10720. in the folder, the IMAP server may choose to return information that was
  10721. not explicitly requested. It is therefore important to be prepared to
  10722. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  10723. messages that were requested as well as summaries for messages that were
  10724. not requested at all.</para>
  10725. </remarks>
  10726. <returns>An enumeration of summaries for the requested messages.</returns>
  10727. <param name="min">The minimum index.</param>
  10728. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  10729. <param name="modseq">The mod-sequence value.</param>
  10730. <param name="items">The message summary items to fetch.</param>
  10731. <param name="headers">The desired header fields.</param>
  10732. <param name="cancellationToken">The cancellation token.</param>
  10733. <exception cref="T:System.ArgumentOutOfRangeException">
  10734. <para><paramref name="min"/> is out of range.</para>
  10735. <para>-or-</para>
  10736. <para><paramref name="max"/> is out of range.</para>
  10737. </exception>
  10738. <exception cref="T:System.ArgumentNullException">
  10739. <paramref name="headers"/> is <c>null</c>.
  10740. </exception>
  10741. <exception cref="T:System.ArgumentException">
  10742. One or more of the specified <paramref name="headers"/> is invalid.
  10743. </exception>
  10744. <exception cref="T:System.ObjectDisposedException">
  10745. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10746. </exception>
  10747. <exception cref="T:MailKit.ServiceNotConnectedException">
  10748. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10749. </exception>
  10750. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10751. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10752. </exception>
  10753. <exception cref="T:MailKit.FolderNotOpenException">
  10754. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10755. </exception>
  10756. <exception cref="T:System.NotSupportedException">
  10757. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  10758. </exception>
  10759. <exception cref="T:System.OperationCanceledException">
  10760. The operation was canceled via the cancellation token.
  10761. </exception>
  10762. <exception cref="T:System.IO.IOException">
  10763. An I/O error occurred.
  10764. </exception>
  10765. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10766. The server's response contained unexpected tokens.
  10767. </exception>
  10768. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10769. The server replied with a NO or BAD response.
  10770. </exception>
  10771. </member>
  10772. <member name="M:MailKit.Net.Imap.ImapFolder.FetchAsync(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  10773. <summary>
  10774. Asynchronously fetches the message summaries for the messages between the two indexes (inclusive)
  10775. that have a higher mod-sequence value than the one specified.
  10776. </summary>
  10777. <remarks>
  10778. <para>Fetches the message summaries for the messages between the two
  10779. indexes (inclusive) that have a higher mod-sequence value than the one
  10780. specified.</para>
  10781. <para>It should be noted that if another client has modified any message
  10782. in the folder, the IMAP server may choose to return information that was
  10783. not explicitly requested. It is therefore important to be prepared to
  10784. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  10785. messages that were requested as well as summaries for messages that were
  10786. not requested at all.</para>
  10787. </remarks>
  10788. <returns>An enumeration of summaries for the requested messages.</returns>
  10789. <param name="min">The minimum index.</param>
  10790. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  10791. <param name="modseq">The mod-sequence value.</param>
  10792. <param name="items">The message summary items to fetch.</param>
  10793. <param name="headers">The desired header fields.</param>
  10794. <param name="cancellationToken">The cancellation token.</param>
  10795. <exception cref="T:System.ArgumentOutOfRangeException">
  10796. <para><paramref name="min"/> is out of range.</para>
  10797. <para>-or-</para>
  10798. <para><paramref name="max"/> is out of range.</para>
  10799. </exception>
  10800. <exception cref="T:System.ArgumentNullException">
  10801. <paramref name="headers"/> is <c>null</c>.
  10802. </exception>
  10803. <exception cref="T:System.ArgumentException">
  10804. One or more of the specified <paramref name="headers"/> is invalid.
  10805. </exception>
  10806. <exception cref="T:System.ObjectDisposedException">
  10807. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10808. </exception>
  10809. <exception cref="T:MailKit.ServiceNotConnectedException">
  10810. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10811. </exception>
  10812. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10813. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10814. </exception>
  10815. <exception cref="T:MailKit.FolderNotOpenException">
  10816. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10817. </exception>
  10818. <exception cref="T:System.NotSupportedException">
  10819. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  10820. </exception>
  10821. <exception cref="T:System.OperationCanceledException">
  10822. The operation was canceled via the cancellation token.
  10823. </exception>
  10824. <exception cref="T:System.IO.IOException">
  10825. An I/O error occurred.
  10826. </exception>
  10827. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10828. The server's response contained unexpected tokens.
  10829. </exception>
  10830. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10831. The server replied with a NO or BAD response.
  10832. </exception>
  10833. </member>
  10834. <member name="M:MailKit.Net.Imap.ImapFolder.CreateStream(System.Nullable{MailKit.UniqueId},System.String,System.Int32,System.Int32)">
  10835. <summary>
  10836. Create a backing stream for use with the GetMessage, GetBodyPart, and GetStream methods.
  10837. </summary>
  10838. <remarks>
  10839. <para>Allows subclass implementations to override the type of stream
  10840. created for use with the GetMessage, GetBodyPart and GetStream methods.</para>
  10841. <para>This could be useful for subclass implementations that intend to implement
  10842. support for caching and/or for subclass implementations that want to use
  10843. temporary file streams instead of memory-based streams for larger amounts of
  10844. message data.</para>
  10845. <para>Subclasses that implement caching using this API should wait for
  10846. <see cref="M:MailKit.Net.Imap.ImapFolder.CommitStream(System.IO.Stream,MailKit.UniqueId,System.String,System.Int32,System.Int32)"/> before adding the stream to their cache.</para>
  10847. <para>Streams returned by this method SHOULD clean up any allocated resources
  10848. such as deleting temporary files from the file system.</para>
  10849. <note type="note">The <paramref name="uid"/> will not be available for the various
  10850. GetMessage(), GetBodyPart() and GetStream() methods that take a message index rather
  10851. than a <see cref="T:MailKit.UniqueId"/>. It may also not be available if the IMAP server
  10852. response does not specify the <c>UID</c> value prior to sending the <c>literal-string</c>
  10853. token containing the message stream.</note>
  10854. </remarks>
  10855. <seealso cref="M:MailKit.Net.Imap.ImapFolder.CommitStream(System.IO.Stream,MailKit.UniqueId,System.String,System.Int32,System.Int32)"/>
  10856. <returns>The stream.</returns>
  10857. <param name="uid">The unique identifier of the message, if available.</param>
  10858. <param name="section">The section of the message that is being fetched.</param>
  10859. <param name="offset">The starting offset of the message section being fetched.</param>
  10860. <param name="length">The length of the stream being fetched, measured in bytes.</param>
  10861. </member>
  10862. <member name="M:MailKit.Net.Imap.ImapFolder.CommitStream(System.IO.Stream,MailKit.UniqueId,System.String,System.Int32,System.Int32)">
  10863. <summary>
  10864. Commit a stream returned by <see cref="M:MailKit.Net.Imap.ImapFolder.CreateStream(System.Nullable{MailKit.UniqueId},System.String,System.Int32,System.Int32)"/>.
  10865. </summary>
  10866. <remarks>
  10867. <para>Commits a stream returned by <see cref="M:MailKit.Net.Imap.ImapFolder.CreateStream(System.Nullable{MailKit.UniqueId},System.String,System.Int32,System.Int32)"/>.</para>
  10868. <para>This method is called only after both the message data has successfully
  10869. been written to the stream returned by <see cref="M:MailKit.Net.Imap.ImapFolder.CreateStream(System.Nullable{MailKit.UniqueId},System.String,System.Int32,System.Int32)"/> and a
  10870. <see cref="T:MailKit.UniqueId"/> has been obtained for the associated message.</para>
  10871. <para>For subclasses implementing caching, this method should be used for
  10872. committing the stream to their cache.</para>
  10873. <note type="note">Subclass implementations may take advantage of the fact that
  10874. <see cref="M:MailKit.Net.Imap.ImapFolder.CommitStream(System.IO.Stream,MailKit.UniqueId,System.String,System.Int32,System.Int32)"/> allows returning a new <see cref="T:System.IO.Stream"/>
  10875. reference if they move a file on the file system and wish to return a new
  10876. <see cref="T:System.IO.FileStream"/> based on the new path, for example.</note>
  10877. </remarks>
  10878. <seealso cref="M:MailKit.Net.Imap.ImapFolder.CreateStream(System.Nullable{MailKit.UniqueId},System.String,System.Int32,System.Int32)"/>
  10879. <returns>The stream.</returns>
  10880. <param name="stream">The stream.</param>
  10881. <param name="uid">The unique identifier of the message.</param>
  10882. <param name="section">The section of the message that the stream represents.</param>
  10883. <param name="offset">The starting offset of the message section.</param>
  10884. <param name="length">The length of the stream, measured in bytes.</param>
  10885. </member>
  10886. <member name="M:MailKit.Net.Imap.ImapFolder.GetHeaders(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  10887. <summary>
  10888. Get the specified message headers.
  10889. </summary>
  10890. <remarks>
  10891. Gets the specified message headers.
  10892. </remarks>
  10893. <returns>The message headers.</returns>
  10894. <param name="uid">The UID of the message.</param>
  10895. <param name="cancellationToken">The cancellation token.</param>
  10896. <param name="progress">The progress reporting mechanism.</param>
  10897. <exception cref="T:System.ArgumentException">
  10898. <paramref name="uid"/> is invalid.
  10899. </exception>
  10900. <exception cref="T:System.ObjectDisposedException">
  10901. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10902. </exception>
  10903. <exception cref="T:MailKit.ServiceNotConnectedException">
  10904. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10905. </exception>
  10906. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10907. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10908. </exception>
  10909. <exception cref="T:MailKit.FolderNotOpenException">
  10910. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10911. </exception>
  10912. <exception cref="T:MailKit.MessageNotFoundException">
  10913. The IMAP server did not return the requested message headers.
  10914. </exception>
  10915. <exception cref="T:System.OperationCanceledException">
  10916. The operation was canceled via the cancellation token.
  10917. </exception>
  10918. <exception cref="T:System.IO.IOException">
  10919. An I/O error occurred.
  10920. </exception>
  10921. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10922. The server's response contained unexpected tokens.
  10923. </exception>
  10924. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10925. The server replied with a NO or BAD response.
  10926. </exception>
  10927. </member>
  10928. <member name="M:MailKit.Net.Imap.ImapFolder.GetHeadersAsync(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  10929. <summary>
  10930. Asynchronously get the specified message headers.
  10931. </summary>
  10932. <remarks>
  10933. Gets the specified message headers.
  10934. </remarks>
  10935. <returns>The message headers.</returns>
  10936. <param name="uid">The UID of the message.</param>
  10937. <param name="cancellationToken">The cancellation token.</param>
  10938. <param name="progress">The progress reporting mechanism.</param>
  10939. <exception cref="T:System.ArgumentException">
  10940. <paramref name="uid"/> is invalid.
  10941. </exception>
  10942. <exception cref="T:System.ObjectDisposedException">
  10943. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10944. </exception>
  10945. <exception cref="T:MailKit.ServiceNotConnectedException">
  10946. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10947. </exception>
  10948. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10949. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10950. </exception>
  10951. <exception cref="T:MailKit.FolderNotOpenException">
  10952. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10953. </exception>
  10954. <exception cref="T:MailKit.MessageNotFoundException">
  10955. The IMAP server did not return the requested message headers.
  10956. </exception>
  10957. <exception cref="T:System.OperationCanceledException">
  10958. The operation was canceled via the cancellation token.
  10959. </exception>
  10960. <exception cref="T:System.IO.IOException">
  10961. An I/O error occurred.
  10962. </exception>
  10963. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  10964. The server's response contained unexpected tokens.
  10965. </exception>
  10966. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  10967. The server replied with a NO or BAD response.
  10968. </exception>
  10969. </member>
  10970. <member name="M:MailKit.Net.Imap.ImapFolder.GetHeaders(MailKit.UniqueId,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  10971. <summary>
  10972. Get the specified body part headers.
  10973. </summary>
  10974. <remarks>
  10975. Gets the specified body part headers.
  10976. </remarks>
  10977. <returns>The body part headers.</returns>
  10978. <param name="uid">The UID of the message.</param>
  10979. <param name="partSpecifier">The body part specifier.</param>
  10980. <param name="cancellationToken">The cancellation token.</param>
  10981. <param name="progress">The progress reporting mechanism.</param>
  10982. <exception cref="T:System.ArgumentNullException">
  10983. <paramref name="partSpecifier"/> is <c>null</c>.
  10984. </exception>
  10985. <exception cref="T:System.ArgumentException">
  10986. <paramref name="uid"/> is invalid.
  10987. </exception>
  10988. <exception cref="T:System.ObjectDisposedException">
  10989. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  10990. </exception>
  10991. <exception cref="T:MailKit.ServiceNotConnectedException">
  10992. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  10993. </exception>
  10994. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  10995. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  10996. </exception>
  10997. <exception cref="T:MailKit.FolderNotOpenException">
  10998. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  10999. </exception>
  11000. <exception cref="T:MailKit.MessageNotFoundException">
  11001. The IMAP server did not return the requested body part headers.
  11002. </exception>
  11003. <exception cref="T:System.OperationCanceledException">
  11004. The operation was canceled via the cancellation token.
  11005. </exception>
  11006. <exception cref="T:System.IO.IOException">
  11007. An I/O error occurred.
  11008. </exception>
  11009. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11010. The server's response contained unexpected tokens.
  11011. </exception>
  11012. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11013. The server replied with a NO or BAD response.
  11014. </exception>
  11015. </member>
  11016. <member name="M:MailKit.Net.Imap.ImapFolder.GetHeadersAsync(MailKit.UniqueId,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11017. <summary>
  11018. Asynchronously get the specified body part headers.
  11019. </summary>
  11020. <remarks>
  11021. Gets the specified body part headers.
  11022. </remarks>
  11023. <returns>The body part headers.</returns>
  11024. <param name="uid">The UID of the message.</param>
  11025. <param name="partSpecifier">The body part specifier.</param>
  11026. <param name="cancellationToken">The cancellation token.</param>
  11027. <param name="progress">The progress reporting mechanism.</param>
  11028. <exception cref="T:System.ArgumentNullException">
  11029. <paramref name="partSpecifier"/> is <c>null</c>.
  11030. </exception>
  11031. <exception cref="T:System.ArgumentException">
  11032. <paramref name="uid"/> is invalid.
  11033. </exception>
  11034. <exception cref="T:System.ObjectDisposedException">
  11035. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11036. </exception>
  11037. <exception cref="T:MailKit.ServiceNotConnectedException">
  11038. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11039. </exception>
  11040. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11041. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11042. </exception>
  11043. <exception cref="T:MailKit.FolderNotOpenException">
  11044. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11045. </exception>
  11046. <exception cref="T:MailKit.MessageNotFoundException">
  11047. The IMAP server did not return the requested body part headers.
  11048. </exception>
  11049. <exception cref="T:System.OperationCanceledException">
  11050. The operation was canceled via the cancellation token.
  11051. </exception>
  11052. <exception cref="T:System.IO.IOException">
  11053. An I/O error occurred.
  11054. </exception>
  11055. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11056. The server's response contained unexpected tokens.
  11057. </exception>
  11058. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11059. The server replied with a NO or BAD response.
  11060. </exception>
  11061. </member>
  11062. <member name="M:MailKit.Net.Imap.ImapFolder.GetHeaders(MailKit.UniqueId,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11063. <summary>
  11064. Get the specified body part headers.
  11065. </summary>
  11066. <remarks>
  11067. Gets the specified body part headers.
  11068. </remarks>
  11069. <returns>The body part headers.</returns>
  11070. <param name="uid">The UID of the message.</param>
  11071. <param name="part">The body part.</param>
  11072. <param name="cancellationToken">The cancellation token.</param>
  11073. <param name="progress">The progress reporting mechanism.</param>
  11074. <exception cref="T:System.ArgumentNullException">
  11075. <paramref name="part"/> is <c>null</c>.
  11076. </exception>
  11077. <exception cref="T:System.ArgumentException">
  11078. <paramref name="uid"/> is invalid.
  11079. </exception>
  11080. <exception cref="T:System.ObjectDisposedException">
  11081. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11082. </exception>
  11083. <exception cref="T:MailKit.ServiceNotConnectedException">
  11084. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11085. </exception>
  11086. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11087. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11088. </exception>
  11089. <exception cref="T:MailKit.FolderNotOpenException">
  11090. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11091. </exception>
  11092. <exception cref="T:MailKit.MessageNotFoundException">
  11093. The IMAP server did not return the requested body part headers.
  11094. </exception>
  11095. <exception cref="T:System.OperationCanceledException">
  11096. The operation was canceled via the cancellation token.
  11097. </exception>
  11098. <exception cref="T:System.IO.IOException">
  11099. An I/O error occurred.
  11100. </exception>
  11101. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11102. The server's response contained unexpected tokens.
  11103. </exception>
  11104. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11105. The server replied with a NO or BAD response.
  11106. </exception>
  11107. </member>
  11108. <member name="M:MailKit.Net.Imap.ImapFolder.GetHeadersAsync(MailKit.UniqueId,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11109. <summary>
  11110. Asynchronously get the specified body part headers.
  11111. </summary>
  11112. <remarks>
  11113. Gets the specified body part headers.
  11114. </remarks>
  11115. <returns>The body part headers.</returns>
  11116. <param name="uid">The UID of the message.</param>
  11117. <param name="part">The body part.</param>
  11118. <param name="cancellationToken">The cancellation token.</param>
  11119. <param name="progress">The progress reporting mechanism.</param>
  11120. <exception cref="T:System.ArgumentNullException">
  11121. <paramref name="part"/> is <c>null</c>.
  11122. </exception>
  11123. <exception cref="T:System.ArgumentException">
  11124. <paramref name="uid"/> is invalid.
  11125. </exception>
  11126. <exception cref="T:System.ObjectDisposedException">
  11127. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11128. </exception>
  11129. <exception cref="T:MailKit.ServiceNotConnectedException">
  11130. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11131. </exception>
  11132. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11133. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11134. </exception>
  11135. <exception cref="T:MailKit.FolderNotOpenException">
  11136. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11137. </exception>
  11138. <exception cref="T:MailKit.MessageNotFoundException">
  11139. The IMAP server did not return the requested body part headers.
  11140. </exception>
  11141. <exception cref="T:System.OperationCanceledException">
  11142. The operation was canceled via the cancellation token.
  11143. </exception>
  11144. <exception cref="T:System.IO.IOException">
  11145. An I/O error occurred.
  11146. </exception>
  11147. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11148. The server's response contained unexpected tokens.
  11149. </exception>
  11150. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11151. The server replied with a NO or BAD response.
  11152. </exception>
  11153. </member>
  11154. <member name="M:MailKit.Net.Imap.ImapFolder.GetHeaders(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11155. <summary>
  11156. Get the specified message headers.
  11157. </summary>
  11158. <remarks>
  11159. Gets the specified message headers.
  11160. </remarks>
  11161. <returns>The message headers.</returns>
  11162. <param name="index">The index of the message.</param>
  11163. <param name="cancellationToken">The cancellation token.</param>
  11164. <param name="progress">The progress reporting mechanism.</param>
  11165. <exception cref="T:System.ArgumentOutOfRangeException">
  11166. <paramref name="index"/> is out of range.
  11167. </exception>
  11168. <exception cref="T:System.ObjectDisposedException">
  11169. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11170. </exception>
  11171. <exception cref="T:MailKit.ServiceNotConnectedException">
  11172. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11173. </exception>
  11174. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11175. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11176. </exception>
  11177. <exception cref="T:MailKit.FolderNotOpenException">
  11178. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11179. </exception>
  11180. <exception cref="T:MailKit.MessageNotFoundException">
  11181. The IMAP server did not return the requested message headers.
  11182. </exception>
  11183. <exception cref="T:System.OperationCanceledException">
  11184. The operation was canceled via the cancellation token.
  11185. </exception>
  11186. <exception cref="T:System.IO.IOException">
  11187. An I/O error occurred.
  11188. </exception>
  11189. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11190. The server's response contained unexpected tokens.
  11191. </exception>
  11192. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11193. The server replied with a NO or BAD response.
  11194. </exception>
  11195. </member>
  11196. <member name="M:MailKit.Net.Imap.ImapFolder.GetHeadersAsync(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11197. <summary>
  11198. Asynchronously get the specified message headers.
  11199. </summary>
  11200. <remarks>
  11201. Gets the specified message headers.
  11202. </remarks>
  11203. <returns>The message headers.</returns>
  11204. <param name="index">The index of the message.</param>
  11205. <param name="cancellationToken">The cancellation token.</param>
  11206. <param name="progress">The progress reporting mechanism.</param>
  11207. <exception cref="T:System.ArgumentOutOfRangeException">
  11208. <paramref name="index"/> is out of range.
  11209. </exception>
  11210. <exception cref="T:System.ObjectDisposedException">
  11211. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11212. </exception>
  11213. <exception cref="T:MailKit.ServiceNotConnectedException">
  11214. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11215. </exception>
  11216. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11217. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11218. </exception>
  11219. <exception cref="T:MailKit.FolderNotOpenException">
  11220. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11221. </exception>
  11222. <exception cref="T:MailKit.MessageNotFoundException">
  11223. The IMAP server did not return the requested message headers.
  11224. </exception>
  11225. <exception cref="T:System.OperationCanceledException">
  11226. The operation was canceled via the cancellation token.
  11227. </exception>
  11228. <exception cref="T:System.IO.IOException">
  11229. An I/O error occurred.
  11230. </exception>
  11231. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11232. The server's response contained unexpected tokens.
  11233. </exception>
  11234. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11235. The server replied with a NO or BAD response.
  11236. </exception>
  11237. </member>
  11238. <member name="M:MailKit.Net.Imap.ImapFolder.GetHeaders(System.Int32,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11239. <summary>
  11240. Get the specified body part headers.
  11241. </summary>
  11242. <remarks>
  11243. Gets the specified body part headers.
  11244. </remarks>
  11245. <returns>The body part headers.</returns>
  11246. <param name="index">The index of the message.</param>
  11247. <param name="partSpecifier">The body part specifier.</param>
  11248. <param name="cancellationToken">The cancellation token.</param>
  11249. <param name="progress">The progress reporting mechanism.</param>
  11250. <exception cref="T:System.ArgumentOutOfRangeException">
  11251. <paramref name="index"/> is out of range.
  11252. </exception>
  11253. <exception cref="T:System.ArgumentNullException">
  11254. <paramref name="partSpecifier"/> is <c>null</c>.
  11255. </exception>
  11256. <exception cref="T:System.ObjectDisposedException">
  11257. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11258. </exception>
  11259. <exception cref="T:MailKit.ServiceNotConnectedException">
  11260. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11261. </exception>
  11262. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11263. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11264. </exception>
  11265. <exception cref="T:MailKit.FolderNotOpenException">
  11266. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11267. </exception>
  11268. <exception cref="T:MailKit.MessageNotFoundException">
  11269. The IMAP server did not return the requested body part headers.
  11270. </exception>
  11271. <exception cref="T:System.OperationCanceledException">
  11272. The operation was canceled via the cancellation token.
  11273. </exception>
  11274. <exception cref="T:System.IO.IOException">
  11275. An I/O error occurred.
  11276. </exception>
  11277. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11278. The server's response contained unexpected tokens.
  11279. </exception>
  11280. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11281. The server replied with a NO or BAD response.
  11282. </exception>
  11283. </member>
  11284. <member name="M:MailKit.Net.Imap.ImapFolder.GetHeadersAsync(System.Int32,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11285. <summary>
  11286. Asynchronously get the specified body part headers.
  11287. </summary>
  11288. <remarks>
  11289. Gets the specified body part headers.
  11290. </remarks>
  11291. <returns>The body part headers.</returns>
  11292. <param name="index">The index of the message.</param>
  11293. <param name="partSpecifier">The body part specifier.</param>
  11294. <param name="cancellationToken">The cancellation token.</param>
  11295. <param name="progress">The progress reporting mechanism.</param>
  11296. <exception cref="T:System.ArgumentOutOfRangeException">
  11297. <paramref name="index"/> is out of range.
  11298. </exception>
  11299. <exception cref="T:System.ArgumentNullException">
  11300. <paramref name="partSpecifier"/> is <c>null</c>.
  11301. </exception>
  11302. <exception cref="T:System.ObjectDisposedException">
  11303. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11304. </exception>
  11305. <exception cref="T:MailKit.ServiceNotConnectedException">
  11306. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11307. </exception>
  11308. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11309. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11310. </exception>
  11311. <exception cref="T:MailKit.FolderNotOpenException">
  11312. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11313. </exception>
  11314. <exception cref="T:MailKit.MessageNotFoundException">
  11315. The IMAP server did not return the requested body part headers.
  11316. </exception>
  11317. <exception cref="T:System.OperationCanceledException">
  11318. The operation was canceled via the cancellation token.
  11319. </exception>
  11320. <exception cref="T:System.IO.IOException">
  11321. An I/O error occurred.
  11322. </exception>
  11323. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11324. The server's response contained unexpected tokens.
  11325. </exception>
  11326. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11327. The server replied with a NO or BAD response.
  11328. </exception>
  11329. </member>
  11330. <member name="M:MailKit.Net.Imap.ImapFolder.GetHeaders(System.Int32,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11331. <summary>
  11332. Get the specified body part headers.
  11333. </summary>
  11334. <remarks>
  11335. Gets the specified body part headers.
  11336. </remarks>
  11337. <returns>The body part headers.</returns>
  11338. <param name="index">The index of the message.</param>
  11339. <param name="part">The body part.</param>
  11340. <param name="cancellationToken">The cancellation token.</param>
  11341. <param name="progress">The progress reporting mechanism.</param>
  11342. <exception cref="T:System.ArgumentOutOfRangeException">
  11343. <paramref name="index"/> is out of range.
  11344. </exception>
  11345. <exception cref="T:System.ArgumentNullException">
  11346. <paramref name="part"/> is <c>null</c>.
  11347. </exception>
  11348. <exception cref="T:System.ObjectDisposedException">
  11349. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11350. </exception>
  11351. <exception cref="T:MailKit.ServiceNotConnectedException">
  11352. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11353. </exception>
  11354. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11355. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11356. </exception>
  11357. <exception cref="T:MailKit.FolderNotOpenException">
  11358. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11359. </exception>
  11360. <exception cref="T:MailKit.MessageNotFoundException">
  11361. The IMAP server did not return the requested body part headers.
  11362. </exception>
  11363. <exception cref="T:System.OperationCanceledException">
  11364. The operation was canceled via the cancellation token.
  11365. </exception>
  11366. <exception cref="T:System.IO.IOException">
  11367. An I/O error occurred.
  11368. </exception>
  11369. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11370. The server's response contained unexpected tokens.
  11371. </exception>
  11372. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11373. The server replied with a NO or BAD response.
  11374. </exception>
  11375. </member>
  11376. <member name="M:MailKit.Net.Imap.ImapFolder.GetHeadersAsync(System.Int32,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11377. <summary>
  11378. Asynchronously get the specified body part headers.
  11379. </summary>
  11380. <remarks>
  11381. Gets the specified body part headers.
  11382. </remarks>
  11383. <returns>The body part headers.</returns>
  11384. <param name="index">The index of the message.</param>
  11385. <param name="part">The body part.</param>
  11386. <param name="cancellationToken">The cancellation token.</param>
  11387. <param name="progress">The progress reporting mechanism.</param>
  11388. <exception cref="T:System.ArgumentOutOfRangeException">
  11389. <paramref name="index"/> is out of range.
  11390. </exception>
  11391. <exception cref="T:System.ArgumentNullException">
  11392. <paramref name="part"/> is <c>null</c>.
  11393. </exception>
  11394. <exception cref="T:System.ObjectDisposedException">
  11395. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11396. </exception>
  11397. <exception cref="T:MailKit.ServiceNotConnectedException">
  11398. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11399. </exception>
  11400. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11401. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11402. </exception>
  11403. <exception cref="T:MailKit.FolderNotOpenException">
  11404. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11405. </exception>
  11406. <exception cref="T:MailKit.MessageNotFoundException">
  11407. The IMAP server did not return the requested body part headers.
  11408. </exception>
  11409. <exception cref="T:System.OperationCanceledException">
  11410. The operation was canceled via the cancellation token.
  11411. </exception>
  11412. <exception cref="T:System.IO.IOException">
  11413. An I/O error occurred.
  11414. </exception>
  11415. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11416. The server's response contained unexpected tokens.
  11417. </exception>
  11418. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11419. The server replied with a NO or BAD response.
  11420. </exception>
  11421. </member>
  11422. <member name="M:MailKit.Net.Imap.ImapFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11423. <summary>
  11424. Get the specified message.
  11425. </summary>
  11426. <remarks>
  11427. Gets the specified message.
  11428. </remarks>
  11429. <returns>The message.</returns>
  11430. <param name="uid">The UID of the message.</param>
  11431. <param name="cancellationToken">The cancellation token.</param>
  11432. <param name="progress">The progress reporting mechanism.</param>
  11433. <exception cref="T:System.ArgumentException">
  11434. <paramref name="uid"/> is invalid.
  11435. </exception>
  11436. <exception cref="T:System.ObjectDisposedException">
  11437. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11438. </exception>
  11439. <exception cref="T:MailKit.ServiceNotConnectedException">
  11440. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11441. </exception>
  11442. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11443. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11444. </exception>
  11445. <exception cref="T:MailKit.FolderNotOpenException">
  11446. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11447. </exception>
  11448. <exception cref="T:MailKit.MessageNotFoundException">
  11449. The IMAP server did not return the requested message.
  11450. </exception>
  11451. <exception cref="T:System.OperationCanceledException">
  11452. The operation was canceled via the cancellation token.
  11453. </exception>
  11454. <exception cref="T:System.IO.IOException">
  11455. An I/O error occurred.
  11456. </exception>
  11457. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11458. The server's response contained unexpected tokens.
  11459. </exception>
  11460. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11461. The server replied with a NO or BAD response.
  11462. </exception>
  11463. </member>
  11464. <member name="M:MailKit.Net.Imap.ImapFolder.GetMessageAsync(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11465. <summary>
  11466. Asynchronously get the specified message.
  11467. </summary>
  11468. <remarks>
  11469. Gets the specified message.
  11470. </remarks>
  11471. <returns>The message.</returns>
  11472. <param name="uid">The UID of the message.</param>
  11473. <param name="cancellationToken">The cancellation token.</param>
  11474. <param name="progress">The progress reporting mechanism.</param>
  11475. <exception cref="T:System.ArgumentException">
  11476. <paramref name="uid"/> is invalid.
  11477. </exception>
  11478. <exception cref="T:System.ObjectDisposedException">
  11479. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11480. </exception>
  11481. <exception cref="T:MailKit.ServiceNotConnectedException">
  11482. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11483. </exception>
  11484. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11485. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11486. </exception>
  11487. <exception cref="T:MailKit.FolderNotOpenException">
  11488. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11489. </exception>
  11490. <exception cref="T:MailKit.MessageNotFoundException">
  11491. The IMAP server did not return the requested message.
  11492. </exception>
  11493. <exception cref="T:System.OperationCanceledException">
  11494. The operation was canceled via the cancellation token.
  11495. </exception>
  11496. <exception cref="T:System.IO.IOException">
  11497. An I/O error occurred.
  11498. </exception>
  11499. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11500. The server's response contained unexpected tokens.
  11501. </exception>
  11502. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11503. The server replied with a NO or BAD response.
  11504. </exception>
  11505. </member>
  11506. <member name="M:MailKit.Net.Imap.ImapFolder.GetMessage(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11507. <summary>
  11508. Get the specified message.
  11509. </summary>
  11510. <remarks>
  11511. Gets the specified message.
  11512. </remarks>
  11513. <returns>The message.</returns>
  11514. <param name="index">The index of the message.</param>
  11515. <param name="cancellationToken">The cancellation token.</param>
  11516. <param name="progress">The progress reporting mechanism.</param>
  11517. <exception cref="T:System.ArgumentOutOfRangeException">
  11518. <paramref name="index"/> is out of range.
  11519. </exception>
  11520. <exception cref="T:System.ObjectDisposedException">
  11521. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11522. </exception>
  11523. <exception cref="T:MailKit.ServiceNotConnectedException">
  11524. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11525. </exception>
  11526. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11527. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11528. </exception>
  11529. <exception cref="T:MailKit.FolderNotOpenException">
  11530. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11531. </exception>
  11532. <exception cref="T:MailKit.MessageNotFoundException">
  11533. The IMAP server did not return the requested message.
  11534. </exception>
  11535. <exception cref="T:System.OperationCanceledException">
  11536. The operation was canceled via the cancellation token.
  11537. </exception>
  11538. <exception cref="T:System.IO.IOException">
  11539. An I/O error occurred.
  11540. </exception>
  11541. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11542. The server's response contained unexpected tokens.
  11543. </exception>
  11544. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11545. The server replied with a NO or BAD response.
  11546. </exception>
  11547. </member>
  11548. <member name="M:MailKit.Net.Imap.ImapFolder.GetMessageAsync(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11549. <summary>
  11550. Asynchronously get the specified message.
  11551. </summary>
  11552. <remarks>
  11553. Gets the specified message.
  11554. </remarks>
  11555. <returns>The message.</returns>
  11556. <param name="index">The index of the message.</param>
  11557. <param name="cancellationToken">The cancellation token.</param>
  11558. <param name="progress">The progress reporting mechanism.</param>
  11559. <exception cref="T:System.ArgumentOutOfRangeException">
  11560. <paramref name="index"/> is out of range.
  11561. </exception>
  11562. <exception cref="T:System.ObjectDisposedException">
  11563. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11564. </exception>
  11565. <exception cref="T:MailKit.ServiceNotConnectedException">
  11566. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11567. </exception>
  11568. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11569. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11570. </exception>
  11571. <exception cref="T:MailKit.FolderNotOpenException">
  11572. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11573. </exception>
  11574. <exception cref="T:MailKit.MessageNotFoundException">
  11575. The IMAP server did not return the requested message.
  11576. </exception>
  11577. <exception cref="T:System.OperationCanceledException">
  11578. The operation was canceled via the cancellation token.
  11579. </exception>
  11580. <exception cref="T:System.IO.IOException">
  11581. An I/O error occurred.
  11582. </exception>
  11583. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11584. The server's response contained unexpected tokens.
  11585. </exception>
  11586. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11587. The server replied with a NO or BAD response.
  11588. </exception>
  11589. </member>
  11590. <member name="M:MailKit.Net.Imap.ImapFolder.GetBodyPart(MailKit.UniqueId,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11591. <summary>
  11592. Get the specified body part.
  11593. </summary>
  11594. <remarks>
  11595. Gets the specified body part.
  11596. </remarks>
  11597. <returns>The body part.</returns>
  11598. <param name="uid">The UID of the message.</param>
  11599. <param name="partSpecifier">The body part specifier.</param>
  11600. <param name="cancellationToken">The cancellation token.</param>
  11601. <param name="progress">The progress reporting mechanism.</param>
  11602. <exception cref="T:System.ArgumentNullException">
  11603. <paramref name="partSpecifier"/> is <c>null</c>.
  11604. </exception>
  11605. <exception cref="T:System.ArgumentException">
  11606. <paramref name="uid"/> is invalid.
  11607. </exception>
  11608. <exception cref="T:System.ObjectDisposedException">
  11609. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11610. </exception>
  11611. <exception cref="T:MailKit.ServiceNotConnectedException">
  11612. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11613. </exception>
  11614. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11615. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11616. </exception>
  11617. <exception cref="T:MailKit.FolderNotOpenException">
  11618. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11619. </exception>
  11620. <exception cref="T:MailKit.MessageNotFoundException">
  11621. The IMAP server did not return the requested message body.
  11622. </exception>
  11623. <exception cref="T:System.OperationCanceledException">
  11624. The operation was canceled via the cancellation token.
  11625. </exception>
  11626. <exception cref="T:System.IO.IOException">
  11627. An I/O error occurred.
  11628. </exception>
  11629. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11630. The server's response contained unexpected tokens.
  11631. </exception>
  11632. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11633. The server replied with a NO or BAD response.
  11634. </exception>
  11635. </member>
  11636. <member name="M:MailKit.Net.Imap.ImapFolder.GetBodyPartAsync(MailKit.UniqueId,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11637. <summary>
  11638. Asynchronously get the specified body part.
  11639. </summary>
  11640. <remarks>
  11641. Gets the specified body part.
  11642. </remarks>
  11643. <returns>The body part.</returns>
  11644. <param name="uid">The UID of the message.</param>
  11645. <param name="partSpecifier">The body part specifier.</param>
  11646. <param name="cancellationToken">The cancellation token.</param>
  11647. <param name="progress">The progress reporting mechanism.</param>
  11648. <exception cref="T:System.ArgumentNullException">
  11649. <paramref name="partSpecifier"/> is <c>null</c>.
  11650. </exception>
  11651. <exception cref="T:System.ArgumentException">
  11652. <paramref name="uid"/> is invalid.
  11653. </exception>
  11654. <exception cref="T:System.ObjectDisposedException">
  11655. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11656. </exception>
  11657. <exception cref="T:MailKit.ServiceNotConnectedException">
  11658. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11659. </exception>
  11660. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11661. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11662. </exception>
  11663. <exception cref="T:MailKit.FolderNotOpenException">
  11664. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11665. </exception>
  11666. <exception cref="T:MailKit.MessageNotFoundException">
  11667. The IMAP server did not return the requested message body.
  11668. </exception>
  11669. <exception cref="T:System.OperationCanceledException">
  11670. The operation was canceled via the cancellation token.
  11671. </exception>
  11672. <exception cref="T:System.IO.IOException">
  11673. An I/O error occurred.
  11674. </exception>
  11675. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11676. The server's response contained unexpected tokens.
  11677. </exception>
  11678. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11679. The server replied with a NO or BAD response.
  11680. </exception>
  11681. </member>
  11682. <member name="M:MailKit.Net.Imap.ImapFolder.GetBodyPart(MailKit.UniqueId,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11683. <summary>
  11684. Get the specified body part.
  11685. </summary>
  11686. <remarks>
  11687. Gets the specified body part.
  11688. </remarks>
  11689. <example>
  11690. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  11691. </example>
  11692. <returns>The body part.</returns>
  11693. <param name="uid">The UID of the message.</param>
  11694. <param name="part">The body part.</param>
  11695. <param name="cancellationToken">The cancellation token.</param>
  11696. <param name="progress">The progress reporting mechanism.</param>
  11697. <exception cref="T:System.ArgumentNullException">
  11698. <paramref name="part"/> is <c>null</c>.
  11699. </exception>
  11700. <exception cref="T:System.ArgumentException">
  11701. <paramref name="uid"/> is invalid.
  11702. </exception>
  11703. <exception cref="T:System.ObjectDisposedException">
  11704. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11705. </exception>
  11706. <exception cref="T:MailKit.ServiceNotConnectedException">
  11707. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11708. </exception>
  11709. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11710. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11711. </exception>
  11712. <exception cref="T:MailKit.FolderNotOpenException">
  11713. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11714. </exception>
  11715. <exception cref="T:MailKit.MessageNotFoundException">
  11716. The IMAP server did not return the requested message body.
  11717. </exception>
  11718. <exception cref="T:System.OperationCanceledException">
  11719. The operation was canceled via the cancellation token.
  11720. </exception>
  11721. <exception cref="T:System.IO.IOException">
  11722. An I/O error occurred.
  11723. </exception>
  11724. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11725. The server's response contained unexpected tokens.
  11726. </exception>
  11727. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11728. The server replied with a NO or BAD response.
  11729. </exception>
  11730. </member>
  11731. <member name="M:MailKit.Net.Imap.ImapFolder.GetBodyPartAsync(MailKit.UniqueId,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11732. <summary>
  11733. Asynchronously get the specified body part.
  11734. </summary>
  11735. <remarks>
  11736. Gets the specified body part.
  11737. </remarks>
  11738. <example>
  11739. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  11740. </example>
  11741. <returns>The body part.</returns>
  11742. <param name="uid">The UID of the message.</param>
  11743. <param name="part">The body part.</param>
  11744. <param name="cancellationToken">The cancellation token.</param>
  11745. <param name="progress">The progress reporting mechanism.</param>
  11746. <exception cref="T:System.ArgumentNullException">
  11747. <paramref name="part"/> is <c>null</c>.
  11748. </exception>
  11749. <exception cref="T:System.ArgumentException">
  11750. <paramref name="uid"/> is invalid.
  11751. </exception>
  11752. <exception cref="T:System.ObjectDisposedException">
  11753. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11754. </exception>
  11755. <exception cref="T:MailKit.ServiceNotConnectedException">
  11756. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11757. </exception>
  11758. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11759. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11760. </exception>
  11761. <exception cref="T:MailKit.FolderNotOpenException">
  11762. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11763. </exception>
  11764. <exception cref="T:MailKit.MessageNotFoundException">
  11765. The IMAP server did not return the requested message body.
  11766. </exception>
  11767. <exception cref="T:System.OperationCanceledException">
  11768. The operation was canceled via the cancellation token.
  11769. </exception>
  11770. <exception cref="T:System.IO.IOException">
  11771. An I/O error occurred.
  11772. </exception>
  11773. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11774. The server's response contained unexpected tokens.
  11775. </exception>
  11776. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11777. The server replied with a NO or BAD response.
  11778. </exception>
  11779. </member>
  11780. <member name="M:MailKit.Net.Imap.ImapFolder.GetBodyPart(System.Int32,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11781. <summary>
  11782. Get the specified body part.
  11783. </summary>
  11784. <remarks>
  11785. Gets the specified body part.
  11786. </remarks>
  11787. <returns>The body part.</returns>
  11788. <param name="index">The index of the message.</param>
  11789. <param name="partSpecifier">The body part specifier.</param>
  11790. <param name="cancellationToken">The cancellation token.</param>
  11791. <param name="progress">The progress reporting mechanism.</param>
  11792. <exception cref="T:System.ArgumentNullException">
  11793. <paramref name="partSpecifier"/> is <c>null</c>.
  11794. </exception>
  11795. <exception cref="T:System.ArgumentOutOfRangeException">
  11796. <paramref name="index"/> is out of range.
  11797. </exception>
  11798. <exception cref="T:System.ObjectDisposedException">
  11799. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11800. </exception>
  11801. <exception cref="T:MailKit.ServiceNotConnectedException">
  11802. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11803. </exception>
  11804. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11805. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11806. </exception>
  11807. <exception cref="T:MailKit.FolderNotOpenException">
  11808. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11809. </exception>
  11810. <exception cref="T:MailKit.MessageNotFoundException">
  11811. The IMAP server did not return the requested message.
  11812. </exception>
  11813. <exception cref="T:System.OperationCanceledException">
  11814. The operation was canceled via the cancellation token.
  11815. </exception>
  11816. <exception cref="T:System.IO.IOException">
  11817. An I/O error occurred.
  11818. </exception>
  11819. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11820. The server's response contained unexpected tokens.
  11821. </exception>
  11822. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11823. The server replied with a NO or BAD response.
  11824. </exception>
  11825. </member>
  11826. <member name="M:MailKit.Net.Imap.ImapFolder.GetBodyPartAsync(System.Int32,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11827. <summary>
  11828. Asynchronously get the specified body part.
  11829. </summary>
  11830. <remarks>
  11831. Gets the specified body part.
  11832. </remarks>
  11833. <returns>The body part.</returns>
  11834. <param name="index">The index of the message.</param>
  11835. <param name="partSpecifier">The body part specifier.</param>
  11836. <param name="cancellationToken">The cancellation token.</param>
  11837. <param name="progress">The progress reporting mechanism.</param>
  11838. <exception cref="T:System.ArgumentNullException">
  11839. <paramref name="partSpecifier"/> is <c>null</c>.
  11840. </exception>
  11841. <exception cref="T:System.ArgumentOutOfRangeException">
  11842. <paramref name="index"/> is out of range.
  11843. </exception>
  11844. <exception cref="T:System.ObjectDisposedException">
  11845. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11846. </exception>
  11847. <exception cref="T:MailKit.ServiceNotConnectedException">
  11848. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11849. </exception>
  11850. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11851. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11852. </exception>
  11853. <exception cref="T:MailKit.FolderNotOpenException">
  11854. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11855. </exception>
  11856. <exception cref="T:MailKit.MessageNotFoundException">
  11857. The IMAP server did not return the requested message.
  11858. </exception>
  11859. <exception cref="T:System.OperationCanceledException">
  11860. The operation was canceled via the cancellation token.
  11861. </exception>
  11862. <exception cref="T:System.IO.IOException">
  11863. An I/O error occurred.
  11864. </exception>
  11865. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11866. The server's response contained unexpected tokens.
  11867. </exception>
  11868. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11869. The server replied with a NO or BAD response.
  11870. </exception>
  11871. </member>
  11872. <member name="M:MailKit.Net.Imap.ImapFolder.GetBodyPart(System.Int32,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11873. <summary>
  11874. Get the specified body part.
  11875. </summary>
  11876. <remarks>
  11877. Gets the specified body part.
  11878. </remarks>
  11879. <returns>The body part.</returns>
  11880. <param name="index">The index of the message.</param>
  11881. <param name="part">The body part.</param>
  11882. <param name="cancellationToken">The cancellation token.</param>
  11883. <param name="progress">The progress reporting mechanism.</param>
  11884. <exception cref="T:System.ArgumentNullException">
  11885. <paramref name="part"/> is <c>null</c>.
  11886. </exception>
  11887. <exception cref="T:System.ArgumentOutOfRangeException">
  11888. <paramref name="index"/> is out of range.
  11889. </exception>
  11890. <exception cref="T:System.ObjectDisposedException">
  11891. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11892. </exception>
  11893. <exception cref="T:MailKit.ServiceNotConnectedException">
  11894. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11895. </exception>
  11896. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11897. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11898. </exception>
  11899. <exception cref="T:MailKit.FolderNotOpenException">
  11900. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11901. </exception>
  11902. <exception cref="T:MailKit.MessageNotFoundException">
  11903. The IMAP server did not return the requested message.
  11904. </exception>
  11905. <exception cref="T:System.OperationCanceledException">
  11906. The operation was canceled via the cancellation token.
  11907. </exception>
  11908. <exception cref="T:System.IO.IOException">
  11909. An I/O error occurred.
  11910. </exception>
  11911. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11912. The server's response contained unexpected tokens.
  11913. </exception>
  11914. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11915. The server replied with a NO or BAD response.
  11916. </exception>
  11917. </member>
  11918. <member name="M:MailKit.Net.Imap.ImapFolder.GetBodyPartAsync(System.Int32,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11919. <summary>
  11920. Asynchronously get the specified body part.
  11921. </summary>
  11922. <remarks>
  11923. Gets the specified body part.
  11924. </remarks>
  11925. <returns>The body part.</returns>
  11926. <param name="index">The index of the message.</param>
  11927. <param name="part">The body part.</param>
  11928. <param name="cancellationToken">The cancellation token.</param>
  11929. <param name="progress">The progress reporting mechanism.</param>
  11930. <exception cref="T:System.ArgumentNullException">
  11931. <paramref name="part"/> is <c>null</c>.
  11932. </exception>
  11933. <exception cref="T:System.ArgumentOutOfRangeException">
  11934. <paramref name="index"/> is out of range.
  11935. </exception>
  11936. <exception cref="T:System.ObjectDisposedException">
  11937. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11938. </exception>
  11939. <exception cref="T:MailKit.ServiceNotConnectedException">
  11940. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11941. </exception>
  11942. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11943. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11944. </exception>
  11945. <exception cref="T:MailKit.FolderNotOpenException">
  11946. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11947. </exception>
  11948. <exception cref="T:MailKit.MessageNotFoundException">
  11949. The IMAP server did not return the requested message.
  11950. </exception>
  11951. <exception cref="T:System.OperationCanceledException">
  11952. The operation was canceled via the cancellation token.
  11953. </exception>
  11954. <exception cref="T:System.IO.IOException">
  11955. An I/O error occurred.
  11956. </exception>
  11957. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  11958. The server's response contained unexpected tokens.
  11959. </exception>
  11960. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  11961. The server replied with a NO or BAD response.
  11962. </exception>
  11963. </member>
  11964. <member name="M:MailKit.Net.Imap.ImapFolder.GetStream(MailKit.UniqueId,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  11965. <summary>
  11966. Get a substream of the specified message.
  11967. </summary>
  11968. <remarks>
  11969. Fetches a substream of the message. If the starting offset is beyond
  11970. the end of the message, an empty stream is returned. If the number of
  11971. bytes desired extends beyond the end of the message, a truncated stream
  11972. will be returned.
  11973. </remarks>
  11974. <returns>The stream.</returns>
  11975. <param name="uid">The UID of the message.</param>
  11976. <param name="offset">The starting offset of the first desired byte.</param>
  11977. <param name="count">The number of bytes desired.</param>
  11978. <param name="cancellationToken">The cancellation token.</param>
  11979. <param name="progress">The progress reporting mechanism.</param>
  11980. <exception cref="T:System.ArgumentException">
  11981. <paramref name="uid"/> is invalid.
  11982. </exception>
  11983. <exception cref="T:System.ArgumentOutOfRangeException">
  11984. <para><paramref name="offset"/> is negative.</para>
  11985. <para>-or-</para>
  11986. <para><paramref name="count"/> is negative.</para>
  11987. </exception>
  11988. <exception cref="T:System.ObjectDisposedException">
  11989. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  11990. </exception>
  11991. <exception cref="T:MailKit.ServiceNotConnectedException">
  11992. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  11993. </exception>
  11994. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  11995. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  11996. </exception>
  11997. <exception cref="T:MailKit.FolderNotOpenException">
  11998. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  11999. </exception>
  12000. <exception cref="T:MailKit.MessageNotFoundException">
  12001. The IMAP server did not return the requested message stream.
  12002. </exception>
  12003. <exception cref="T:System.OperationCanceledException">
  12004. The operation was canceled via the cancellation token.
  12005. </exception>
  12006. <exception cref="T:System.IO.IOException">
  12007. An I/O error occurred.
  12008. </exception>
  12009. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12010. The server's response contained unexpected tokens.
  12011. </exception>
  12012. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12013. The server replied with a NO or BAD response.
  12014. </exception>
  12015. </member>
  12016. <member name="M:MailKit.Net.Imap.ImapFolder.GetStreamAsync(MailKit.UniqueId,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12017. <summary>
  12018. Asynchronously gets a substream of the specified message.
  12019. </summary>
  12020. <remarks>
  12021. Fetches a substream of the message. If the starting offset is beyond
  12022. the end of the message, an empty stream is returned. If the number of
  12023. bytes desired extends beyond the end of the message, a truncated stream
  12024. will be returned.
  12025. </remarks>
  12026. <returns>The stream.</returns>
  12027. <param name="uid">The UID of the message.</param>
  12028. <param name="offset">The starting offset of the first desired byte.</param>
  12029. <param name="count">The number of bytes desired.</param>
  12030. <param name="cancellationToken">The cancellation token.</param>
  12031. <param name="progress">The progress reporting mechanism.</param>
  12032. <exception cref="T:System.ArgumentException">
  12033. <paramref name="uid"/> is invalid.
  12034. </exception>
  12035. <exception cref="T:System.ArgumentOutOfRangeException">
  12036. <para><paramref name="offset"/> is negative.</para>
  12037. <para>-or-</para>
  12038. <para><paramref name="count"/> is negative.</para>
  12039. </exception>
  12040. <exception cref="T:System.ObjectDisposedException">
  12041. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12042. </exception>
  12043. <exception cref="T:MailKit.ServiceNotConnectedException">
  12044. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12045. </exception>
  12046. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12047. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12048. </exception>
  12049. <exception cref="T:MailKit.FolderNotOpenException">
  12050. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12051. </exception>
  12052. <exception cref="T:MailKit.MessageNotFoundException">
  12053. The IMAP server did not return the requested message stream.
  12054. </exception>
  12055. <exception cref="T:System.OperationCanceledException">
  12056. The operation was canceled via the cancellation token.
  12057. </exception>
  12058. <exception cref="T:System.IO.IOException">
  12059. An I/O error occurred.
  12060. </exception>
  12061. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12062. The server's response contained unexpected tokens.
  12063. </exception>
  12064. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12065. The server replied with a NO or BAD response.
  12066. </exception>
  12067. </member>
  12068. <member name="M:MailKit.Net.Imap.ImapFolder.GetStream(System.Int32,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12069. <summary>
  12070. Get a substream of the specified message.
  12071. </summary>
  12072. <remarks>
  12073. Fetches a substream of the message. If the starting offset is beyond
  12074. the end of the message, an empty stream is returned. If the number of
  12075. bytes desired extends beyond the end of the message, a truncated stream
  12076. will be returned.
  12077. </remarks>
  12078. <returns>The stream.</returns>
  12079. <param name="index">The index of the message.</param>
  12080. <param name="offset">The starting offset of the first desired byte.</param>
  12081. <param name="count">The number of bytes desired.</param>
  12082. <param name="cancellationToken">The cancellation token.</param>
  12083. <param name="progress">The progress reporting mechanism.</param>
  12084. <exception cref="T:System.ArgumentOutOfRangeException">
  12085. <para><paramref name="index"/> is out of range.</para>
  12086. <para>-or-</para>
  12087. <para><paramref name="offset"/> is negative.</para>
  12088. <para>-or-</para>
  12089. <para><paramref name="count"/> is negative.</para>
  12090. </exception>
  12091. <exception cref="T:System.ObjectDisposedException">
  12092. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12093. </exception>
  12094. <exception cref="T:MailKit.ServiceNotConnectedException">
  12095. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12096. </exception>
  12097. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12098. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12099. </exception>
  12100. <exception cref="T:MailKit.FolderNotOpenException">
  12101. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12102. </exception>
  12103. <exception cref="T:MailKit.MessageNotFoundException">
  12104. The IMAP server did not return the requested message stream.
  12105. </exception>
  12106. <exception cref="T:System.OperationCanceledException">
  12107. The operation was canceled via the cancellation token.
  12108. </exception>
  12109. <exception cref="T:System.IO.IOException">
  12110. An I/O error occurred.
  12111. </exception>
  12112. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12113. The server's response contained unexpected tokens.
  12114. </exception>
  12115. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12116. The server replied with a NO or BAD response.
  12117. </exception>
  12118. </member>
  12119. <member name="M:MailKit.Net.Imap.ImapFolder.GetStreamAsync(System.Int32,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12120. <summary>
  12121. Asynchronously gets a substream of the specified message.
  12122. </summary>
  12123. <remarks>
  12124. Fetches a substream of the message. If the starting offset is beyond
  12125. the end of the message, an empty stream is returned. If the number of
  12126. bytes desired extends beyond the end of the message, a truncated stream
  12127. will be returned.
  12128. </remarks>
  12129. <returns>The stream.</returns>
  12130. <param name="index">The index of the message.</param>
  12131. <param name="offset">The starting offset of the first desired byte.</param>
  12132. <param name="count">The number of bytes desired.</param>
  12133. <param name="cancellationToken">The cancellation token.</param>
  12134. <param name="progress">The progress reporting mechanism.</param>
  12135. <exception cref="T:System.ArgumentOutOfRangeException">
  12136. <para><paramref name="index"/> is out of range.</para>
  12137. <para>-or-</para>
  12138. <para><paramref name="offset"/> is negative.</para>
  12139. <para>-or-</para>
  12140. <para><paramref name="count"/> is negative.</para>
  12141. </exception>
  12142. <exception cref="T:System.ObjectDisposedException">
  12143. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12144. </exception>
  12145. <exception cref="T:MailKit.ServiceNotConnectedException">
  12146. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12147. </exception>
  12148. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12149. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12150. </exception>
  12151. <exception cref="T:MailKit.FolderNotOpenException">
  12152. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12153. </exception>
  12154. <exception cref="T:MailKit.MessageNotFoundException">
  12155. The IMAP server did not return the requested message stream.
  12156. </exception>
  12157. <exception cref="T:System.OperationCanceledException">
  12158. The operation was canceled via the cancellation token.
  12159. </exception>
  12160. <exception cref="T:System.IO.IOException">
  12161. An I/O error occurred.
  12162. </exception>
  12163. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12164. The server's response contained unexpected tokens.
  12165. </exception>
  12166. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12167. The server replied with a NO or BAD response.
  12168. </exception>
  12169. </member>
  12170. <member name="M:MailKit.Net.Imap.ImapFolder.GetStream(MailKit.UniqueId,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12171. <summary>
  12172. Get a substream of the specified body part.
  12173. </summary>
  12174. <remarks>
  12175. <para>Gets a substream of the specified message.</para>
  12176. <para>For more information about how to construct the <paramref name="section"/>,
  12177. see Section 6.4.5 of RFC3501.</para>
  12178. </remarks>
  12179. <returns>The stream.</returns>
  12180. <param name="uid">The UID of the message.</param>
  12181. <param name="section">The desired section of the message.</param>
  12182. <param name="cancellationToken">The cancellation token.</param>
  12183. <param name="progress">The progress reporting mechanism.</param>
  12184. <exception cref="T:System.ArgumentException">
  12185. <paramref name="uid"/> is invalid.
  12186. </exception>
  12187. <exception cref="T:System.ArgumentNullException">
  12188. <paramref name="section"/> is <c>null</c>.
  12189. </exception>
  12190. <exception cref="T:System.ObjectDisposedException">
  12191. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12192. </exception>
  12193. <exception cref="T:MailKit.ServiceNotConnectedException">
  12194. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12195. </exception>
  12196. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12197. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12198. </exception>
  12199. <exception cref="T:MailKit.FolderNotOpenException">
  12200. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12201. </exception>
  12202. <exception cref="T:MailKit.MessageNotFoundException">
  12203. The IMAP server did not return the requested message stream.
  12204. </exception>
  12205. <exception cref="T:System.OperationCanceledException">
  12206. The operation was canceled via the cancellation token.
  12207. </exception>
  12208. <exception cref="T:System.IO.IOException">
  12209. An I/O error occurred.
  12210. </exception>
  12211. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12212. The server's response contained unexpected tokens.
  12213. </exception>
  12214. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12215. The server replied with a NO or BAD response.
  12216. </exception>
  12217. </member>
  12218. <member name="M:MailKit.Net.Imap.ImapFolder.GetStreamAsync(MailKit.UniqueId,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12219. <summary>
  12220. Asynchronously gets a substream of the specified body part.
  12221. </summary>
  12222. <remarks>
  12223. <para>Gets a substream of the specified message.</para>
  12224. <para>For more information about how to construct the <paramref name="section"/>,
  12225. see Section 6.4.5 of RFC3501.</para>
  12226. </remarks>
  12227. <returns>The stream.</returns>
  12228. <param name="uid">The UID of the message.</param>
  12229. <param name="section">The desired section of the message.</param>
  12230. <param name="cancellationToken">The cancellation token.</param>
  12231. <param name="progress">The progress reporting mechanism.</param>
  12232. <exception cref="T:System.ArgumentException">
  12233. <paramref name="uid"/> is invalid.
  12234. </exception>
  12235. <exception cref="T:System.ArgumentNullException">
  12236. <paramref name="section"/> is <c>null</c>.
  12237. </exception>
  12238. <exception cref="T:System.ObjectDisposedException">
  12239. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12240. </exception>
  12241. <exception cref="T:MailKit.ServiceNotConnectedException">
  12242. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12243. </exception>
  12244. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12245. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12246. </exception>
  12247. <exception cref="T:MailKit.FolderNotOpenException">
  12248. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12249. </exception>
  12250. <exception cref="T:MailKit.MessageNotFoundException">
  12251. The IMAP server did not return the requested message stream.
  12252. </exception>
  12253. <exception cref="T:System.OperationCanceledException">
  12254. The operation was canceled via the cancellation token.
  12255. </exception>
  12256. <exception cref="T:System.IO.IOException">
  12257. An I/O error occurred.
  12258. </exception>
  12259. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12260. The server's response contained unexpected tokens.
  12261. </exception>
  12262. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12263. The server replied with a NO or BAD response.
  12264. </exception>
  12265. </member>
  12266. <member name="M:MailKit.Net.Imap.ImapFolder.GetStream(MailKit.UniqueId,System.String,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12267. <summary>
  12268. Get a substream of the specified message.
  12269. </summary>
  12270. <remarks>
  12271. <para>Gets a substream of the specified message. If the starting offset is beyond
  12272. the end of the specified section of the message, an empty stream is returned. If
  12273. the number of bytes desired extends beyond the end of the section, a truncated
  12274. stream will be returned.</para>
  12275. <para>For more information about how to construct the <paramref name="section"/>,
  12276. see Section 6.4.5 of RFC3501.</para>
  12277. </remarks>
  12278. <returns>The stream.</returns>
  12279. <param name="uid">The UID of the message.</param>
  12280. <param name="section">The desired section of the message.</param>
  12281. <param name="offset">The starting offset of the first desired byte.</param>
  12282. <param name="count">The number of bytes desired.</param>
  12283. <param name="cancellationToken">The cancellation token.</param>
  12284. <param name="progress">The progress reporting mechanism.</param>
  12285. <exception cref="T:System.ArgumentException">
  12286. <paramref name="uid"/> is invalid.
  12287. </exception>
  12288. <exception cref="T:System.ArgumentNullException">
  12289. <paramref name="section"/> is <c>null</c>.
  12290. </exception>
  12291. <exception cref="T:System.ArgumentOutOfRangeException">
  12292. <para><paramref name="offset"/> is negative.</para>
  12293. <para>-or-</para>
  12294. <para><paramref name="count"/> is negative.</para>
  12295. </exception>
  12296. <exception cref="T:System.ObjectDisposedException">
  12297. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12298. </exception>
  12299. <exception cref="T:MailKit.ServiceNotConnectedException">
  12300. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12301. </exception>
  12302. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12303. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12304. </exception>
  12305. <exception cref="T:MailKit.FolderNotOpenException">
  12306. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12307. </exception>
  12308. <exception cref="T:MailKit.MessageNotFoundException">
  12309. The IMAP server did not return the requested message stream.
  12310. </exception>
  12311. <exception cref="T:System.OperationCanceledException">
  12312. The operation was canceled via the cancellation token.
  12313. </exception>
  12314. <exception cref="T:System.IO.IOException">
  12315. An I/O error occurred.
  12316. </exception>
  12317. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12318. The server's response contained unexpected tokens.
  12319. </exception>
  12320. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12321. The server replied with a NO or BAD response.
  12322. </exception>
  12323. </member>
  12324. <member name="M:MailKit.Net.Imap.ImapFolder.GetStreamAsync(MailKit.UniqueId,System.String,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12325. <summary>
  12326. Asynchronously gets a substream of the specified message.
  12327. </summary>
  12328. <remarks>
  12329. <para>Gets a substream of the specified message. If the starting offset is beyond
  12330. the end of the specified section of the message, an empty stream is returned. If
  12331. the number of bytes desired extends beyond the end of the section, a truncated
  12332. stream will be returned.</para>
  12333. <para>For more information about how to construct the <paramref name="section"/>,
  12334. see Section 6.4.5 of RFC3501.</para>
  12335. </remarks>
  12336. <returns>The stream.</returns>
  12337. <param name="uid">The UID of the message.</param>
  12338. <param name="section">The desired section of the message.</param>
  12339. <param name="offset">The starting offset of the first desired byte.</param>
  12340. <param name="count">The number of bytes desired.</param>
  12341. <param name="cancellationToken">The cancellation token.</param>
  12342. <param name="progress">The progress reporting mechanism.</param>
  12343. <exception cref="T:System.ArgumentException">
  12344. <paramref name="uid"/> is invalid.
  12345. </exception>
  12346. <exception cref="T:System.ArgumentNullException">
  12347. <paramref name="section"/> is <c>null</c>.
  12348. </exception>
  12349. <exception cref="T:System.ArgumentOutOfRangeException">
  12350. <para><paramref name="offset"/> is negative.</para>
  12351. <para>-or-</para>
  12352. <para><paramref name="count"/> is negative.</para>
  12353. </exception>
  12354. <exception cref="T:System.ObjectDisposedException">
  12355. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12356. </exception>
  12357. <exception cref="T:MailKit.ServiceNotConnectedException">
  12358. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12359. </exception>
  12360. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12361. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12362. </exception>
  12363. <exception cref="T:MailKit.FolderNotOpenException">
  12364. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12365. </exception>
  12366. <exception cref="T:MailKit.MessageNotFoundException">
  12367. The IMAP server did not return the requested message stream.
  12368. </exception>
  12369. <exception cref="T:System.OperationCanceledException">
  12370. The operation was canceled via the cancellation token.
  12371. </exception>
  12372. <exception cref="T:System.IO.IOException">
  12373. An I/O error occurred.
  12374. </exception>
  12375. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12376. The server's response contained unexpected tokens.
  12377. </exception>
  12378. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12379. The server replied with a NO or BAD response.
  12380. </exception>
  12381. </member>
  12382. <member name="M:MailKit.Net.Imap.ImapFolder.GetStream(System.Int32,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12383. <summary>
  12384. Get a substream of the specified message.
  12385. </summary>
  12386. <remarks>
  12387. <para>Gets a substream of the specified message.</para>
  12388. <para>For more information about how to construct the <paramref name="section"/>,
  12389. see Section 6.4.5 of RFC3501.</para>
  12390. </remarks>
  12391. <returns>The stream.</returns>
  12392. <param name="index">The index of the message.</param>
  12393. <param name="section">The desired section of the message.</param>
  12394. <param name="cancellationToken">The cancellation token.</param>
  12395. <param name="progress">The progress reporting mechanism.</param>
  12396. <exception cref="T:System.ArgumentNullException">
  12397. <paramref name="section"/> is <c>null</c>.
  12398. </exception>
  12399. <exception cref="T:System.ArgumentOutOfRangeException">
  12400. <paramref name="index"/> is out of range.
  12401. </exception>
  12402. <exception cref="T:System.ObjectDisposedException">
  12403. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12404. </exception>
  12405. <exception cref="T:MailKit.ServiceNotConnectedException">
  12406. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12407. </exception>
  12408. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12409. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12410. </exception>
  12411. <exception cref="T:MailKit.FolderNotOpenException">
  12412. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12413. </exception>
  12414. <exception cref="T:MailKit.MessageNotFoundException">
  12415. The IMAP server did not return the requested message stream.
  12416. </exception>
  12417. <exception cref="T:System.OperationCanceledException">
  12418. The operation was canceled via the cancellation token.
  12419. </exception>
  12420. <exception cref="T:System.IO.IOException">
  12421. An I/O error occurred.
  12422. </exception>
  12423. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12424. The server's response contained unexpected tokens.
  12425. </exception>
  12426. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12427. The server replied with a NO or BAD response.
  12428. </exception>
  12429. </member>
  12430. <member name="M:MailKit.Net.Imap.ImapFolder.GetStreamAsync(System.Int32,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12431. <summary>
  12432. Asynchronously gets a substream of the specified message.
  12433. </summary>
  12434. <remarks>
  12435. <para>Gets a substream of the specified message.</para>
  12436. <para>For more information about how to construct the <paramref name="section"/>,
  12437. see Section 6.4.5 of RFC3501.</para>
  12438. </remarks>
  12439. <returns>The stream.</returns>
  12440. <param name="index">The index of the message.</param>
  12441. <param name="section">The desired section of the message.</param>
  12442. <param name="cancellationToken">The cancellation token.</param>
  12443. <param name="progress">The progress reporting mechanism.</param>
  12444. <exception cref="T:System.ArgumentNullException">
  12445. <paramref name="section"/> is <c>null</c>.
  12446. </exception>
  12447. <exception cref="T:System.ArgumentOutOfRangeException">
  12448. <paramref name="index"/> is out of range.
  12449. </exception>
  12450. <exception cref="T:System.ObjectDisposedException">
  12451. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12452. </exception>
  12453. <exception cref="T:MailKit.ServiceNotConnectedException">
  12454. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12455. </exception>
  12456. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12457. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12458. </exception>
  12459. <exception cref="T:MailKit.FolderNotOpenException">
  12460. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12461. </exception>
  12462. <exception cref="T:MailKit.MessageNotFoundException">
  12463. The IMAP server did not return the requested message stream.
  12464. </exception>
  12465. <exception cref="T:System.OperationCanceledException">
  12466. The operation was canceled via the cancellation token.
  12467. </exception>
  12468. <exception cref="T:System.IO.IOException">
  12469. An I/O error occurred.
  12470. </exception>
  12471. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12472. The server's response contained unexpected tokens.
  12473. </exception>
  12474. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12475. The server replied with a NO or BAD response.
  12476. </exception>
  12477. </member>
  12478. <member name="M:MailKit.Net.Imap.ImapFolder.GetStream(System.Int32,System.String,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12479. <summary>
  12480. Get a substream of the specified message.
  12481. </summary>
  12482. <remarks>
  12483. <para>Gets a substream of the specified message. If the starting offset is beyond
  12484. the end of the specified section of the message, an empty stream is returned. If
  12485. the number of bytes desired extends beyond the end of the section, a truncated
  12486. stream will be returned.</para>
  12487. <para>For more information about how to construct the <paramref name="section"/>,
  12488. see Section 6.4.5 of RFC3501.</para>
  12489. </remarks>
  12490. <returns>The stream.</returns>
  12491. <param name="index">The index of the message.</param>
  12492. <param name="section">The desired section of the message.</param>
  12493. <param name="offset">The starting offset of the first desired byte.</param>
  12494. <param name="count">The number of bytes desired.</param>
  12495. <param name="cancellationToken">The cancellation token.</param>
  12496. <param name="progress">The progress reporting mechanism.</param>
  12497. <exception cref="T:System.ArgumentNullException">
  12498. <paramref name="section"/> is <c>null</c>.
  12499. </exception>
  12500. <exception cref="T:System.ArgumentOutOfRangeException">
  12501. <para><paramref name="index"/> is out of range.</para>
  12502. <para>-or-</para>
  12503. <para><paramref name="offset"/> is negative.</para>
  12504. <para>-or-</para>
  12505. <para><paramref name="count"/> is negative.</para>
  12506. </exception>
  12507. <exception cref="T:System.ObjectDisposedException">
  12508. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12509. </exception>
  12510. <exception cref="T:MailKit.ServiceNotConnectedException">
  12511. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12512. </exception>
  12513. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12514. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12515. </exception>
  12516. <exception cref="T:MailKit.FolderNotOpenException">
  12517. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12518. </exception>
  12519. <exception cref="T:MailKit.MessageNotFoundException">
  12520. The IMAP server did not return the requested message stream.
  12521. </exception>
  12522. <exception cref="T:System.OperationCanceledException">
  12523. The operation was canceled via the cancellation token.
  12524. </exception>
  12525. <exception cref="T:System.IO.IOException">
  12526. An I/O error occurred.
  12527. </exception>
  12528. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12529. The server's response contained unexpected tokens.
  12530. </exception>
  12531. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12532. The server replied with a NO or BAD response.
  12533. </exception>
  12534. </member>
  12535. <member name="M:MailKit.Net.Imap.ImapFolder.GetStreamAsync(System.Int32,System.String,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12536. <summary>
  12537. Asynchronously gets a substream of the specified message.
  12538. </summary>
  12539. <remarks>
  12540. <para>Gets a substream of the specified message. If the starting offset is beyond
  12541. the end of the specified section of the message, an empty stream is returned. If
  12542. the number of bytes desired extends beyond the end of the section, a truncated
  12543. stream will be returned.</para>
  12544. <para>For more information about how to construct the <paramref name="section"/>,
  12545. see Section 6.4.5 of RFC3501.</para>
  12546. </remarks>
  12547. <returns>The stream.</returns>
  12548. <param name="index">The index of the message.</param>
  12549. <param name="section">The desired section of the message.</param>
  12550. <param name="offset">The starting offset of the first desired byte.</param>
  12551. <param name="count">The number of bytes desired.</param>
  12552. <param name="cancellationToken">The cancellation token.</param>
  12553. <param name="progress">The progress reporting mechanism.</param>
  12554. <exception cref="T:System.ArgumentNullException">
  12555. <paramref name="section"/> is <c>null</c>.
  12556. </exception>
  12557. <exception cref="T:System.ArgumentOutOfRangeException">
  12558. <para><paramref name="index"/> is out of range.</para>
  12559. <para>-or-</para>
  12560. <para><paramref name="offset"/> is negative.</para>
  12561. <para>-or-</para>
  12562. <para><paramref name="count"/> is negative.</para>
  12563. </exception>
  12564. <exception cref="T:System.ObjectDisposedException">
  12565. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12566. </exception>
  12567. <exception cref="T:MailKit.ServiceNotConnectedException">
  12568. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12569. </exception>
  12570. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12571. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12572. </exception>
  12573. <exception cref="T:MailKit.FolderNotOpenException">
  12574. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12575. </exception>
  12576. <exception cref="T:MailKit.MessageNotFoundException">
  12577. The IMAP server did not return the requested message stream.
  12578. </exception>
  12579. <exception cref="T:System.OperationCanceledException">
  12580. The operation was canceled via the cancellation token.
  12581. </exception>
  12582. <exception cref="T:System.IO.IOException">
  12583. An I/O error occurred.
  12584. </exception>
  12585. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12586. The server's response contained unexpected tokens.
  12587. </exception>
  12588. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12589. The server replied with a NO or BAD response.
  12590. </exception>
  12591. </member>
  12592. <member name="M:MailKit.Net.Imap.ImapFolder.GetStreams(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Net.Imap.ImapFetchStreamCallback,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12593. <summary>
  12594. Get the streams for the specified messages.
  12595. </summary>
  12596. <remarks>
  12597. <para>Gets the streams for the specified messages.</para>
  12598. </remarks>
  12599. <param name="uids">The uids of the messages.</param>
  12600. <param name="callback"></param>
  12601. <param name="cancellationToken">The cancellation token.</param>
  12602. <param name="progress">The progress reporting mechanism.</param>
  12603. <exception cref="T:System.ArgumentNullException">
  12604. <para><paramref name="uids"/> is <c>null</c>.</para>
  12605. <para>-or-</para>
  12606. <para><paramref name="callback"/> is <c>null</c>.</para>
  12607. </exception>
  12608. <exception cref="T:System.ArgumentException">
  12609. One or more of the <paramref name="uids"/> is invalid.
  12610. </exception>
  12611. <exception cref="T:System.ObjectDisposedException">
  12612. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12613. </exception>
  12614. <exception cref="T:MailKit.ServiceNotConnectedException">
  12615. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12616. </exception>
  12617. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12618. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12619. </exception>
  12620. <exception cref="T:MailKit.FolderNotOpenException">
  12621. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12622. </exception>
  12623. <exception cref="T:System.OperationCanceledException">
  12624. The operation was canceled via the cancellation token.
  12625. </exception>
  12626. <exception cref="T:System.IO.IOException">
  12627. An I/O error occurred.
  12628. </exception>
  12629. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12630. The server's response contained unexpected tokens.
  12631. </exception>
  12632. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12633. The server replied with a NO or BAD response.
  12634. </exception>
  12635. </member>
  12636. <member name="M:MailKit.Net.Imap.ImapFolder.GetStreamsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Net.Imap.ImapFetchStreamAsyncCallback,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12637. <summary>
  12638. Asynchronously get the streams for the specified messages.
  12639. </summary>
  12640. <remarks>
  12641. <para>Asynchronously gets the streams for the specified messages.</para>
  12642. </remarks>
  12643. <returns>An awaitable task.</returns>
  12644. <param name="uids">The uids of the messages.</param>
  12645. <param name="callback"></param>
  12646. <param name="cancellationToken">The cancellation token.</param>
  12647. <param name="progress">The progress reporting mechanism.</param>
  12648. <exception cref="T:System.ArgumentNullException">
  12649. <para><paramref name="uids"/> is <c>null</c>.</para>
  12650. <para>-or-</para>
  12651. <para><paramref name="callback"/> is <c>null</c>.</para>
  12652. </exception>
  12653. <exception cref="T:System.ArgumentException">
  12654. One or more of the <paramref name="uids"/> is invalid.
  12655. </exception>
  12656. <exception cref="T:System.ObjectDisposedException">
  12657. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12658. </exception>
  12659. <exception cref="T:MailKit.ServiceNotConnectedException">
  12660. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12661. </exception>
  12662. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12663. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12664. </exception>
  12665. <exception cref="T:MailKit.FolderNotOpenException">
  12666. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12667. </exception>
  12668. <exception cref="T:System.OperationCanceledException">
  12669. The operation was canceled via the cancellation token.
  12670. </exception>
  12671. <exception cref="T:System.IO.IOException">
  12672. An I/O error occurred.
  12673. </exception>
  12674. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12675. The server's response contained unexpected tokens.
  12676. </exception>
  12677. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12678. The server replied with a NO or BAD response.
  12679. </exception>
  12680. </member>
  12681. <member name="M:MailKit.Net.Imap.ImapFolder.GetStreams(System.Collections.Generic.IList{System.Int32},MailKit.Net.Imap.ImapFetchStreamCallback,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12682. <summary>
  12683. Get the streams for the specified messages.
  12684. </summary>
  12685. <remarks>
  12686. <para>Gets the streams for the specified messages.</para>
  12687. </remarks>
  12688. <param name="indexes">The indexes of the messages.</param>
  12689. <param name="callback"></param>
  12690. <param name="cancellationToken">The cancellation token.</param>
  12691. <param name="progress">The progress reporting mechanism.</param>
  12692. <exception cref="T:System.ArgumentNullException">
  12693. <para><paramref name="indexes"/> is <c>null</c>.</para>
  12694. <para>-or-</para>
  12695. <para><paramref name="callback"/> is <c>null</c>.</para>
  12696. </exception>
  12697. <exception cref="T:System.ArgumentException">
  12698. One or more of the <paramref name="indexes"/> is invalid.
  12699. </exception>
  12700. <exception cref="T:System.ObjectDisposedException">
  12701. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12702. </exception>
  12703. <exception cref="T:MailKit.ServiceNotConnectedException">
  12704. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12705. </exception>
  12706. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12707. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12708. </exception>
  12709. <exception cref="T:MailKit.FolderNotOpenException">
  12710. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12711. </exception>
  12712. <exception cref="T:System.OperationCanceledException">
  12713. The operation was canceled via the cancellation token.
  12714. </exception>
  12715. <exception cref="T:System.IO.IOException">
  12716. An I/O error occurred.
  12717. </exception>
  12718. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12719. The server's response contained unexpected tokens.
  12720. </exception>
  12721. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12722. The server replied with a NO or BAD response.
  12723. </exception>
  12724. </member>
  12725. <member name="M:MailKit.Net.Imap.ImapFolder.GetStreamsAsync(System.Collections.Generic.IList{System.Int32},MailKit.Net.Imap.ImapFetchStreamAsyncCallback,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12726. <summary>
  12727. Asynchronously get the streams for the specified messages.
  12728. </summary>
  12729. <remarks>
  12730. <para>Asynchronously gets the streams for the specified messages.</para>
  12731. </remarks>
  12732. <returns>An awaitable task.</returns>
  12733. <param name="indexes">The indexes of the messages.</param>
  12734. <param name="callback"></param>
  12735. <param name="cancellationToken">The cancellation token.</param>
  12736. <param name="progress">The progress reporting mechanism.</param>
  12737. <exception cref="T:System.ArgumentNullException">
  12738. <para><paramref name="indexes"/> is <c>null</c>.</para>
  12739. <para>-or-</para>
  12740. <para><paramref name="callback"/> is <c>null</c>.</para>
  12741. </exception>
  12742. <exception cref="T:System.ArgumentException">
  12743. One or more of the <paramref name="indexes"/> is invalid.
  12744. </exception>
  12745. <exception cref="T:System.ObjectDisposedException">
  12746. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12747. </exception>
  12748. <exception cref="T:MailKit.ServiceNotConnectedException">
  12749. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12750. </exception>
  12751. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12752. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12753. </exception>
  12754. <exception cref="T:MailKit.FolderNotOpenException">
  12755. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12756. </exception>
  12757. <exception cref="T:System.OperationCanceledException">
  12758. The operation was canceled via the cancellation token.
  12759. </exception>
  12760. <exception cref="T:System.IO.IOException">
  12761. An I/O error occurred.
  12762. </exception>
  12763. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12764. The server's response contained unexpected tokens.
  12765. </exception>
  12766. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12767. The server replied with a NO or BAD response.
  12768. </exception>
  12769. </member>
  12770. <member name="M:MailKit.Net.Imap.ImapFolder.GetStreams(System.Int32,System.Int32,MailKit.Net.Imap.ImapFetchStreamCallback,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12771. <summary>
  12772. Get the streams for the specified messages.
  12773. </summary>
  12774. <remarks>
  12775. <para>Gets the streams for the specified messages.</para>
  12776. </remarks>
  12777. <param name="min">The minimum index.</param>
  12778. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  12779. <param name="callback"></param>
  12780. <param name="cancellationToken">The cancellation token.</param>
  12781. <param name="progress">The progress reporting mechanism.</param>
  12782. <exception cref="T:System.ArgumentOutOfRangeException">
  12783. <para><paramref name="min"/> is out of range.</para>
  12784. <para>-or-</para>
  12785. <para><paramref name="max"/> is out of range.</para>
  12786. </exception>
  12787. <exception cref="T:System.ArgumentNullException">
  12788. <paramref name="callback"/> is <c>null</c>.
  12789. </exception>
  12790. <exception cref="T:System.ObjectDisposedException">
  12791. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12792. </exception>
  12793. <exception cref="T:MailKit.ServiceNotConnectedException">
  12794. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12795. </exception>
  12796. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12797. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12798. </exception>
  12799. <exception cref="T:MailKit.FolderNotOpenException">
  12800. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12801. </exception>
  12802. <exception cref="T:System.OperationCanceledException">
  12803. The operation was canceled via the cancellation token.
  12804. </exception>
  12805. <exception cref="T:System.IO.IOException">
  12806. An I/O error occurred.
  12807. </exception>
  12808. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12809. The server's response contained unexpected tokens.
  12810. </exception>
  12811. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12812. The server replied with a NO or BAD response.
  12813. </exception>
  12814. </member>
  12815. <member name="M:MailKit.Net.Imap.ImapFolder.GetStreamsAsync(System.Int32,System.Int32,MailKit.Net.Imap.ImapFetchStreamAsyncCallback,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  12816. <summary>
  12817. Asynchronously get the streams for the specified messages.
  12818. </summary>
  12819. <remarks>
  12820. <para>Asynchronously gets the streams for the specified messages.</para>
  12821. </remarks>
  12822. <returns>An awaitable task.</returns>
  12823. <param name="min">The minimum index.</param>
  12824. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  12825. <param name="callback"></param>
  12826. <param name="cancellationToken">The cancellation token.</param>
  12827. <param name="progress">The progress reporting mechanism.</param>
  12828. <exception cref="T:System.ArgumentOutOfRangeException">
  12829. <para><paramref name="min"/> is out of range.</para>
  12830. <para>-or-</para>
  12831. <para><paramref name="max"/> is out of range.</para>
  12832. </exception>
  12833. <exception cref="T:System.ArgumentNullException">
  12834. <paramref name="callback"/> is <c>null</c>.
  12835. </exception>
  12836. <exception cref="T:System.ObjectDisposedException">
  12837. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12838. </exception>
  12839. <exception cref="T:MailKit.ServiceNotConnectedException">
  12840. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12841. </exception>
  12842. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12843. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12844. </exception>
  12845. <exception cref="T:MailKit.FolderNotOpenException">
  12846. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  12847. </exception>
  12848. <exception cref="T:System.OperationCanceledException">
  12849. The operation was canceled via the cancellation token.
  12850. </exception>
  12851. <exception cref="T:System.IO.IOException">
  12852. An I/O error occurred.
  12853. </exception>
  12854. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12855. The server's response contained unexpected tokens.
  12856. </exception>
  12857. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12858. The server replied with a NO or BAD response.
  12859. </exception>
  12860. </member>
  12861. <member name="M:MailKit.Net.Imap.ImapFolder.AddFlags(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  12862. <summary>
  12863. Adds a set of flags to the specified messages.
  12864. </summary>
  12865. <remarks>
  12866. Adds a set of flags to the specified messages.
  12867. </remarks>
  12868. <param name="uids">The UIDs of the messages.</param>
  12869. <param name="flags">The message flags to add.</param>
  12870. <param name="keywords">A set of user-defined flags to add.</param>
  12871. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  12872. <param name="cancellationToken">The cancellation token.</param>
  12873. <exception cref="T:System.ArgumentNullException">
  12874. <paramref name="uids"/> is <c>null</c>.
  12875. </exception>
  12876. <exception cref="T:System.ArgumentException">
  12877. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  12878. <para>-or-</para>
  12879. <para>No flags were specified.</para>
  12880. </exception>
  12881. <exception cref="T:System.ObjectDisposedException">
  12882. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12883. </exception>
  12884. <exception cref="T:MailKit.ServiceNotConnectedException">
  12885. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12886. </exception>
  12887. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12888. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12889. </exception>
  12890. <exception cref="T:MailKit.FolderNotOpenException">
  12891. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  12892. </exception>
  12893. <exception cref="T:System.OperationCanceledException">
  12894. The operation was canceled via the cancellation token.
  12895. </exception>
  12896. <exception cref="T:System.IO.IOException">
  12897. An I/O error occurred.
  12898. </exception>
  12899. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12900. The server's response contained unexpected tokens.
  12901. </exception>
  12902. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12903. The server replied with a NO or BAD response.
  12904. </exception>
  12905. </member>
  12906. <member name="M:MailKit.Net.Imap.ImapFolder.AddFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  12907. <summary>
  12908. Asynchronously adds a set of flags to the specified messages.
  12909. </summary>
  12910. <remarks>
  12911. Adds a set of flags to the specified messages.
  12912. </remarks>
  12913. <returns>An asynchronous task context.</returns>
  12914. <param name="uids">The UIDs of the messages.</param>
  12915. <param name="flags">The message flags to add.</param>
  12916. <param name="keywords">A set of user-defined flags to add.</param>
  12917. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  12918. <param name="cancellationToken">The cancellation token.</param>
  12919. <exception cref="T:System.ArgumentNullException">
  12920. <paramref name="uids"/> is <c>null</c>.
  12921. </exception>
  12922. <exception cref="T:System.ArgumentException">
  12923. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  12924. <para>-or-</para>
  12925. <para>No flags were specified.</para>
  12926. </exception>
  12927. <exception cref="T:System.ObjectDisposedException">
  12928. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12929. </exception>
  12930. <exception cref="T:MailKit.ServiceNotConnectedException">
  12931. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12932. </exception>
  12933. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12934. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12935. </exception>
  12936. <exception cref="T:MailKit.FolderNotOpenException">
  12937. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  12938. </exception>
  12939. <exception cref="T:System.OperationCanceledException">
  12940. The operation was canceled via the cancellation token.
  12941. </exception>
  12942. <exception cref="T:System.IO.IOException">
  12943. An I/O error occurred.
  12944. </exception>
  12945. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12946. The server's response contained unexpected tokens.
  12947. </exception>
  12948. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12949. The server replied with a NO or BAD response.
  12950. </exception>
  12951. </member>
  12952. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveFlags(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  12953. <summary>
  12954. Removes a set of flags from the specified messages.
  12955. </summary>
  12956. <remarks>
  12957. Removes a set of flags from the specified messages.
  12958. </remarks>
  12959. <param name="uids">The UIDs of the messages.</param>
  12960. <param name="flags">The message flags to remove.</param>
  12961. <param name="keywords">A set of user-defined flags to remove.</param>
  12962. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  12963. <param name="cancellationToken">The cancellation token.</param>
  12964. <exception cref="T:System.ArgumentNullException">
  12965. <paramref name="uids"/> is <c>null</c>.
  12966. </exception>
  12967. <exception cref="T:System.ArgumentException">
  12968. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  12969. <para>-or-</para>
  12970. <para>No flags were specified.</para>
  12971. </exception>
  12972. <exception cref="T:System.ObjectDisposedException">
  12973. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  12974. </exception>
  12975. <exception cref="T:MailKit.ServiceNotConnectedException">
  12976. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  12977. </exception>
  12978. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  12979. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  12980. </exception>
  12981. <exception cref="T:MailKit.FolderNotOpenException">
  12982. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  12983. </exception>
  12984. <exception cref="T:System.OperationCanceledException">
  12985. The operation was canceled via the cancellation token.
  12986. </exception>
  12987. <exception cref="T:System.IO.IOException">
  12988. An I/O error occurred.
  12989. </exception>
  12990. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  12991. The server's response contained unexpected tokens.
  12992. </exception>
  12993. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  12994. The server replied with a NO or BAD response.
  12995. </exception>
  12996. </member>
  12997. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  12998. <summary>
  12999. Asynchronously removes a set of flags from the specified messages.
  13000. </summary>
  13001. <remarks>
  13002. Removes a set of flags from the specified messages.
  13003. </remarks>
  13004. <returns>An asynchronous task context.</returns>
  13005. <param name="uids">The UIDs of the messages.</param>
  13006. <param name="flags">The message flags to remove.</param>
  13007. <param name="keywords">A set of user-defined flags to remove.</param>
  13008. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13009. <param name="cancellationToken">The cancellation token.</param>
  13010. <exception cref="T:System.ArgumentNullException">
  13011. <paramref name="uids"/> is <c>null</c>.
  13012. </exception>
  13013. <exception cref="T:System.ArgumentException">
  13014. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  13015. <para>-or-</para>
  13016. <para>No flags were specified.</para>
  13017. </exception>
  13018. <exception cref="T:System.ObjectDisposedException">
  13019. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13020. </exception>
  13021. <exception cref="T:MailKit.ServiceNotConnectedException">
  13022. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13023. </exception>
  13024. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13025. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13026. </exception>
  13027. <exception cref="T:MailKit.FolderNotOpenException">
  13028. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13029. </exception>
  13030. <exception cref="T:System.OperationCanceledException">
  13031. The operation was canceled via the cancellation token.
  13032. </exception>
  13033. <exception cref="T:System.IO.IOException">
  13034. An I/O error occurred.
  13035. </exception>
  13036. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13037. The server's response contained unexpected tokens.
  13038. </exception>
  13039. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13040. The server replied with a NO or BAD response.
  13041. </exception>
  13042. </member>
  13043. <member name="M:MailKit.Net.Imap.ImapFolder.SetFlags(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13044. <summary>
  13045. Sets the flags of the specified messages.
  13046. </summary>
  13047. <remarks>
  13048. Sets the flags of the specified messages.
  13049. </remarks>
  13050. <param name="uids">The UIDs of the messages.</param>
  13051. <param name="flags">The message flags to set.</param>
  13052. <param name="keywords">A set of user-defined flags to set.</param>
  13053. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13054. <param name="cancellationToken">The cancellation token.</param>
  13055. <exception cref="T:System.ArgumentNullException">
  13056. <paramref name="uids"/> is <c>null</c>.
  13057. </exception>
  13058. <exception cref="T:System.ArgumentException">
  13059. One or more of the <paramref name="uids"/> is invalid.
  13060. </exception>
  13061. <exception cref="T:System.ObjectDisposedException">
  13062. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13063. </exception>
  13064. <exception cref="T:MailKit.ServiceNotConnectedException">
  13065. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13066. </exception>
  13067. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13068. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13069. </exception>
  13070. <exception cref="T:MailKit.FolderNotOpenException">
  13071. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13072. </exception>
  13073. <exception cref="T:System.OperationCanceledException">
  13074. The operation was canceled via the cancellation token.
  13075. </exception>
  13076. <exception cref="T:System.IO.IOException">
  13077. An I/O error occurred.
  13078. </exception>
  13079. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13080. The server's response contained unexpected tokens.
  13081. </exception>
  13082. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13083. The server replied with a NO or BAD response.
  13084. </exception>
  13085. </member>
  13086. <member name="M:MailKit.Net.Imap.ImapFolder.SetFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13087. <summary>
  13088. Asynchronously sets the flags of the specified messages.
  13089. </summary>
  13090. <remarks>
  13091. Sets the flags of the specified messages.
  13092. </remarks>
  13093. <returns>An asynchronous task context.</returns>
  13094. <param name="uids">The UIDs of the messages.</param>
  13095. <param name="flags">The message flags to set.</param>
  13096. <param name="keywords">A set of user-defined flags to set.</param>
  13097. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13098. <param name="cancellationToken">The cancellation token.</param>
  13099. <exception cref="T:System.ArgumentNullException">
  13100. <paramref name="uids"/> is <c>null</c>.
  13101. </exception>
  13102. <exception cref="T:System.ArgumentException">
  13103. One or more of the <paramref name="uids"/> is invalid.
  13104. </exception>
  13105. <exception cref="T:System.ObjectDisposedException">
  13106. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13107. </exception>
  13108. <exception cref="T:MailKit.ServiceNotConnectedException">
  13109. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13110. </exception>
  13111. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13112. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13113. </exception>
  13114. <exception cref="T:MailKit.FolderNotOpenException">
  13115. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13116. </exception>
  13117. <exception cref="T:System.OperationCanceledException">
  13118. The operation was canceled via the cancellation token.
  13119. </exception>
  13120. <exception cref="T:System.IO.IOException">
  13121. An I/O error occurred.
  13122. </exception>
  13123. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13124. The server's response contained unexpected tokens.
  13125. </exception>
  13126. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13127. The server replied with a NO or BAD response.
  13128. </exception>
  13129. </member>
  13130. <member name="M:MailKit.Net.Imap.ImapFolder.AddFlags(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13131. <summary>
  13132. Adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  13133. </summary>
  13134. <remarks>
  13135. Adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  13136. </remarks>
  13137. <returns>The unique IDs of the messages that were not updated.</returns>
  13138. <param name="uids">The UIDs of the messages.</param>
  13139. <param name="modseq">The mod-sequence value.</param>
  13140. <param name="flags">The message flags to add.</param>
  13141. <param name="keywords">A set of user-defined flags to add.</param>
  13142. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13143. <param name="cancellationToken">The cancellation token.</param>
  13144. <exception cref="T:System.ArgumentNullException">
  13145. <paramref name="uids"/> is <c>null</c>.
  13146. </exception>
  13147. <exception cref="T:System.ArgumentException">
  13148. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  13149. <para>-or-</para>
  13150. <para>No flags were specified.</para>
  13151. </exception>
  13152. <exception cref="T:System.ObjectDisposedException">
  13153. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13154. </exception>
  13155. <exception cref="T:MailKit.ServiceNotConnectedException">
  13156. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13157. </exception>
  13158. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13159. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13160. </exception>
  13161. <exception cref="T:MailKit.FolderNotOpenException">
  13162. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13163. </exception>
  13164. <exception cref="T:System.NotSupportedException">
  13165. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  13166. </exception>
  13167. <exception cref="T:System.OperationCanceledException">
  13168. The operation was canceled via the cancellation token.
  13169. </exception>
  13170. <exception cref="T:System.IO.IOException">
  13171. An I/O error occurred.
  13172. </exception>
  13173. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13174. The server's response contained unexpected tokens.
  13175. </exception>
  13176. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13177. The server replied with a NO or BAD response.
  13178. </exception>
  13179. </member>
  13180. <member name="M:MailKit.Net.Imap.ImapFolder.AddFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13181. <summary>
  13182. Asynchronously adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  13183. </summary>
  13184. <remarks>
  13185. Adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  13186. </remarks>
  13187. <returns>The unique IDs of the messages that were not updated.</returns>
  13188. <param name="uids">The UIDs of the messages.</param>
  13189. <param name="modseq">The mod-sequence value.</param>
  13190. <param name="flags">The message flags to add.</param>
  13191. <param name="keywords">A set of user-defined flags to add.</param>
  13192. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13193. <param name="cancellationToken">The cancellation token.</param>
  13194. <exception cref="T:System.ArgumentNullException">
  13195. <paramref name="uids"/> is <c>null</c>.
  13196. </exception>
  13197. <exception cref="T:System.ArgumentException">
  13198. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  13199. <para>-or-</para>
  13200. <para>No flags were specified.</para>
  13201. </exception>
  13202. <exception cref="T:System.ObjectDisposedException">
  13203. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13204. </exception>
  13205. <exception cref="T:MailKit.ServiceNotConnectedException">
  13206. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13207. </exception>
  13208. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13209. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13210. </exception>
  13211. <exception cref="T:MailKit.FolderNotOpenException">
  13212. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13213. </exception>
  13214. <exception cref="T:System.NotSupportedException">
  13215. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  13216. </exception>
  13217. <exception cref="T:System.OperationCanceledException">
  13218. The operation was canceled via the cancellation token.
  13219. </exception>
  13220. <exception cref="T:System.IO.IOException">
  13221. An I/O error occurred.
  13222. </exception>
  13223. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13224. The server's response contained unexpected tokens.
  13225. </exception>
  13226. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13227. The server replied with a NO or BAD response.
  13228. </exception>
  13229. </member>
  13230. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveFlags(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13231. <summary>
  13232. Removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  13233. </summary>
  13234. <remarks>
  13235. Removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  13236. </remarks>
  13237. <returns>The unique IDs of the messages that were not updated.</returns>
  13238. <param name="uids">The UIDs of the messages.</param>
  13239. <param name="modseq">The mod-sequence value.</param>
  13240. <param name="flags">The message flags to remove.</param>
  13241. <param name="keywords">A set of user-defined flags to remove.</param>
  13242. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13243. <param name="cancellationToken">The cancellation token.</param>
  13244. <exception cref="T:System.ArgumentNullException">
  13245. <paramref name="uids"/> is <c>null</c>.
  13246. </exception>
  13247. <exception cref="T:System.ArgumentException">
  13248. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  13249. <para>-or-</para>
  13250. <para>No flags were specified.</para>
  13251. </exception>
  13252. <exception cref="T:System.ObjectDisposedException">
  13253. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13254. </exception>
  13255. <exception cref="T:MailKit.ServiceNotConnectedException">
  13256. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13257. </exception>
  13258. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13259. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13260. </exception>
  13261. <exception cref="T:MailKit.FolderNotOpenException">
  13262. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13263. </exception>
  13264. <exception cref="T:System.NotSupportedException">
  13265. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  13266. </exception>
  13267. <exception cref="T:System.OperationCanceledException">
  13268. The operation was canceled via the cancellation token.
  13269. </exception>
  13270. <exception cref="T:System.IO.IOException">
  13271. An I/O error occurred.
  13272. </exception>
  13273. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13274. The server's response contained unexpected tokens.
  13275. </exception>
  13276. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13277. The server replied with a NO or BAD response.
  13278. </exception>
  13279. </member>
  13280. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13281. <summary>
  13282. Asynchronously removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  13283. </summary>
  13284. <remarks>
  13285. Removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  13286. </remarks>
  13287. <returns>The unique IDs of the messages that were not updated.</returns>
  13288. <param name="uids">The UIDs of the messages.</param>
  13289. <param name="modseq">The mod-sequence value.</param>
  13290. <param name="flags">The message flags to remove.</param>
  13291. <param name="keywords">A set of user-defined flags to remove.</param>
  13292. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13293. <param name="cancellationToken">The cancellation token.</param>
  13294. <exception cref="T:System.ArgumentNullException">
  13295. <paramref name="uids"/> is <c>null</c>.
  13296. </exception>
  13297. <exception cref="T:System.ArgumentException">
  13298. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  13299. <para>-or-</para>
  13300. <para>No flags were specified.</para>
  13301. </exception>
  13302. <exception cref="T:System.ObjectDisposedException">
  13303. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13304. </exception>
  13305. <exception cref="T:MailKit.ServiceNotConnectedException">
  13306. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13307. </exception>
  13308. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13309. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13310. </exception>
  13311. <exception cref="T:MailKit.FolderNotOpenException">
  13312. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13313. </exception>
  13314. <exception cref="T:System.NotSupportedException">
  13315. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  13316. </exception>
  13317. <exception cref="T:System.OperationCanceledException">
  13318. The operation was canceled via the cancellation token.
  13319. </exception>
  13320. <exception cref="T:System.IO.IOException">
  13321. An I/O error occurred.
  13322. </exception>
  13323. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13324. The server's response contained unexpected tokens.
  13325. </exception>
  13326. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13327. The server replied with a NO or BAD response.
  13328. </exception>
  13329. </member>
  13330. <member name="M:MailKit.Net.Imap.ImapFolder.SetFlags(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13331. <summary>
  13332. Sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  13333. </summary>
  13334. <remarks>
  13335. Sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  13336. </remarks>
  13337. <returns>The unique IDs of the messages that were not updated.</returns>
  13338. <param name="uids">The UIDs of the messages.</param>
  13339. <param name="modseq">The mod-sequence value.</param>
  13340. <param name="flags">The message flags to set.</param>
  13341. <param name="keywords">A set of user-defined flags to set.</param>
  13342. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13343. <param name="cancellationToken">The cancellation token.</param>
  13344. <exception cref="T:System.ArgumentNullException">
  13345. <paramref name="uids"/> is <c>null</c>.
  13346. </exception>
  13347. <exception cref="T:System.ArgumentException">
  13348. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  13349. </exception>
  13350. <exception cref="T:System.ObjectDisposedException">
  13351. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13352. </exception>
  13353. <exception cref="T:MailKit.ServiceNotConnectedException">
  13354. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13355. </exception>
  13356. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13357. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13358. </exception>
  13359. <exception cref="T:MailKit.FolderNotOpenException">
  13360. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13361. </exception>
  13362. <exception cref="T:System.NotSupportedException">
  13363. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  13364. </exception>
  13365. <exception cref="T:System.OperationCanceledException">
  13366. The operation was canceled via the cancellation token.
  13367. </exception>
  13368. <exception cref="T:System.IO.IOException">
  13369. An I/O error occurred.
  13370. </exception>
  13371. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13372. The server's response contained unexpected tokens.
  13373. </exception>
  13374. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13375. The server replied with a NO or BAD response.
  13376. </exception>
  13377. </member>
  13378. <member name="M:MailKit.Net.Imap.ImapFolder.SetFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13379. <summary>
  13380. Asynchronously sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  13381. </summary>
  13382. <remarks>
  13383. Sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  13384. </remarks>
  13385. <returns>The unique IDs of the messages that were not updated.</returns>
  13386. <param name="uids">The UIDs of the messages.</param>
  13387. <param name="modseq">The mod-sequence value.</param>
  13388. <param name="flags">The message flags to set.</param>
  13389. <param name="keywords">A set of user-defined flags to set.</param>
  13390. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13391. <param name="cancellationToken">The cancellation token.</param>
  13392. <exception cref="T:System.ArgumentNullException">
  13393. <paramref name="uids"/> is <c>null</c>.
  13394. </exception>
  13395. <exception cref="T:System.ArgumentException">
  13396. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  13397. </exception>
  13398. <exception cref="T:System.ObjectDisposedException">
  13399. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13400. </exception>
  13401. <exception cref="T:MailKit.ServiceNotConnectedException">
  13402. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13403. </exception>
  13404. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13405. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13406. </exception>
  13407. <exception cref="T:MailKit.FolderNotOpenException">
  13408. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13409. </exception>
  13410. <exception cref="T:System.NotSupportedException">
  13411. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  13412. </exception>
  13413. <exception cref="T:System.OperationCanceledException">
  13414. The operation was canceled via the cancellation token.
  13415. </exception>
  13416. <exception cref="T:System.IO.IOException">
  13417. An I/O error occurred.
  13418. </exception>
  13419. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13420. The server's response contained unexpected tokens.
  13421. </exception>
  13422. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13423. The server replied with a NO or BAD response.
  13424. </exception>
  13425. </member>
  13426. <member name="M:MailKit.Net.Imap.ImapFolder.AddFlags(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13427. <summary>
  13428. Adds a set of flags to the specified messages.
  13429. </summary>
  13430. <remarks>
  13431. Adds a set of flags to the specified messages.
  13432. </remarks>
  13433. <param name="indexes">The indexes of the messages.</param>
  13434. <param name="flags">The message flags to add.</param>
  13435. <param name="keywords">A set of user-defined flags to add.</param>
  13436. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13437. <param name="cancellationToken">The cancellation token.</param>
  13438. <exception cref="T:System.ArgumentNullException">
  13439. <paramref name="indexes"/> is <c>null</c>.
  13440. </exception>
  13441. <exception cref="T:System.ArgumentException">
  13442. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  13443. <para>-or-</para>
  13444. <para>No flags were specified.</para>
  13445. </exception>
  13446. <exception cref="T:System.ObjectDisposedException">
  13447. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13448. </exception>
  13449. <exception cref="T:MailKit.ServiceNotConnectedException">
  13450. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13451. </exception>
  13452. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13453. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13454. </exception>
  13455. <exception cref="T:MailKit.FolderNotOpenException">
  13456. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13457. </exception>
  13458. <exception cref="T:System.OperationCanceledException">
  13459. The operation was canceled via the cancellation token.
  13460. </exception>
  13461. <exception cref="T:System.IO.IOException">
  13462. An I/O error occurred.
  13463. </exception>
  13464. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13465. The server's response contained unexpected tokens.
  13466. </exception>
  13467. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13468. The server replied with a NO or BAD response.
  13469. </exception>
  13470. </member>
  13471. <member name="M:MailKit.Net.Imap.ImapFolder.AddFlagsAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13472. <summary>
  13473. Asynchronously adds a set of flags to the specified messages.
  13474. </summary>
  13475. <remarks>
  13476. Adds a set of flags to the specified messages.
  13477. </remarks>
  13478. <returns>An asynchronous task context.</returns>
  13479. <param name="indexes">The indexes of the messages.</param>
  13480. <param name="flags">The message flags to add.</param>
  13481. <param name="keywords">A set of user-defined flags to add.</param>
  13482. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13483. <param name="cancellationToken">The cancellation token.</param>
  13484. <exception cref="T:System.ArgumentNullException">
  13485. <paramref name="indexes"/> is <c>null</c>.
  13486. </exception>
  13487. <exception cref="T:System.ArgumentException">
  13488. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  13489. <para>-or-</para>
  13490. <para>No flags were specified.</para>
  13491. </exception>
  13492. <exception cref="T:System.ObjectDisposedException">
  13493. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13494. </exception>
  13495. <exception cref="T:MailKit.ServiceNotConnectedException">
  13496. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13497. </exception>
  13498. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13499. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13500. </exception>
  13501. <exception cref="T:MailKit.FolderNotOpenException">
  13502. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13503. </exception>
  13504. <exception cref="T:System.OperationCanceledException">
  13505. The operation was canceled via the cancellation token.
  13506. </exception>
  13507. <exception cref="T:System.IO.IOException">
  13508. An I/O error occurred.
  13509. </exception>
  13510. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13511. The server's response contained unexpected tokens.
  13512. </exception>
  13513. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13514. The server replied with a NO or BAD response.
  13515. </exception>
  13516. </member>
  13517. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveFlags(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13518. <summary>
  13519. Removes a set of flags from the specified messages.
  13520. </summary>
  13521. <remarks>
  13522. Removes a set of flags from the specified messages.
  13523. </remarks>
  13524. <param name="indexes">The indexes of the messages.</param>
  13525. <param name="flags">The message flags to remove.</param>
  13526. <param name="keywords">A set of user-defined flags to remove.</param>
  13527. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13528. <param name="cancellationToken">The cancellation token.</param>
  13529. <exception cref="T:System.ArgumentNullException">
  13530. <paramref name="indexes"/> is <c>null</c>.
  13531. </exception>
  13532. <exception cref="T:System.ArgumentException">
  13533. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  13534. <para>-or-</para>
  13535. <para>No flags were specified.</para>
  13536. </exception>
  13537. <exception cref="T:System.ObjectDisposedException">
  13538. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13539. </exception>
  13540. <exception cref="T:MailKit.ServiceNotConnectedException">
  13541. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13542. </exception>
  13543. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13544. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13545. </exception>
  13546. <exception cref="T:MailKit.FolderNotOpenException">
  13547. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13548. </exception>
  13549. <exception cref="T:System.OperationCanceledException">
  13550. The operation was canceled via the cancellation token.
  13551. </exception>
  13552. <exception cref="T:System.IO.IOException">
  13553. An I/O error occurred.
  13554. </exception>
  13555. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13556. The server's response contained unexpected tokens.
  13557. </exception>
  13558. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13559. The server replied with a NO or BAD response.
  13560. </exception>
  13561. </member>
  13562. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveFlagsAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13563. <summary>
  13564. Asynchronously removes a set of flags from the specified messages.
  13565. </summary>
  13566. <remarks>
  13567. Removes a set of flags from the specified messages.
  13568. </remarks>
  13569. <returns>An asynchronous task context.</returns>
  13570. <param name="indexes">The indexes of the messages.</param>
  13571. <param name="flags">The message flags to remove.</param>
  13572. <param name="keywords">A set of user-defined flags to remove.</param>
  13573. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13574. <param name="cancellationToken">The cancellation token.</param>
  13575. <exception cref="T:System.ArgumentNullException">
  13576. <paramref name="indexes"/> is <c>null</c>.
  13577. </exception>
  13578. <exception cref="T:System.ArgumentException">
  13579. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  13580. <para>-or-</para>
  13581. <para>No flags were specified.</para>
  13582. </exception>
  13583. <exception cref="T:System.ObjectDisposedException">
  13584. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13585. </exception>
  13586. <exception cref="T:MailKit.ServiceNotConnectedException">
  13587. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13588. </exception>
  13589. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13590. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13591. </exception>
  13592. <exception cref="T:MailKit.FolderNotOpenException">
  13593. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13594. </exception>
  13595. <exception cref="T:System.OperationCanceledException">
  13596. The operation was canceled via the cancellation token.
  13597. </exception>
  13598. <exception cref="T:System.IO.IOException">
  13599. An I/O error occurred.
  13600. </exception>
  13601. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13602. The server's response contained unexpected tokens.
  13603. </exception>
  13604. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13605. The server replied with a NO or BAD response.
  13606. </exception>
  13607. </member>
  13608. <member name="M:MailKit.Net.Imap.ImapFolder.SetFlags(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13609. <summary>
  13610. Sets the flags of the specified messages.
  13611. </summary>
  13612. <remarks>
  13613. Sets the flags of the specified messages.
  13614. </remarks>
  13615. <param name="indexes">The indexes of the messages.</param>
  13616. <param name="flags">The message flags to set.</param>
  13617. <param name="keywords">A set of user-defined flags to set.</param>
  13618. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13619. <param name="cancellationToken">The cancellation token.</param>
  13620. <exception cref="T:System.ArgumentNullException">
  13621. <paramref name="indexes"/> is <c>null</c>.
  13622. </exception>
  13623. <exception cref="T:System.ArgumentException">
  13624. One or more of the <paramref name="indexes"/> is invalid.
  13625. </exception>
  13626. <exception cref="T:System.ObjectDisposedException">
  13627. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13628. </exception>
  13629. <exception cref="T:MailKit.ServiceNotConnectedException">
  13630. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13631. </exception>
  13632. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13633. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13634. </exception>
  13635. <exception cref="T:MailKit.FolderNotOpenException">
  13636. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13637. </exception>
  13638. <exception cref="T:System.OperationCanceledException">
  13639. The operation was canceled via the cancellation token.
  13640. </exception>
  13641. <exception cref="T:System.IO.IOException">
  13642. An I/O error occurred.
  13643. </exception>
  13644. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13645. The server's response contained unexpected tokens.
  13646. </exception>
  13647. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13648. The server replied with a NO or BAD response.
  13649. </exception>
  13650. </member>
  13651. <member name="M:MailKit.Net.Imap.ImapFolder.SetFlagsAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13652. <summary>
  13653. Asynchronously sets the flags of the specified messages.
  13654. </summary>
  13655. <remarks>
  13656. Sets the flags of the specified messages.
  13657. </remarks>
  13658. <returns>An asynchronous task context.</returns>
  13659. <param name="indexes">The indexes of the messages.</param>
  13660. <param name="flags">The message flags to set.</param>
  13661. <param name="keywords">A set of user-defined flags to set.</param>
  13662. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13663. <param name="cancellationToken">The cancellation token.</param>
  13664. <exception cref="T:System.ArgumentNullException">
  13665. <paramref name="indexes"/> is <c>null</c>.
  13666. </exception>
  13667. <exception cref="T:System.ArgumentException">
  13668. One or more of the <paramref name="indexes"/> is invalid.
  13669. </exception>
  13670. <exception cref="T:System.ObjectDisposedException">
  13671. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13672. </exception>
  13673. <exception cref="T:MailKit.ServiceNotConnectedException">
  13674. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13675. </exception>
  13676. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13677. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13678. </exception>
  13679. <exception cref="T:MailKit.FolderNotOpenException">
  13680. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13681. </exception>
  13682. <exception cref="T:System.OperationCanceledException">
  13683. The operation was canceled via the cancellation token.
  13684. </exception>
  13685. <exception cref="T:System.IO.IOException">
  13686. An I/O error occurred.
  13687. </exception>
  13688. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13689. The server's response contained unexpected tokens.
  13690. </exception>
  13691. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13692. The server replied with a NO or BAD response.
  13693. </exception>
  13694. </member>
  13695. <member name="M:MailKit.Net.Imap.ImapFolder.AddFlags(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13696. <summary>
  13697. Adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  13698. </summary>
  13699. <remarks>
  13700. Adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  13701. </remarks>
  13702. <returns>The indexes of the messages that were not updated.</returns>
  13703. <param name="indexes">The indexes of the messages.</param>
  13704. <param name="modseq">The mod-sequence value.</param>
  13705. <param name="flags">The message flags to add.</param>
  13706. <param name="keywords">A set of user-defined flags to add.</param>
  13707. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13708. <param name="cancellationToken">The cancellation token.</param>
  13709. <exception cref="T:System.ArgumentNullException">
  13710. <paramref name="indexes"/> is <c>null</c>.
  13711. </exception>
  13712. <exception cref="T:System.ArgumentException">
  13713. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  13714. <para>-or-</para>
  13715. <para>No flags were specified.</para>
  13716. </exception>
  13717. <exception cref="T:System.ObjectDisposedException">
  13718. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13719. </exception>
  13720. <exception cref="T:MailKit.ServiceNotConnectedException">
  13721. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13722. </exception>
  13723. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13724. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13725. </exception>
  13726. <exception cref="T:MailKit.FolderNotOpenException">
  13727. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13728. </exception>
  13729. <exception cref="T:System.NotSupportedException">
  13730. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  13731. </exception>
  13732. <exception cref="T:System.OperationCanceledException">
  13733. The operation was canceled via the cancellation token.
  13734. </exception>
  13735. <exception cref="T:System.IO.IOException">
  13736. An I/O error occurred.
  13737. </exception>
  13738. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13739. The server's response contained unexpected tokens.
  13740. </exception>
  13741. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13742. The server replied with a NO or BAD response.
  13743. </exception>
  13744. </member>
  13745. <member name="M:MailKit.Net.Imap.ImapFolder.AddFlagsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13746. <summary>
  13747. Asynchronously adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  13748. </summary>
  13749. <remarks>
  13750. Adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  13751. </remarks>
  13752. <returns>The indexes of the messages that were not updated.</returns>
  13753. <param name="indexes">The indexes of the messages.</param>
  13754. <param name="modseq">The mod-sequence value.</param>
  13755. <param name="flags">The message flags to add.</param>
  13756. <param name="keywords">A set of user-defined flags to add.</param>
  13757. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13758. <param name="cancellationToken">The cancellation token.</param>
  13759. <exception cref="T:System.ArgumentNullException">
  13760. <paramref name="indexes"/> is <c>null</c>.
  13761. </exception>
  13762. <exception cref="T:System.ArgumentException">
  13763. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  13764. <para>-or-</para>
  13765. <para>No flags were specified.</para>
  13766. </exception>
  13767. <exception cref="T:System.ObjectDisposedException">
  13768. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13769. </exception>
  13770. <exception cref="T:MailKit.ServiceNotConnectedException">
  13771. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13772. </exception>
  13773. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13774. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13775. </exception>
  13776. <exception cref="T:MailKit.FolderNotOpenException">
  13777. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13778. </exception>
  13779. <exception cref="T:System.NotSupportedException">
  13780. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  13781. </exception>
  13782. <exception cref="T:System.OperationCanceledException">
  13783. The operation was canceled via the cancellation token.
  13784. </exception>
  13785. <exception cref="T:System.IO.IOException">
  13786. An I/O error occurred.
  13787. </exception>
  13788. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13789. The server's response contained unexpected tokens.
  13790. </exception>
  13791. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13792. The server replied with a NO or BAD response.
  13793. </exception>
  13794. </member>
  13795. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveFlags(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13796. <summary>
  13797. Removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  13798. </summary>
  13799. <remarks>
  13800. Removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  13801. </remarks>
  13802. <returns>The indexes of the messages that were not updated.</returns>
  13803. <param name="indexes">The indexes of the messages.</param>
  13804. <param name="modseq">The mod-sequence value.</param>
  13805. <param name="flags">The message flags to remove.</param>
  13806. <param name="keywords">A set of user-defined flags to remove.</param>
  13807. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13808. <param name="cancellationToken">The cancellation token.</param>
  13809. <exception cref="T:System.ArgumentNullException">
  13810. <paramref name="indexes"/> is <c>null</c>.
  13811. </exception>
  13812. <exception cref="T:System.ArgumentException">
  13813. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  13814. <para>-or-</para>
  13815. <para>No flags were specified.</para>
  13816. </exception>
  13817. <exception cref="T:System.ObjectDisposedException">
  13818. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13819. </exception>
  13820. <exception cref="T:MailKit.ServiceNotConnectedException">
  13821. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13822. </exception>
  13823. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13824. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13825. </exception>
  13826. <exception cref="T:MailKit.FolderNotOpenException">
  13827. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13828. </exception>
  13829. <exception cref="T:System.NotSupportedException">
  13830. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  13831. </exception>
  13832. <exception cref="T:System.OperationCanceledException">
  13833. The operation was canceled via the cancellation token.
  13834. </exception>
  13835. <exception cref="T:System.IO.IOException">
  13836. An I/O error occurred.
  13837. </exception>
  13838. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13839. The server's response contained unexpected tokens.
  13840. </exception>
  13841. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13842. The server replied with a NO or BAD response.
  13843. </exception>
  13844. </member>
  13845. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveFlagsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13846. <summary>
  13847. Asynchronously removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  13848. </summary>
  13849. <remarks>
  13850. Removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  13851. </remarks>
  13852. <returns>The indexes of the messages that were not updated.</returns>
  13853. <param name="indexes">The indexes of the messages.</param>
  13854. <param name="modseq">The mod-sequence value.</param>
  13855. <param name="flags">The message flags to remove.</param>
  13856. <param name="keywords">A set of user-defined flags to remove.</param>
  13857. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13858. <param name="cancellationToken">The cancellation token.</param>
  13859. <exception cref="T:System.ArgumentNullException">
  13860. <paramref name="indexes"/> is <c>null</c>.
  13861. </exception>
  13862. <exception cref="T:System.ArgumentException">
  13863. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  13864. <para>-or-</para>
  13865. <para>No flags were specified.</para>
  13866. </exception>
  13867. <exception cref="T:System.ObjectDisposedException">
  13868. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13869. </exception>
  13870. <exception cref="T:MailKit.ServiceNotConnectedException">
  13871. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13872. </exception>
  13873. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13874. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13875. </exception>
  13876. <exception cref="T:MailKit.FolderNotOpenException">
  13877. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13878. </exception>
  13879. <exception cref="T:System.NotSupportedException">
  13880. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  13881. </exception>
  13882. <exception cref="T:System.OperationCanceledException">
  13883. The operation was canceled via the cancellation token.
  13884. </exception>
  13885. <exception cref="T:System.IO.IOException">
  13886. An I/O error occurred.
  13887. </exception>
  13888. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13889. The server's response contained unexpected tokens.
  13890. </exception>
  13891. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13892. The server replied with a NO or BAD response.
  13893. </exception>
  13894. </member>
  13895. <member name="M:MailKit.Net.Imap.ImapFolder.SetFlags(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13896. <summary>
  13897. Sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  13898. </summary>
  13899. <remarks>
  13900. Sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  13901. </remarks>
  13902. <returns>The indexes of the messages that were not updated.</returns>
  13903. <param name="indexes">The indexes of the messages.</param>
  13904. <param name="modseq">The mod-sequence value.</param>
  13905. <param name="flags">The message flags to set.</param>
  13906. <param name="keywords">A set of user-defined flags to set.</param>
  13907. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13908. <param name="cancellationToken">The cancellation token.</param>
  13909. <exception cref="T:System.ArgumentNullException">
  13910. <paramref name="indexes"/> is <c>null</c>.
  13911. </exception>
  13912. <exception cref="T:System.ArgumentException">
  13913. One or more of the <paramref name="indexes"/> is invalid.
  13914. </exception>
  13915. <exception cref="T:System.ObjectDisposedException">
  13916. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13917. </exception>
  13918. <exception cref="T:MailKit.ServiceNotConnectedException">
  13919. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13920. </exception>
  13921. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13922. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13923. </exception>
  13924. <exception cref="T:MailKit.FolderNotOpenException">
  13925. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13926. </exception>
  13927. <exception cref="T:System.NotSupportedException">
  13928. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  13929. </exception>
  13930. <exception cref="T:System.OperationCanceledException">
  13931. The operation was canceled via the cancellation token.
  13932. </exception>
  13933. <exception cref="T:System.IO.IOException">
  13934. An I/O error occurred.
  13935. </exception>
  13936. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13937. The server's response contained unexpected tokens.
  13938. </exception>
  13939. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13940. The server replied with a NO or BAD response.
  13941. </exception>
  13942. </member>
  13943. <member name="M:MailKit.Net.Imap.ImapFolder.SetFlagsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  13944. <summary>
  13945. Asynchronously sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  13946. </summary>
  13947. <remarks>
  13948. Sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  13949. </remarks>
  13950. <returns>The indexes of the messages that were not updated.</returns>
  13951. <param name="indexes">The indexes of the messages.</param>
  13952. <param name="modseq">The mod-sequence value.</param>
  13953. <param name="flags">The message flags to set.</param>
  13954. <param name="keywords">A set of user-defined flags to set.</param>
  13955. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  13956. <param name="cancellationToken">The cancellation token.</param>
  13957. <exception cref="T:System.ArgumentNullException">
  13958. <paramref name="indexes"/> is <c>null</c>.
  13959. </exception>
  13960. <exception cref="T:System.ArgumentException">
  13961. One or more of the <paramref name="indexes"/> is invalid.
  13962. </exception>
  13963. <exception cref="T:System.ObjectDisposedException">
  13964. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  13965. </exception>
  13966. <exception cref="T:MailKit.ServiceNotConnectedException">
  13967. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  13968. </exception>
  13969. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  13970. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  13971. </exception>
  13972. <exception cref="T:MailKit.FolderNotOpenException">
  13973. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  13974. </exception>
  13975. <exception cref="T:System.NotSupportedException">
  13976. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> does not support mod-sequences.
  13977. </exception>
  13978. <exception cref="T:System.OperationCanceledException">
  13979. The operation was canceled via the cancellation token.
  13980. </exception>
  13981. <exception cref="T:System.IO.IOException">
  13982. An I/O error occurred.
  13983. </exception>
  13984. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  13985. The server's response contained unexpected tokens.
  13986. </exception>
  13987. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  13988. The server replied with a NO or BAD response.
  13989. </exception>
  13990. </member>
  13991. <member name="M:MailKit.Net.Imap.ImapFolder.AddLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  13992. <summary>
  13993. Add a set of labels to the specified messages.
  13994. </summary>
  13995. <remarks>
  13996. Adds a set of labels to the specified messages.
  13997. </remarks>
  13998. <param name="uids">The UIDs of the messages.</param>
  13999. <param name="labels">The labels to add.</param>
  14000. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14001. <param name="cancellationToken">The cancellation token.</param>
  14002. <exception cref="T:System.ArgumentNullException">
  14003. <para><paramref name="uids"/> is <c>null</c>.</para>
  14004. <para>-or-</para>
  14005. <para><paramref name="labels"/> is <c>null</c>.</para>
  14006. </exception>
  14007. <exception cref="T:System.ArgumentException">
  14008. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  14009. <para>-or-</para>
  14010. <para>No labels were specified.</para>
  14011. </exception>
  14012. <exception cref="T:System.ObjectDisposedException">
  14013. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14014. </exception>
  14015. <exception cref="T:MailKit.ServiceNotConnectedException">
  14016. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14017. </exception>
  14018. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14019. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14020. </exception>
  14021. <exception cref="T:MailKit.FolderNotOpenException">
  14022. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14023. </exception>
  14024. <exception cref="T:System.OperationCanceledException">
  14025. The operation was canceled via the cancellation token.
  14026. </exception>
  14027. <exception cref="T:System.IO.IOException">
  14028. An I/O error occurred.
  14029. </exception>
  14030. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14031. The server's response contained unexpected tokens.
  14032. </exception>
  14033. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14034. The server replied with a NO or BAD response.
  14035. </exception>
  14036. </member>
  14037. <member name="M:MailKit.Net.Imap.ImapFolder.AddLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14038. <summary>
  14039. Asynchronously add a set of labels to the specified messages.
  14040. </summary>
  14041. <remarks>
  14042. Adds a set of labels to the specified messages.
  14043. </remarks>
  14044. <returns>An asynchronous task context.</returns>
  14045. <param name="uids">The UIDs of the messages.</param>
  14046. <param name="labels">The labels to add.</param>
  14047. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14048. <param name="cancellationToken">The cancellation token.</param>
  14049. <exception cref="T:System.ArgumentNullException">
  14050. <para><paramref name="uids"/> is <c>null</c>.</para>
  14051. <para>-or-</para>
  14052. <para><paramref name="labels"/> is <c>null</c>.</para>
  14053. </exception>
  14054. <exception cref="T:System.ArgumentException">
  14055. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  14056. <para>-or-</para>
  14057. <para>No labels were specified.</para>
  14058. </exception>
  14059. <exception cref="T:System.ObjectDisposedException">
  14060. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14061. </exception>
  14062. <exception cref="T:MailKit.ServiceNotConnectedException">
  14063. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14064. </exception>
  14065. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14066. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14067. </exception>
  14068. <exception cref="T:MailKit.FolderNotOpenException">
  14069. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14070. </exception>
  14071. <exception cref="T:System.OperationCanceledException">
  14072. The operation was canceled via the cancellation token.
  14073. </exception>
  14074. <exception cref="T:System.IO.IOException">
  14075. An I/O error occurred.
  14076. </exception>
  14077. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14078. The server's response contained unexpected tokens.
  14079. </exception>
  14080. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14081. The server replied with a NO or BAD response.
  14082. </exception>
  14083. </member>
  14084. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14085. <summary>
  14086. Remove a set of labels from the specified messages.
  14087. </summary>
  14088. <remarks>
  14089. Removes a set of labels from the specified messages.
  14090. </remarks>
  14091. <param name="uids">The UIDs of the messages.</param>
  14092. <param name="labels">The labels to remove.</param>
  14093. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14094. <param name="cancellationToken">The cancellation token.</param>
  14095. <exception cref="T:System.ArgumentNullException">
  14096. <para><paramref name="uids"/> is <c>null</c>.</para>
  14097. <para>-or-</para>
  14098. <para><paramref name="labels"/> is <c>null</c>.</para>
  14099. </exception>
  14100. <exception cref="T:System.ArgumentException">
  14101. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  14102. <para>-or-</para>
  14103. <para>No labels were specified.</para>
  14104. </exception>
  14105. <exception cref="T:System.ObjectDisposedException">
  14106. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14107. </exception>
  14108. <exception cref="T:MailKit.ServiceNotConnectedException">
  14109. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14110. </exception>
  14111. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14112. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14113. </exception>
  14114. <exception cref="T:MailKit.FolderNotOpenException">
  14115. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14116. </exception>
  14117. <exception cref="T:System.OperationCanceledException">
  14118. The operation was canceled via the cancellation token.
  14119. </exception>
  14120. <exception cref="T:System.IO.IOException">
  14121. An I/O error occurred.
  14122. </exception>
  14123. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14124. The server's response contained unexpected tokens.
  14125. </exception>
  14126. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14127. The server replied with a NO or BAD response.
  14128. </exception>
  14129. </member>
  14130. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14131. <summary>
  14132. Asynchronously remove a set of labels from the specified messages.
  14133. </summary>
  14134. <remarks>
  14135. Removes a set of labels from the specified messages.
  14136. </remarks>
  14137. <returns>An asynchronous task context.</returns>
  14138. <param name="uids">The UIDs of the messages.</param>
  14139. <param name="labels">The labels to remove.</param>
  14140. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14141. <param name="cancellationToken">The cancellation token.</param>
  14142. <exception cref="T:System.ArgumentNullException">
  14143. <para><paramref name="uids"/> is <c>null</c>.</para>
  14144. <para>-or-</para>
  14145. <para><paramref name="labels"/> is <c>null</c>.</para>
  14146. </exception>
  14147. <exception cref="T:System.ArgumentException">
  14148. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  14149. <para>-or-</para>
  14150. <para>No labels were specified.</para>
  14151. </exception>
  14152. <exception cref="T:System.ObjectDisposedException">
  14153. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14154. </exception>
  14155. <exception cref="T:MailKit.ServiceNotConnectedException">
  14156. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14157. </exception>
  14158. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14159. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14160. </exception>
  14161. <exception cref="T:MailKit.FolderNotOpenException">
  14162. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14163. </exception>
  14164. <exception cref="T:System.OperationCanceledException">
  14165. The operation was canceled via the cancellation token.
  14166. </exception>
  14167. <exception cref="T:System.IO.IOException">
  14168. An I/O error occurred.
  14169. </exception>
  14170. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14171. The server's response contained unexpected tokens.
  14172. </exception>
  14173. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14174. The server replied with a NO or BAD response.
  14175. </exception>
  14176. </member>
  14177. <member name="M:MailKit.Net.Imap.ImapFolder.SetLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14178. <summary>
  14179. Set the labels of the specified messages.
  14180. </summary>
  14181. <remarks>
  14182. Sets the labels of the specified messages.
  14183. </remarks>
  14184. <param name="uids">The UIDs of the messages.</param>
  14185. <param name="labels">The labels to set.</param>
  14186. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14187. <param name="cancellationToken">The cancellation token.</param>
  14188. <exception cref="T:System.ArgumentNullException">
  14189. <para><paramref name="uids"/> is <c>null</c>.</para>
  14190. <para>-or-</para>
  14191. <para><paramref name="labels"/> is <c>null</c>.</para>
  14192. </exception>
  14193. <exception cref="T:System.ArgumentException">
  14194. One or more of the <paramref name="uids"/> is invalid.
  14195. </exception>
  14196. <exception cref="T:System.ObjectDisposedException">
  14197. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14198. </exception>
  14199. <exception cref="T:MailKit.ServiceNotConnectedException">
  14200. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14201. </exception>
  14202. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14203. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14204. </exception>
  14205. <exception cref="T:MailKit.FolderNotOpenException">
  14206. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14207. </exception>
  14208. <exception cref="T:System.OperationCanceledException">
  14209. The operation was canceled via the cancellation token.
  14210. </exception>
  14211. <exception cref="T:System.IO.IOException">
  14212. An I/O error occurred.
  14213. </exception>
  14214. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14215. The server's response contained unexpected tokens.
  14216. </exception>
  14217. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14218. The server replied with a NO or BAD response.
  14219. </exception>
  14220. </member>
  14221. <member name="M:MailKit.Net.Imap.ImapFolder.SetLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14222. <summary>
  14223. Asynchronously set the labels of the specified messages.
  14224. </summary>
  14225. <remarks>
  14226. Sets the labels of the specified messages.
  14227. </remarks>
  14228. <returns>An asynchronous task context.</returns>
  14229. <param name="uids">The UIDs of the messages.</param>
  14230. <param name="labels">The labels to set.</param>
  14231. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14232. <param name="cancellationToken">The cancellation token.</param>
  14233. <exception cref="T:System.ArgumentNullException">
  14234. <para><paramref name="uids"/> is <c>null</c>.</para>
  14235. <para>-or-</para>
  14236. <para><paramref name="labels"/> is <c>null</c>.</para>
  14237. </exception>
  14238. <exception cref="T:System.ArgumentException">
  14239. One or more of the <paramref name="uids"/> is invalid.
  14240. </exception>
  14241. <exception cref="T:System.ObjectDisposedException">
  14242. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14243. </exception>
  14244. <exception cref="T:MailKit.ServiceNotConnectedException">
  14245. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14246. </exception>
  14247. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14248. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14249. </exception>
  14250. <exception cref="T:MailKit.FolderNotOpenException">
  14251. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14252. </exception>
  14253. <exception cref="T:System.OperationCanceledException">
  14254. The operation was canceled via the cancellation token.
  14255. </exception>
  14256. <exception cref="T:System.IO.IOException">
  14257. An I/O error occurred.
  14258. </exception>
  14259. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14260. The server's response contained unexpected tokens.
  14261. </exception>
  14262. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14263. The server replied with a NO or BAD response.
  14264. </exception>
  14265. </member>
  14266. <member name="M:MailKit.Net.Imap.ImapFolder.AddLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14267. <summary>
  14268. Add a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  14269. </summary>
  14270. <remarks>
  14271. Adds a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  14272. </remarks>
  14273. <returns>The unique IDs of the messages that were not updated.</returns>
  14274. <param name="uids">The UIDs of the messages.</param>
  14275. <param name="modseq">The mod-sequence value.</param>
  14276. <param name="labels">The labels to add.</param>
  14277. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14278. <param name="cancellationToken">The cancellation token.</param>
  14279. <exception cref="T:System.ArgumentNullException">
  14280. <para><paramref name="uids"/> is <c>null</c>.</para>
  14281. <para>-or-</para>
  14282. <para><paramref name="labels"/> is <c>null</c>.</para>
  14283. </exception>
  14284. <exception cref="T:System.ArgumentException">
  14285. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  14286. <para>-or-</para>
  14287. <para>No labels were specified.</para>
  14288. </exception>
  14289. <exception cref="T:System.ObjectDisposedException">
  14290. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14291. </exception>
  14292. <exception cref="T:MailKit.ServiceNotConnectedException">
  14293. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14294. </exception>
  14295. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14296. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14297. </exception>
  14298. <exception cref="T:MailKit.FolderNotOpenException">
  14299. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14300. </exception>
  14301. <exception cref="T:System.OperationCanceledException">
  14302. The operation was canceled via the cancellation token.
  14303. </exception>
  14304. <exception cref="T:System.IO.IOException">
  14305. An I/O error occurred.
  14306. </exception>
  14307. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14308. The server's response contained unexpected tokens.
  14309. </exception>
  14310. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14311. The server replied with a NO or BAD response.
  14312. </exception>
  14313. </member>
  14314. <member name="M:MailKit.Net.Imap.ImapFolder.AddLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14315. <summary>
  14316. Asynchronously add a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  14317. </summary>
  14318. <remarks>
  14319. Adds a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  14320. </remarks>
  14321. <returns>The unique IDs of the messages that were not updated.</returns>
  14322. <param name="uids">The UIDs of the messages.</param>
  14323. <param name="modseq">The mod-sequence value.</param>
  14324. <param name="labels">The labels to add.</param>
  14325. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14326. <param name="cancellationToken">The cancellation token.</param>
  14327. <exception cref="T:System.ArgumentNullException">
  14328. <para><paramref name="uids"/> is <c>null</c>.</para>
  14329. <para>-or-</para>
  14330. <para><paramref name="labels"/> is <c>null</c>.</para>
  14331. </exception>
  14332. <exception cref="T:System.ArgumentException">
  14333. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  14334. <para>-or-</para>
  14335. <para>No labels were specified.</para>
  14336. </exception>
  14337. <exception cref="T:System.ObjectDisposedException">
  14338. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14339. </exception>
  14340. <exception cref="T:MailKit.ServiceNotConnectedException">
  14341. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14342. </exception>
  14343. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14344. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14345. </exception>
  14346. <exception cref="T:MailKit.FolderNotOpenException">
  14347. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14348. </exception>
  14349. <exception cref="T:System.OperationCanceledException">
  14350. The operation was canceled via the cancellation token.
  14351. </exception>
  14352. <exception cref="T:System.IO.IOException">
  14353. An I/O error occurred.
  14354. </exception>
  14355. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14356. The server's response contained unexpected tokens.
  14357. </exception>
  14358. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14359. The server replied with a NO or BAD response.
  14360. </exception>
  14361. </member>
  14362. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14363. <summary>
  14364. Remove a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  14365. </summary>
  14366. <remarks>
  14367. Removes a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  14368. </remarks>
  14369. <returns>The unique IDs of the messages that were not updated.</returns>
  14370. <param name="uids">The UIDs of the messages.</param>
  14371. <param name="modseq">The mod-sequence value.</param>
  14372. <param name="labels">The labels to remove.</param>
  14373. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14374. <param name="cancellationToken">The cancellation token.</param>
  14375. <exception cref="T:System.ArgumentNullException">
  14376. <para><paramref name="uids"/> is <c>null</c>.</para>
  14377. <para>-or-</para>
  14378. <para><paramref name="labels"/> is <c>null</c>.</para>
  14379. </exception>
  14380. <exception cref="T:System.ArgumentException">
  14381. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  14382. <para>-or-</para>
  14383. <para>No labels were specified.</para>
  14384. </exception>
  14385. <exception cref="T:System.ObjectDisposedException">
  14386. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14387. </exception>
  14388. <exception cref="T:MailKit.ServiceNotConnectedException">
  14389. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14390. </exception>
  14391. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14392. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14393. </exception>
  14394. <exception cref="T:MailKit.FolderNotOpenException">
  14395. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14396. </exception>
  14397. <exception cref="T:System.OperationCanceledException">
  14398. The operation was canceled via the cancellation token.
  14399. </exception>
  14400. <exception cref="T:System.IO.IOException">
  14401. An I/O error occurred.
  14402. </exception>
  14403. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14404. The server's response contained unexpected tokens.
  14405. </exception>
  14406. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14407. The server replied with a NO or BAD response.
  14408. </exception>
  14409. </member>
  14410. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14411. <summary>
  14412. Asynchronously remove a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  14413. </summary>
  14414. <remarks>
  14415. Removes a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  14416. </remarks>
  14417. <returns>The unique IDs of the messages that were not updated.</returns>
  14418. <param name="uids">The UIDs of the messages.</param>
  14419. <param name="modseq">The mod-sequence value.</param>
  14420. <param name="labels">The labels to remove.</param>
  14421. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14422. <param name="cancellationToken">The cancellation token.</param>
  14423. <exception cref="T:System.ArgumentNullException">
  14424. <para><paramref name="uids"/> is <c>null</c>.</para>
  14425. <para>-or-</para>
  14426. <para><paramref name="labels"/> is <c>null</c>.</para>
  14427. </exception>
  14428. <exception cref="T:System.ArgumentException">
  14429. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  14430. <para>-or-</para>
  14431. <para>No labels were specified.</para>
  14432. </exception>
  14433. <exception cref="T:System.ObjectDisposedException">
  14434. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14435. </exception>
  14436. <exception cref="T:MailKit.ServiceNotConnectedException">
  14437. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14438. </exception>
  14439. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14440. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14441. </exception>
  14442. <exception cref="T:MailKit.FolderNotOpenException">
  14443. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14444. </exception>
  14445. <exception cref="T:System.OperationCanceledException">
  14446. The operation was canceled via the cancellation token.
  14447. </exception>
  14448. <exception cref="T:System.IO.IOException">
  14449. An I/O error occurred.
  14450. </exception>
  14451. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14452. The server's response contained unexpected tokens.
  14453. </exception>
  14454. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14455. The server replied with a NO or BAD response.
  14456. </exception>
  14457. </member>
  14458. <member name="M:MailKit.Net.Imap.ImapFolder.SetLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14459. <summary>
  14460. Set the labels of the specified messages only if their mod-sequence value is less than the specified value.
  14461. </summary>
  14462. <remarks>
  14463. Sets the labels of the specified messages only if their mod-sequence value is less than the specified value.
  14464. </remarks>
  14465. <returns>The unique IDs of the messages that were not updated.</returns>
  14466. <param name="uids">The UIDs of the messages.</param>
  14467. <param name="modseq">The mod-sequence value.</param>
  14468. <param name="labels">The labels to set.</param>
  14469. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14470. <param name="cancellationToken">The cancellation token.</param>
  14471. <exception cref="T:System.ArgumentNullException">
  14472. <para><paramref name="uids"/> is <c>null</c>.</para>
  14473. <para>-or-</para>
  14474. <para><paramref name="labels"/> is <c>null</c>.</para>
  14475. </exception>
  14476. <exception cref="T:System.ArgumentException">
  14477. One or more of the <paramref name="uids"/> is invalid.
  14478. </exception>
  14479. <exception cref="T:System.ObjectDisposedException">
  14480. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14481. </exception>
  14482. <exception cref="T:MailKit.ServiceNotConnectedException">
  14483. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14484. </exception>
  14485. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14486. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14487. </exception>
  14488. <exception cref="T:MailKit.FolderNotOpenException">
  14489. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14490. </exception>
  14491. <exception cref="T:System.OperationCanceledException">
  14492. The operation was canceled via the cancellation token.
  14493. </exception>
  14494. <exception cref="T:System.IO.IOException">
  14495. An I/O error occurred.
  14496. </exception>
  14497. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14498. The server's response contained unexpected tokens.
  14499. </exception>
  14500. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14501. The server replied with a NO or BAD response.
  14502. </exception>
  14503. </member>
  14504. <member name="M:MailKit.Net.Imap.ImapFolder.SetLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14505. <summary>
  14506. Asynchronously set the labels of the specified messages only if their mod-sequence value is less than the specified value.
  14507. </summary>
  14508. <remarks>
  14509. Sets the labels of the specified messages only if their mod-sequence value is less than the specified value.
  14510. </remarks>
  14511. <returns>The unique IDs of the messages that were not updated.</returns>
  14512. <param name="uids">The UIDs of the messages.</param>
  14513. <param name="modseq">The mod-sequence value.</param>
  14514. <param name="labels">The labels to set.</param>
  14515. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14516. <param name="cancellationToken">The cancellation token.</param>
  14517. <exception cref="T:System.ArgumentNullException">
  14518. <para><paramref name="uids"/> is <c>null</c>.</para>
  14519. <para>-or-</para>
  14520. <para><paramref name="labels"/> is <c>null</c>.</para>
  14521. </exception>
  14522. <exception cref="T:System.ArgumentException">
  14523. One or more of the <paramref name="uids"/> is invalid.
  14524. </exception>
  14525. <exception cref="T:System.ObjectDisposedException">
  14526. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14527. </exception>
  14528. <exception cref="T:MailKit.ServiceNotConnectedException">
  14529. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14530. </exception>
  14531. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14532. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14533. </exception>
  14534. <exception cref="T:MailKit.FolderNotOpenException">
  14535. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14536. </exception>
  14537. <exception cref="T:System.OperationCanceledException">
  14538. The operation was canceled via the cancellation token.
  14539. </exception>
  14540. <exception cref="T:System.IO.IOException">
  14541. An I/O error occurred.
  14542. </exception>
  14543. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14544. The server's response contained unexpected tokens.
  14545. </exception>
  14546. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14547. The server replied with a NO or BAD response.
  14548. </exception>
  14549. </member>
  14550. <member name="M:MailKit.Net.Imap.ImapFolder.AddLabels(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14551. <summary>
  14552. Add a set of labels to the specified messages.
  14553. </summary>
  14554. <remarks>
  14555. Adds a set of labels to the specified messages.
  14556. </remarks>
  14557. <param name="indexes">The indexes of the messages.</param>
  14558. <param name="labels">The labels to add.</param>
  14559. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14560. <param name="cancellationToken">The cancellation token.</param>
  14561. <exception cref="T:System.ArgumentNullException">
  14562. <para><paramref name="indexes"/> is <c>null</c>.</para>
  14563. <para>-or-</para>
  14564. <para><paramref name="labels"/> is <c>null</c>.</para>
  14565. </exception>
  14566. <exception cref="T:System.ArgumentException">
  14567. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  14568. <para>-or-</para>
  14569. <para>No labels were specified.</para>
  14570. </exception>
  14571. <exception cref="T:System.ObjectDisposedException">
  14572. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14573. </exception>
  14574. <exception cref="T:MailKit.ServiceNotConnectedException">
  14575. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14576. </exception>
  14577. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14578. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14579. </exception>
  14580. <exception cref="T:MailKit.FolderNotOpenException">
  14581. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14582. </exception>
  14583. <exception cref="T:System.OperationCanceledException">
  14584. The operation was canceled via the cancellation token.
  14585. </exception>
  14586. <exception cref="T:System.IO.IOException">
  14587. An I/O error occurred.
  14588. </exception>
  14589. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14590. The server's response contained unexpected tokens.
  14591. </exception>
  14592. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14593. The server replied with a NO or BAD response.
  14594. </exception>
  14595. </member>
  14596. <member name="M:MailKit.Net.Imap.ImapFolder.AddLabelsAsync(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14597. <summary>
  14598. Asynchronously add a set of labels to the specified messages.
  14599. </summary>
  14600. <remarks>
  14601. Adds a set of labels to the specified messages.
  14602. </remarks>
  14603. <returns>An asynchronous task context.</returns>
  14604. <param name="indexes">The indexes of the messages.</param>
  14605. <param name="labels">The labels to add.</param>
  14606. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14607. <param name="cancellationToken">The cancellation token.</param>
  14608. <exception cref="T:System.ArgumentNullException">
  14609. <para><paramref name="indexes"/> is <c>null</c>.</para>
  14610. <para>-or-</para>
  14611. <para><paramref name="labels"/> is <c>null</c>.</para>
  14612. </exception>
  14613. <exception cref="T:System.ArgumentException">
  14614. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  14615. <para>-or-</para>
  14616. <para>No labels were specified.</para>
  14617. </exception>
  14618. <exception cref="T:System.ObjectDisposedException">
  14619. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14620. </exception>
  14621. <exception cref="T:MailKit.ServiceNotConnectedException">
  14622. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14623. </exception>
  14624. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14625. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14626. </exception>
  14627. <exception cref="T:MailKit.FolderNotOpenException">
  14628. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14629. </exception>
  14630. <exception cref="T:System.OperationCanceledException">
  14631. The operation was canceled via the cancellation token.
  14632. </exception>
  14633. <exception cref="T:System.IO.IOException">
  14634. An I/O error occurred.
  14635. </exception>
  14636. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14637. The server's response contained unexpected tokens.
  14638. </exception>
  14639. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14640. The server replied with a NO or BAD response.
  14641. </exception>
  14642. </member>
  14643. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveLabels(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14644. <summary>
  14645. Remove a set of labels from the specified messages.
  14646. </summary>
  14647. <remarks>
  14648. Removes a set of labels from the specified messages.
  14649. </remarks>
  14650. <param name="indexes">The indexes of the messages.</param>
  14651. <param name="labels">The labels to remove.</param>
  14652. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14653. <param name="cancellationToken">The cancellation token.</param>
  14654. <exception cref="T:System.ArgumentNullException">
  14655. <para><paramref name="indexes"/> is <c>null</c>.</para>
  14656. <para>-or-</para>
  14657. <para><paramref name="labels"/> is <c>null</c>.</para>
  14658. </exception>
  14659. <exception cref="T:System.ArgumentException">
  14660. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  14661. <para>-or-</para>
  14662. <para>No labels were specified.</para>
  14663. </exception>
  14664. <exception cref="T:System.ObjectDisposedException">
  14665. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14666. </exception>
  14667. <exception cref="T:MailKit.ServiceNotConnectedException">
  14668. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14669. </exception>
  14670. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14671. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14672. </exception>
  14673. <exception cref="T:MailKit.FolderNotOpenException">
  14674. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14675. </exception>
  14676. <exception cref="T:System.OperationCanceledException">
  14677. The operation was canceled via the cancellation token.
  14678. </exception>
  14679. <exception cref="T:System.IO.IOException">
  14680. An I/O error occurred.
  14681. </exception>
  14682. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14683. The server's response contained unexpected tokens.
  14684. </exception>
  14685. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14686. The server replied with a NO or BAD response.
  14687. </exception>
  14688. </member>
  14689. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveLabelsAsync(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14690. <summary>
  14691. Asynchronously remove a set of labels from the specified messages.
  14692. </summary>
  14693. <remarks>
  14694. Removes a set of labels from the specified messages.
  14695. </remarks>
  14696. <returns>An asynchronous task context.</returns>
  14697. <param name="indexes">The indexes of the messages.</param>
  14698. <param name="labels">The labels to remove.</param>
  14699. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14700. <param name="cancellationToken">The cancellation token.</param>
  14701. <exception cref="T:System.ArgumentNullException">
  14702. <para><paramref name="indexes"/> is <c>null</c>.</para>
  14703. <para>-or-</para>
  14704. <para><paramref name="labels"/> is <c>null</c>.</para>
  14705. </exception>
  14706. <exception cref="T:System.ArgumentException">
  14707. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  14708. <para>-or-</para>
  14709. <para>No labels were specified.</para>
  14710. </exception>
  14711. <exception cref="T:System.ObjectDisposedException">
  14712. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14713. </exception>
  14714. <exception cref="T:MailKit.ServiceNotConnectedException">
  14715. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14716. </exception>
  14717. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14718. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14719. </exception>
  14720. <exception cref="T:MailKit.FolderNotOpenException">
  14721. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14722. </exception>
  14723. <exception cref="T:System.OperationCanceledException">
  14724. The operation was canceled via the cancellation token.
  14725. </exception>
  14726. <exception cref="T:System.IO.IOException">
  14727. An I/O error occurred.
  14728. </exception>
  14729. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14730. The server's response contained unexpected tokens.
  14731. </exception>
  14732. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14733. The server replied with a NO or BAD response.
  14734. </exception>
  14735. </member>
  14736. <member name="M:MailKit.Net.Imap.ImapFolder.SetLabels(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14737. <summary>
  14738. Sets the labels of the specified messages.
  14739. </summary>
  14740. <remarks>
  14741. Sets the labels of the specified messages.
  14742. </remarks>
  14743. <param name="indexes">The indexes of the messages.</param>
  14744. <param name="labels">The labels to set.</param>
  14745. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14746. <param name="cancellationToken">The cancellation token.</param>
  14747. <exception cref="T:System.ArgumentNullException">
  14748. <para><paramref name="indexes"/> is <c>null</c>.</para>
  14749. <para>-or-</para>
  14750. <para><paramref name="labels"/> is <c>null</c>.</para>
  14751. </exception>
  14752. <exception cref="T:System.ArgumentException">
  14753. One or more of the <paramref name="indexes"/> is invalid.
  14754. </exception>
  14755. <exception cref="T:System.ObjectDisposedException">
  14756. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14757. </exception>
  14758. <exception cref="T:MailKit.ServiceNotConnectedException">
  14759. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14760. </exception>
  14761. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14762. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14763. </exception>
  14764. <exception cref="T:MailKit.FolderNotOpenException">
  14765. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14766. </exception>
  14767. <exception cref="T:System.OperationCanceledException">
  14768. The operation was canceled via the cancellation token.
  14769. </exception>
  14770. <exception cref="T:System.IO.IOException">
  14771. An I/O error occurred.
  14772. </exception>
  14773. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14774. The server's response contained unexpected tokens.
  14775. </exception>
  14776. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14777. The server replied with a NO or BAD response.
  14778. </exception>
  14779. </member>
  14780. <member name="M:MailKit.Net.Imap.ImapFolder.SetLabelsAsync(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14781. <summary>
  14782. Asynchronously sets the labels of the specified messages.
  14783. </summary>
  14784. <remarks>
  14785. Sets the labels of the specified messages.
  14786. </remarks>
  14787. <returns>An asynchronous task context.</returns>
  14788. <param name="indexes">The indexes of the messages.</param>
  14789. <param name="labels">The labels to set.</param>
  14790. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14791. <param name="cancellationToken">The cancellation token.</param>
  14792. <exception cref="T:System.ArgumentNullException">
  14793. <para><paramref name="indexes"/> is <c>null</c>.</para>
  14794. <para>-or-</para>
  14795. <para><paramref name="labels"/> is <c>null</c>.</para>
  14796. </exception>
  14797. <exception cref="T:System.ArgumentException">
  14798. One or more of the <paramref name="indexes"/> is invalid.
  14799. </exception>
  14800. <exception cref="T:System.ObjectDisposedException">
  14801. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14802. </exception>
  14803. <exception cref="T:MailKit.ServiceNotConnectedException">
  14804. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14805. </exception>
  14806. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14807. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14808. </exception>
  14809. <exception cref="T:MailKit.FolderNotOpenException">
  14810. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14811. </exception>
  14812. <exception cref="T:System.OperationCanceledException">
  14813. The operation was canceled via the cancellation token.
  14814. </exception>
  14815. <exception cref="T:System.IO.IOException">
  14816. An I/O error occurred.
  14817. </exception>
  14818. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14819. The server's response contained unexpected tokens.
  14820. </exception>
  14821. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14822. The server replied with a NO or BAD response.
  14823. </exception>
  14824. </member>
  14825. <member name="M:MailKit.Net.Imap.ImapFolder.AddLabels(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14826. <summary>
  14827. Add a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  14828. </summary>
  14829. <remarks>
  14830. Adds a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  14831. </remarks>
  14832. <returns>The indexes of the messages that were not updated.</returns>
  14833. <param name="indexes">The indexes of the messages.</param>
  14834. <param name="modseq">The mod-sequence value.</param>
  14835. <param name="labels">The labels to add.</param>
  14836. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14837. <param name="cancellationToken">The cancellation token.</param>
  14838. <exception cref="T:System.ArgumentNullException">
  14839. <para><paramref name="indexes"/> is <c>null</c>.</para>
  14840. <para>-or-</para>
  14841. <para><paramref name="labels"/> is <c>null</c>.</para>
  14842. </exception>
  14843. <exception cref="T:System.ArgumentException">
  14844. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  14845. <para>-or-</para>
  14846. <para>No labels were specified.</para>
  14847. </exception>
  14848. <exception cref="T:System.ObjectDisposedException">
  14849. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14850. </exception>
  14851. <exception cref="T:MailKit.ServiceNotConnectedException">
  14852. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14853. </exception>
  14854. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14855. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14856. </exception>
  14857. <exception cref="T:MailKit.FolderNotOpenException">
  14858. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14859. </exception>
  14860. <exception cref="T:System.OperationCanceledException">
  14861. The operation was canceled via the cancellation token.
  14862. </exception>
  14863. <exception cref="T:System.IO.IOException">
  14864. An I/O error occurred.
  14865. </exception>
  14866. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14867. The server's response contained unexpected tokens.
  14868. </exception>
  14869. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14870. The server replied with a NO or BAD response.
  14871. </exception>
  14872. </member>
  14873. <member name="M:MailKit.Net.Imap.ImapFolder.AddLabelsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14874. <summary>
  14875. Asynchronously add a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  14876. </summary>
  14877. <remarks>
  14878. Adds a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  14879. </remarks>
  14880. <returns>The indexes of the messages that were not updated.</returns>
  14881. <param name="indexes">The indexes of the messages.</param>
  14882. <param name="modseq">The mod-sequence value.</param>
  14883. <param name="labels">The labels to add.</param>
  14884. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14885. <param name="cancellationToken">The cancellation token.</param>
  14886. <exception cref="T:System.ArgumentNullException">
  14887. <para><paramref name="indexes"/> is <c>null</c>.</para>
  14888. <para>-or-</para>
  14889. <para><paramref name="labels"/> is <c>null</c>.</para>
  14890. </exception>
  14891. <exception cref="T:System.ArgumentException">
  14892. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  14893. <para>-or-</para>
  14894. <para>No labels were specified.</para>
  14895. </exception>
  14896. <exception cref="T:System.ObjectDisposedException">
  14897. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14898. </exception>
  14899. <exception cref="T:MailKit.ServiceNotConnectedException">
  14900. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14901. </exception>
  14902. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14903. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14904. </exception>
  14905. <exception cref="T:MailKit.FolderNotOpenException">
  14906. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14907. </exception>
  14908. <exception cref="T:System.OperationCanceledException">
  14909. The operation was canceled via the cancellation token.
  14910. </exception>
  14911. <exception cref="T:System.IO.IOException">
  14912. An I/O error occurred.
  14913. </exception>
  14914. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14915. The server's response contained unexpected tokens.
  14916. </exception>
  14917. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14918. The server replied with a NO or BAD response.
  14919. </exception>
  14920. </member>
  14921. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveLabels(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14922. <summary>
  14923. Remove a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  14924. </summary>
  14925. <remarks>
  14926. Removes a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  14927. </remarks>
  14928. <returns>The indexes of the messages that were not updated.</returns>
  14929. <param name="indexes">The indexes of the messages.</param>
  14930. <param name="modseq">The mod-sequence value.</param>
  14931. <param name="labels">The labels to remove.</param>
  14932. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14933. <param name="cancellationToken">The cancellation token.</param>
  14934. <exception cref="T:System.ArgumentNullException">
  14935. <para><paramref name="indexes"/> is <c>null</c>.</para>
  14936. <para>-or-</para>
  14937. <para><paramref name="labels"/> is <c>null</c>.</para>
  14938. </exception>
  14939. <exception cref="T:System.ArgumentException">
  14940. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  14941. <para>-or-</para>
  14942. <para>No labels were specified.</para>
  14943. </exception>
  14944. <exception cref="T:System.ObjectDisposedException">
  14945. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14946. </exception>
  14947. <exception cref="T:MailKit.ServiceNotConnectedException">
  14948. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14949. </exception>
  14950. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14951. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  14952. </exception>
  14953. <exception cref="T:MailKit.FolderNotOpenException">
  14954. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  14955. </exception>
  14956. <exception cref="T:System.OperationCanceledException">
  14957. The operation was canceled via the cancellation token.
  14958. </exception>
  14959. <exception cref="T:System.IO.IOException">
  14960. An I/O error occurred.
  14961. </exception>
  14962. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  14963. The server's response contained unexpected tokens.
  14964. </exception>
  14965. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  14966. The server replied with a NO or BAD response.
  14967. </exception>
  14968. </member>
  14969. <member name="M:MailKit.Net.Imap.ImapFolder.RemoveLabelsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  14970. <summary>
  14971. Asynchronously remove a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  14972. </summary>
  14973. <remarks>
  14974. Removes a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  14975. </remarks>
  14976. <returns>The indexes of the messages that were not updated.</returns>
  14977. <param name="indexes">The indexes of the messages.</param>
  14978. <param name="modseq">The mod-sequence value.</param>
  14979. <param name="labels">The labels to remove.</param>
  14980. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  14981. <param name="cancellationToken">The cancellation token.</param>
  14982. <exception cref="T:System.ArgumentNullException">
  14983. <para><paramref name="indexes"/> is <c>null</c>.</para>
  14984. <para>-or-</para>
  14985. <para><paramref name="labels"/> is <c>null</c>.</para>
  14986. </exception>
  14987. <exception cref="T:System.ArgumentException">
  14988. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  14989. <para>-or-</para>
  14990. <para>No labels were specified.</para>
  14991. </exception>
  14992. <exception cref="T:System.ObjectDisposedException">
  14993. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  14994. </exception>
  14995. <exception cref="T:MailKit.ServiceNotConnectedException">
  14996. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  14997. </exception>
  14998. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  14999. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15000. </exception>
  15001. <exception cref="T:MailKit.FolderNotOpenException">
  15002. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  15003. </exception>
  15004. <exception cref="T:System.OperationCanceledException">
  15005. The operation was canceled via the cancellation token.
  15006. </exception>
  15007. <exception cref="T:System.IO.IOException">
  15008. An I/O error occurred.
  15009. </exception>
  15010. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15011. The server's response contained unexpected tokens.
  15012. </exception>
  15013. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15014. The server replied with a NO or BAD response.
  15015. </exception>
  15016. </member>
  15017. <member name="M:MailKit.Net.Imap.ImapFolder.SetLabels(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  15018. <summary>
  15019. Set the labels of the specified messages only if their mod-sequence value is less than the specified value.
  15020. </summary>
  15021. <remarks>
  15022. Sets the labels of the specified messages only if their mod-sequence value is less than the specified value.
  15023. </remarks>
  15024. <returns>The indexes of the messages that were not updated.</returns>
  15025. <param name="indexes">The indexes of the messages.</param>
  15026. <param name="modseq">The mod-sequence value.</param>
  15027. <param name="labels">The labels to set.</param>
  15028. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  15029. <param name="cancellationToken">The cancellation token.</param>
  15030. <exception cref="T:System.ArgumentNullException">
  15031. <para><paramref name="indexes"/> is <c>null</c>.</para>
  15032. <para>-or-</para>
  15033. <para><paramref name="labels"/> is <c>null</c>.</para>
  15034. </exception>
  15035. <exception cref="T:System.ArgumentException">
  15036. One or more of the <paramref name="indexes"/> is invalid.
  15037. </exception>
  15038. <exception cref="T:System.ObjectDisposedException">
  15039. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15040. </exception>
  15041. <exception cref="T:MailKit.ServiceNotConnectedException">
  15042. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15043. </exception>
  15044. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15045. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15046. </exception>
  15047. <exception cref="T:MailKit.FolderNotOpenException">
  15048. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  15049. </exception>
  15050. <exception cref="T:System.OperationCanceledException">
  15051. The operation was canceled via the cancellation token.
  15052. </exception>
  15053. <exception cref="T:System.IO.IOException">
  15054. An I/O error occurred.
  15055. </exception>
  15056. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15057. The server's response contained unexpected tokens.
  15058. </exception>
  15059. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15060. The server replied with a NO or BAD response.
  15061. </exception>
  15062. </member>
  15063. <member name="M:MailKit.Net.Imap.ImapFolder.SetLabelsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  15064. <summary>
  15065. Asynchronously set the labels of the specified messages only if their mod-sequence value is less than the specified value.
  15066. </summary>
  15067. <remarks>
  15068. Sets the labels of the specified messages only if their mod-sequence value is less than the specified value.
  15069. </remarks>
  15070. <returns>The indexes of the messages that were not updated.</returns>
  15071. <param name="indexes">The indexes of the messages.</param>
  15072. <param name="modseq">The mod-sequence value.</param>
  15073. <param name="labels">The labels to set.</param>
  15074. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  15075. <param name="cancellationToken">The cancellation token.</param>
  15076. <exception cref="T:System.ArgumentNullException">
  15077. <para><paramref name="indexes"/> is <c>null</c>.</para>
  15078. <para>-or-</para>
  15079. <para><paramref name="labels"/> is <c>null</c>.</para>
  15080. </exception>
  15081. <exception cref="T:System.ArgumentException">
  15082. One or more of the <paramref name="indexes"/> is invalid.
  15083. </exception>
  15084. <exception cref="T:System.ObjectDisposedException">
  15085. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15086. </exception>
  15087. <exception cref="T:MailKit.ServiceNotConnectedException">
  15088. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15089. </exception>
  15090. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15091. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15092. </exception>
  15093. <exception cref="T:MailKit.FolderNotOpenException">
  15094. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open in read-write mode.
  15095. </exception>
  15096. <exception cref="T:System.OperationCanceledException">
  15097. The operation was canceled via the cancellation token.
  15098. </exception>
  15099. <exception cref="T:System.IO.IOException">
  15100. An I/O error occurred.
  15101. </exception>
  15102. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15103. The server's response contained unexpected tokens.
  15104. </exception>
  15105. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15106. The server replied with a NO or BAD response.
  15107. </exception>
  15108. </member>
  15109. <member name="M:MailKit.Net.Imap.ImapFolder.Search(System.String,System.Threading.CancellationToken)">
  15110. <summary>
  15111. Search the folder for messages matching the specified query.
  15112. </summary>
  15113. <remarks>
  15114. Sends a <c>UID SEARCH</c> command with the specified query passed directly to the IMAP server
  15115. with no interpretation by MailKit. This means that the query may contain any arguments that a
  15116. <c>UID SEARCH</c> command is allowed to have according to the IMAP specifications and any
  15117. extensions that are supported, including <c>RETURN</c> parameters.
  15118. </remarks>
  15119. <returns>An array of matching UIDs.</returns>
  15120. <param name="query">The search query.</param>
  15121. <param name="cancellationToken">The cancellation token.</param>
  15122. <exception cref="T:System.ArgumentNullException">
  15123. <paramref name="query"/> is <c>null</c>.
  15124. </exception>
  15125. <exception cref="T:System.ArgumentException">
  15126. <paramref name="query"/> is an empty string.
  15127. </exception>
  15128. <exception cref="T:System.ObjectDisposedException">
  15129. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15130. </exception>
  15131. <exception cref="T:MailKit.ServiceNotConnectedException">
  15132. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15133. </exception>
  15134. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15135. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15136. </exception>
  15137. <exception cref="T:MailKit.FolderNotOpenException">
  15138. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15139. </exception>
  15140. <exception cref="T:System.OperationCanceledException">
  15141. The operation was canceled via the cancellation token.
  15142. </exception>
  15143. <exception cref="T:System.IO.IOException">
  15144. An I/O error occurred.
  15145. </exception>
  15146. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15147. The server's response contained unexpected tokens.
  15148. </exception>
  15149. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15150. The server replied with a NO or BAD response.
  15151. </exception>
  15152. </member>
  15153. <member name="M:MailKit.Net.Imap.ImapFolder.SearchAsync(System.String,System.Threading.CancellationToken)">
  15154. <summary>
  15155. Asynchronously search the folder for messages matching the specified query.
  15156. </summary>
  15157. <remarks>
  15158. Sends a <c>UID SEARCH</c> command with the specified query passed directly to the IMAP server
  15159. with no interpretation by MailKit. This means that the query may contain any arguments that a
  15160. <c>UID SEARCH</c> command is allowed to have according to the IMAP specifications and any
  15161. extensions that are supported, including <c>RETURN</c> parameters.
  15162. </remarks>
  15163. <returns>An array of matching UIDs.</returns>
  15164. <param name="query">The search query.</param>
  15165. <param name="cancellationToken">The cancellation token.</param>
  15166. <exception cref="T:System.ArgumentNullException">
  15167. <paramref name="query"/> is <c>null</c>.
  15168. </exception>
  15169. <exception cref="T:System.ArgumentException">
  15170. <paramref name="query"/> is an empty string.
  15171. </exception>
  15172. <exception cref="T:System.ObjectDisposedException">
  15173. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15174. </exception>
  15175. <exception cref="T:MailKit.ServiceNotConnectedException">
  15176. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15177. </exception>
  15178. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15179. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15180. </exception>
  15181. <exception cref="T:MailKit.FolderNotOpenException">
  15182. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15183. </exception>
  15184. <exception cref="T:System.OperationCanceledException">
  15185. The operation was canceled via the cancellation token.
  15186. </exception>
  15187. <exception cref="T:System.IO.IOException">
  15188. An I/O error occurred.
  15189. </exception>
  15190. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15191. The server's response contained unexpected tokens.
  15192. </exception>
  15193. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15194. The server replied with a NO or BAD response.
  15195. </exception>
  15196. </member>
  15197. <member name="M:MailKit.Net.Imap.ImapFolder.Search(MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  15198. <summary>
  15199. Search the folder for messages matching the specified query.
  15200. </summary>
  15201. <remarks>
  15202. The returned array of unique identifiers can be used with methods such as
  15203. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  15204. </remarks>
  15205. <returns>An array of matching UIDs.</returns>
  15206. <param name="query">The search query.</param>
  15207. <param name="cancellationToken">The cancellation token.</param>
  15208. <exception cref="T:System.ArgumentNullException">
  15209. <paramref name="query"/> is <c>null</c>.
  15210. </exception>
  15211. <exception cref="T:System.NotSupportedException">
  15212. One or more search terms in the <paramref name="query"/> are not supported by the IMAP server.
  15213. </exception>
  15214. <exception cref="T:System.ObjectDisposedException">
  15215. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15216. </exception>
  15217. <exception cref="T:MailKit.ServiceNotConnectedException">
  15218. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15219. </exception>
  15220. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15221. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15222. </exception>
  15223. <exception cref="T:MailKit.FolderNotOpenException">
  15224. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15225. </exception>
  15226. <exception cref="T:System.OperationCanceledException">
  15227. The operation was canceled via the cancellation token.
  15228. </exception>
  15229. <exception cref="T:System.IO.IOException">
  15230. An I/O error occurred.
  15231. </exception>
  15232. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15233. The server's response contained unexpected tokens.
  15234. </exception>
  15235. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15236. The server replied with a NO or BAD response.
  15237. </exception>
  15238. </member>
  15239. <member name="M:MailKit.Net.Imap.ImapFolder.SearchAsync(MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  15240. <summary>
  15241. Asynchronously search the folder for messages matching the specified query.
  15242. </summary>
  15243. <remarks>
  15244. The returned array of unique identifiers can be used with methods such as
  15245. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  15246. </remarks>
  15247. <returns>An array of matching UIDs.</returns>
  15248. <param name="query">The search query.</param>
  15249. <param name="cancellationToken">The cancellation token.</param>
  15250. <exception cref="T:System.ArgumentNullException">
  15251. <paramref name="query"/> is <c>null</c>.
  15252. </exception>
  15253. <exception cref="T:System.NotSupportedException">
  15254. One or more search terms in the <paramref name="query"/> are not supported by the IMAP server.
  15255. </exception>
  15256. <exception cref="T:System.ObjectDisposedException">
  15257. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15258. </exception>
  15259. <exception cref="T:MailKit.ServiceNotConnectedException">
  15260. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15261. </exception>
  15262. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15263. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15264. </exception>
  15265. <exception cref="T:MailKit.FolderNotOpenException">
  15266. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15267. </exception>
  15268. <exception cref="T:System.OperationCanceledException">
  15269. The operation was canceled via the cancellation token.
  15270. </exception>
  15271. <exception cref="T:System.IO.IOException">
  15272. An I/O error occurred.
  15273. </exception>
  15274. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15275. The server's response contained unexpected tokens.
  15276. </exception>
  15277. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15278. The server replied with a NO or BAD response.
  15279. </exception>
  15280. </member>
  15281. <member name="M:MailKit.Net.Imap.ImapFolder.Search(MailKit.Search.SearchOptions,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  15282. <summary>
  15283. Search the folder for messages matching the specified query.
  15284. </summary>
  15285. <remarks>
  15286. Searches the folder for messages matching the specified query,
  15287. returning only the specified search results.
  15288. </remarks>
  15289. <returns>The search results.</returns>
  15290. <param name="options">The search options.</param>
  15291. <param name="query">The search query.</param>
  15292. <param name="cancellationToken">The cancellation token.</param>
  15293. <exception cref="T:System.ArgumentNullException">
  15294. <paramref name="query"/> is <c>null</c>.
  15295. </exception>
  15296. <exception cref="T:System.NotSupportedException">
  15297. <para>One or more search terms in the <paramref name="query"/> are not supported by the IMAP server.</para>
  15298. <para>-or-</para>
  15299. <para>The IMAP server does not support the ESEARCH extension.</para>
  15300. </exception>
  15301. <exception cref="T:System.ObjectDisposedException">
  15302. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15303. </exception>
  15304. <exception cref="T:MailKit.ServiceNotConnectedException">
  15305. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15306. </exception>
  15307. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15308. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15309. </exception>
  15310. <exception cref="T:MailKit.FolderNotOpenException">
  15311. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15312. </exception>
  15313. <exception cref="T:System.OperationCanceledException">
  15314. The operation was canceled via the cancellation token.
  15315. </exception>
  15316. <exception cref="T:System.IO.IOException">
  15317. An I/O error occurred.
  15318. </exception>
  15319. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15320. The server's response contained unexpected tokens.
  15321. </exception>
  15322. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15323. The server replied with a NO or BAD response.
  15324. </exception>
  15325. </member>
  15326. <member name="M:MailKit.Net.Imap.ImapFolder.SearchAsync(MailKit.Search.SearchOptions,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  15327. <summary>
  15328. Asynchronously search the folder for messages matching the specified query.
  15329. </summary>
  15330. <remarks>
  15331. Searches the folder for messages matching the specified query,
  15332. returning only the specified search results.
  15333. </remarks>
  15334. <returns>The search results.</returns>
  15335. <param name="options">The search options.</param>
  15336. <param name="query">The search query.</param>
  15337. <param name="cancellationToken">The cancellation token.</param>
  15338. <exception cref="T:System.ArgumentNullException">
  15339. <paramref name="query"/> is <c>null</c>.
  15340. </exception>
  15341. <exception cref="T:System.NotSupportedException">
  15342. <para>One or more search terms in the <paramref name="query"/> are not supported by the IMAP server.</para>
  15343. <para>-or-</para>
  15344. <para>The IMAP server does not support the ESEARCH extension.</para>
  15345. </exception>
  15346. <exception cref="T:System.ObjectDisposedException">
  15347. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15348. </exception>
  15349. <exception cref="T:MailKit.ServiceNotConnectedException">
  15350. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15351. </exception>
  15352. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15353. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15354. </exception>
  15355. <exception cref="T:MailKit.FolderNotOpenException">
  15356. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15357. </exception>
  15358. <exception cref="T:System.OperationCanceledException">
  15359. The operation was canceled via the cancellation token.
  15360. </exception>
  15361. <exception cref="T:System.IO.IOException">
  15362. An I/O error occurred.
  15363. </exception>
  15364. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15365. The server's response contained unexpected tokens.
  15366. </exception>
  15367. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15368. The server replied with a NO or BAD response.
  15369. </exception>
  15370. </member>
  15371. <member name="M:MailKit.Net.Imap.ImapFolder.Sort(System.String,System.Threading.CancellationToken)">
  15372. <summary>
  15373. Sort messages matching the specified query.
  15374. </summary>
  15375. <remarks>
  15376. Sends a <c>UID SORT</c> command with the specified query passed directly to the IMAP server
  15377. with no interpretation by MailKit. This means that the query may contain any arguments that a
  15378. <c>UID SORT</c> command is allowed to have according to the IMAP specifications and any
  15379. extensions that are supported, including <c>RETURN</c> parameters.
  15380. </remarks>
  15381. <returns>An array of matching UIDs.</returns>
  15382. <param name="query">The search query.</param>
  15383. <param name="cancellationToken">The cancellation token.</param>
  15384. <exception cref="T:System.ArgumentNullException">
  15385. <paramref name="query"/> is <c>null</c>.
  15386. </exception>
  15387. <exception cref="T:System.ArgumentException">
  15388. <paramref name="query"/> is an empty string.
  15389. </exception>
  15390. <exception cref="T:System.NotSupportedException">
  15391. The IMAP server does not support the SORT extension.
  15392. </exception>
  15393. <exception cref="T:System.ObjectDisposedException">
  15394. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15395. </exception>
  15396. <exception cref="T:MailKit.ServiceNotConnectedException">
  15397. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15398. </exception>
  15399. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15400. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15401. </exception>
  15402. <exception cref="T:MailKit.FolderNotOpenException">
  15403. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15404. </exception>
  15405. <exception cref="T:System.OperationCanceledException">
  15406. The operation was canceled via the cancellation token.
  15407. </exception>
  15408. <exception cref="T:System.IO.IOException">
  15409. An I/O error occurred.
  15410. </exception>
  15411. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15412. The server's response contained unexpected tokens.
  15413. </exception>
  15414. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15415. The server replied with a NO or BAD response.
  15416. </exception>
  15417. </member>
  15418. <member name="M:MailKit.Net.Imap.ImapFolder.SortAsync(System.String,System.Threading.CancellationToken)">
  15419. <summary>
  15420. Asynchronously sort messages matching the specified query.
  15421. </summary>
  15422. <remarks>
  15423. Sends a <c>UID SORT</c> command with the specified query passed directly to the IMAP server
  15424. with no interpretation by MailKit. This means that the query may contain any arguments that a
  15425. <c>UID SORT</c> command is allowed to have according to the IMAP specifications and any
  15426. extensions that are supported, including <c>RETURN</c> parameters.
  15427. </remarks>
  15428. <returns>An array of matching UIDs.</returns>
  15429. <param name="query">The search query.</param>
  15430. <param name="cancellationToken">The cancellation token.</param>
  15431. <exception cref="T:System.ArgumentNullException">
  15432. <paramref name="query"/> is <c>null</c>.
  15433. </exception>
  15434. <exception cref="T:System.ArgumentException">
  15435. <paramref name="query"/> is an empty string.
  15436. </exception>
  15437. <exception cref="T:System.NotSupportedException">
  15438. The IMAP server does not support the SORT extension.
  15439. </exception>
  15440. <exception cref="T:System.ObjectDisposedException">
  15441. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15442. </exception>
  15443. <exception cref="T:MailKit.ServiceNotConnectedException">
  15444. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15445. </exception>
  15446. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15447. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15448. </exception>
  15449. <exception cref="T:MailKit.FolderNotOpenException">
  15450. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15451. </exception>
  15452. <exception cref="T:System.OperationCanceledException">
  15453. The operation was canceled via the cancellation token.
  15454. </exception>
  15455. <exception cref="T:System.IO.IOException">
  15456. An I/O error occurred.
  15457. </exception>
  15458. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15459. The server's response contained unexpected tokens.
  15460. </exception>
  15461. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15462. The server replied with a NO or BAD response.
  15463. </exception>
  15464. </member>
  15465. <member name="M:MailKit.Net.Imap.ImapFolder.Sort(MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  15466. <summary>
  15467. Sort messages matching the specified query.
  15468. </summary>
  15469. <remarks>
  15470. The returned array of unique identifiers will be sorted in the preferred order and
  15471. can be used with <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  15472. </remarks>
  15473. <returns>An array of matching UIDs in the specified sort order.</returns>
  15474. <param name="query">The search query.</param>
  15475. <param name="orderBy">The sort order.</param>
  15476. <param name="cancellationToken">The cancellation token.</param>
  15477. <exception cref="T:System.ArgumentNullException">
  15478. <para><paramref name="query"/> is <c>null</c>.</para>
  15479. <para>-or-</para>
  15480. <para><paramref name="orderBy"/> is <c>null</c>.</para>
  15481. </exception>
  15482. <exception cref="T:System.ArgumentException">
  15483. <paramref name="orderBy"/> is empty.
  15484. </exception>
  15485. <exception cref="T:System.NotSupportedException">
  15486. <para>One or more search terms in the <paramref name="query"/> are not supported by the IMAP server.</para>
  15487. <para>-or-</para>
  15488. <para>The server does not support the SORT extension.</para>
  15489. </exception>
  15490. <exception cref="T:System.ObjectDisposedException">
  15491. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15492. </exception>
  15493. <exception cref="T:MailKit.ServiceNotConnectedException">
  15494. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15495. </exception>
  15496. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15497. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15498. </exception>
  15499. <exception cref="T:MailKit.FolderNotOpenException">
  15500. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15501. </exception>
  15502. <exception cref="T:System.OperationCanceledException">
  15503. The operation was canceled via the cancellation token.
  15504. </exception>
  15505. <exception cref="T:System.IO.IOException">
  15506. An I/O error occurred.
  15507. </exception>
  15508. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15509. The server's response contained unexpected tokens.
  15510. </exception>
  15511. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15512. The server replied with a NO or BAD response.
  15513. </exception>
  15514. </member>
  15515. <member name="M:MailKit.Net.Imap.ImapFolder.SortAsync(MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  15516. <summary>
  15517. Asynchronously sort messages matching the specified query.
  15518. </summary>
  15519. <remarks>
  15520. The returned array of unique identifiers will be sorted in the preferred order and
  15521. can be used with <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  15522. </remarks>
  15523. <returns>An array of matching UIDs in the specified sort order.</returns>
  15524. <param name="query">The search query.</param>
  15525. <param name="orderBy">The sort order.</param>
  15526. <param name="cancellationToken">The cancellation token.</param>
  15527. <exception cref="T:System.ArgumentNullException">
  15528. <para><paramref name="query"/> is <c>null</c>.</para>
  15529. <para>-or-</para>
  15530. <para><paramref name="orderBy"/> is <c>null</c>.</para>
  15531. </exception>
  15532. <exception cref="T:System.ArgumentException">
  15533. <paramref name="orderBy"/> is empty.
  15534. </exception>
  15535. <exception cref="T:System.NotSupportedException">
  15536. <para>One or more search terms in the <paramref name="query"/> are not supported by the IMAP server.</para>
  15537. <para>-or-</para>
  15538. <para>The server does not support the SORT extension.</para>
  15539. </exception>
  15540. <exception cref="T:System.ObjectDisposedException">
  15541. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15542. </exception>
  15543. <exception cref="T:MailKit.ServiceNotConnectedException">
  15544. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15545. </exception>
  15546. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15547. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15548. </exception>
  15549. <exception cref="T:MailKit.FolderNotOpenException">
  15550. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15551. </exception>
  15552. <exception cref="T:System.OperationCanceledException">
  15553. The operation was canceled via the cancellation token.
  15554. </exception>
  15555. <exception cref="T:System.IO.IOException">
  15556. An I/O error occurred.
  15557. </exception>
  15558. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15559. The server's response contained unexpected tokens.
  15560. </exception>
  15561. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15562. The server replied with a NO or BAD response.
  15563. </exception>
  15564. </member>
  15565. <member name="M:MailKit.Net.Imap.ImapFolder.Sort(MailKit.Search.SearchOptions,MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  15566. <summary>
  15567. Sort messages matching the specified query.
  15568. </summary>
  15569. <remarks>
  15570. Searches the folder for messages matching the specified query, returning the search results in the specified sort order.
  15571. </remarks>
  15572. <returns>The search results.</returns>
  15573. <param name="options">The search options.</param>
  15574. <param name="query">The search query.</param>
  15575. <param name="orderBy">The sort order.</param>
  15576. <param name="cancellationToken">The cancellation token.</param>
  15577. <exception cref="T:System.ArgumentNullException">
  15578. <para><paramref name="query"/> is <c>null</c>.</para>
  15579. <para>-or-</para>
  15580. <para><paramref name="orderBy"/> is <c>null</c>.</para>
  15581. </exception>
  15582. <exception cref="T:System.ArgumentException">
  15583. <paramref name="orderBy"/> is empty.
  15584. </exception>
  15585. <exception cref="T:System.NotSupportedException">
  15586. <para>One or more search terms in the <paramref name="query"/> are not supported by the IMAP server.</para>
  15587. <para>-or-</para>
  15588. <para>The IMAP server does not support the ESORT extension.</para>
  15589. </exception>
  15590. <exception cref="T:System.ObjectDisposedException">
  15591. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15592. </exception>
  15593. <exception cref="T:MailKit.ServiceNotConnectedException">
  15594. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15595. </exception>
  15596. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15597. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15598. </exception>
  15599. <exception cref="T:MailKit.FolderNotOpenException">
  15600. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15601. </exception>
  15602. <exception cref="T:System.OperationCanceledException">
  15603. The operation was canceled via the cancellation token.
  15604. </exception>
  15605. <exception cref="T:System.IO.IOException">
  15606. An I/O error occurred.
  15607. </exception>
  15608. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15609. The server's response contained unexpected tokens.
  15610. </exception>
  15611. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15612. The server replied with a NO or BAD response.
  15613. </exception>
  15614. </member>
  15615. <member name="M:MailKit.Net.Imap.ImapFolder.SortAsync(MailKit.Search.SearchOptions,MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  15616. <summary>
  15617. Asynchronously sort messages matching the specified query.
  15618. </summary>
  15619. <remarks>
  15620. Searches the folder for messages matching the specified query, returning the search results in the specified sort order.
  15621. </remarks>
  15622. <returns>The search results.</returns>
  15623. <param name="options">The search options.</param>
  15624. <param name="query">The search query.</param>
  15625. <param name="orderBy">The sort order.</param>
  15626. <param name="cancellationToken">The cancellation token.</param>
  15627. <exception cref="T:System.ArgumentNullException">
  15628. <para><paramref name="query"/> is <c>null</c>.</para>
  15629. <para>-or-</para>
  15630. <para><paramref name="orderBy"/> is <c>null</c>.</para>
  15631. </exception>
  15632. <exception cref="T:System.ArgumentException">
  15633. <paramref name="orderBy"/> is empty.
  15634. </exception>
  15635. <exception cref="T:System.NotSupportedException">
  15636. <para>One or more search terms in the <paramref name="query"/> are not supported by the IMAP server.</para>
  15637. <para>-or-</para>
  15638. <para>The IMAP server does not support the ESORT extension.</para>
  15639. </exception>
  15640. <exception cref="T:System.ObjectDisposedException">
  15641. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15642. </exception>
  15643. <exception cref="T:MailKit.ServiceNotConnectedException">
  15644. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15645. </exception>
  15646. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15647. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15648. </exception>
  15649. <exception cref="T:MailKit.FolderNotOpenException">
  15650. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15651. </exception>
  15652. <exception cref="T:System.OperationCanceledException">
  15653. The operation was canceled via the cancellation token.
  15654. </exception>
  15655. <exception cref="T:System.IO.IOException">
  15656. An I/O error occurred.
  15657. </exception>
  15658. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15659. The server's response contained unexpected tokens.
  15660. </exception>
  15661. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15662. The server replied with a NO or BAD response.
  15663. </exception>
  15664. </member>
  15665. <member name="M:MailKit.Net.Imap.ImapFolder.Thread(MailKit.ThreadingAlgorithm,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  15666. <summary>
  15667. Thread the messages in the folder that match the search query using the specified threading algorithm.
  15668. </summary>
  15669. <remarks>
  15670. The <see cref="P:MailKit.MessageThread.UniqueId"/> can be used with methods such as
  15671. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  15672. </remarks>
  15673. <returns>An array of message threads.</returns>
  15674. <param name="algorithm">The threading algorithm to use.</param>
  15675. <param name="query">The search query.</param>
  15676. <param name="cancellationToken">The cancellation token.</param>
  15677. <exception cref="T:System.ArgumentOutOfRangeException">
  15678. <paramref name="algorithm"/> is not supported.
  15679. </exception>
  15680. <exception cref="T:System.ArgumentNullException">
  15681. <paramref name="query"/> is <c>null</c>.
  15682. </exception>
  15683. <exception cref="T:System.NotSupportedException">
  15684. <para>One or more search terms in the <paramref name="query"/> are not supported by the IMAP server.</para>
  15685. <para>-or-</para>
  15686. <para>The server does not support the THREAD extension.</para>
  15687. </exception>
  15688. <exception cref="T:System.ObjectDisposedException">
  15689. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15690. </exception>
  15691. <exception cref="T:MailKit.ServiceNotConnectedException">
  15692. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15693. </exception>
  15694. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15695. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15696. </exception>
  15697. <exception cref="T:MailKit.FolderNotOpenException">
  15698. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15699. </exception>
  15700. <exception cref="T:System.OperationCanceledException">
  15701. The operation was canceled via the cancellation token.
  15702. </exception>
  15703. <exception cref="T:System.IO.IOException">
  15704. An I/O error occurred.
  15705. </exception>
  15706. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15707. The server's response contained unexpected tokens.
  15708. </exception>
  15709. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15710. The server replied with a NO or BAD response.
  15711. </exception>
  15712. </member>
  15713. <member name="M:MailKit.Net.Imap.ImapFolder.ThreadAsync(MailKit.ThreadingAlgorithm,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  15714. <summary>
  15715. Asynchronously thread the messages in the folder that match the search query using the specified threading algorithm.
  15716. </summary>
  15717. <remarks>
  15718. The <see cref="P:MailKit.MessageThread.UniqueId"/> can be used with methods such as
  15719. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  15720. </remarks>
  15721. <returns>An array of message threads.</returns>
  15722. <param name="algorithm">The threading algorithm to use.</param>
  15723. <param name="query">The search query.</param>
  15724. <param name="cancellationToken">The cancellation token.</param>
  15725. <exception cref="T:System.ArgumentOutOfRangeException">
  15726. <paramref name="algorithm"/> is not supported.
  15727. </exception>
  15728. <exception cref="T:System.ArgumentNullException">
  15729. <paramref name="query"/> is <c>null</c>.
  15730. </exception>
  15731. <exception cref="T:System.NotSupportedException">
  15732. <para>One or more search terms in the <paramref name="query"/> are not supported by the IMAP server.</para>
  15733. <para>-or-</para>
  15734. <para>The server does not support the THREAD extension.</para>
  15735. </exception>
  15736. <exception cref="T:System.ObjectDisposedException">
  15737. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15738. </exception>
  15739. <exception cref="T:MailKit.ServiceNotConnectedException">
  15740. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15741. </exception>
  15742. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15743. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15744. </exception>
  15745. <exception cref="T:MailKit.FolderNotOpenException">
  15746. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15747. </exception>
  15748. <exception cref="T:System.OperationCanceledException">
  15749. The operation was canceled via the cancellation token.
  15750. </exception>
  15751. <exception cref="T:System.IO.IOException">
  15752. An I/O error occurred.
  15753. </exception>
  15754. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15755. The server's response contained unexpected tokens.
  15756. </exception>
  15757. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15758. The server replied with a NO or BAD response.
  15759. </exception>
  15760. </member>
  15761. <member name="M:MailKit.Net.Imap.ImapFolder.Thread(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.ThreadingAlgorithm,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  15762. <summary>
  15763. Thread the messages in the folder that match the search query using the specified threading algorithm.
  15764. </summary>
  15765. <remarks>
  15766. The <see cref="P:MailKit.MessageThread.UniqueId"/> can be used with methods such as
  15767. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  15768. </remarks>
  15769. <returns>An array of message threads.</returns>
  15770. <param name="uids">The subset of UIDs</param>
  15771. <param name="algorithm">The threading algorithm to use.</param>
  15772. <param name="query">The search query.</param>
  15773. <param name="cancellationToken">The cancellation token.</param>
  15774. <exception cref="T:System.ArgumentOutOfRangeException">
  15775. <paramref name="algorithm"/> is not supported.
  15776. </exception>
  15777. <exception cref="T:System.ArgumentNullException">
  15778. <para><paramref name="uids"/> is <c>null</c>.</para>
  15779. <para>-or-</para>
  15780. <para><paramref name="query"/> is <c>null</c>.</para>
  15781. </exception>
  15782. <exception cref="T:System.ArgumentException">
  15783. <para><paramref name="uids"/> is empty.</para>
  15784. <para>-or-</para>
  15785. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  15786. </exception>
  15787. <exception cref="T:System.NotSupportedException">
  15788. <para>One or more search terms in the <paramref name="query"/> are not supported by the IMAP server.</para>
  15789. <para>-or-</para>
  15790. <para>The server does not support the THREAD extension.</para>
  15791. </exception>
  15792. <exception cref="T:System.ObjectDisposedException">
  15793. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15794. </exception>
  15795. <exception cref="T:MailKit.ServiceNotConnectedException">
  15796. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15797. </exception>
  15798. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15799. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15800. </exception>
  15801. <exception cref="T:MailKit.FolderNotOpenException">
  15802. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15803. </exception>
  15804. <exception cref="T:System.OperationCanceledException">
  15805. The operation was canceled via the cancellation token.
  15806. </exception>
  15807. <exception cref="T:System.IO.IOException">
  15808. An I/O error occurred.
  15809. </exception>
  15810. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15811. The server's response contained unexpected tokens.
  15812. </exception>
  15813. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15814. The server replied with a NO or BAD response.
  15815. </exception>
  15816. </member>
  15817. <member name="M:MailKit.Net.Imap.ImapFolder.ThreadAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.ThreadingAlgorithm,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  15818. <summary>
  15819. Asynchronously thread the messages in the folder that match the search query using the specified threading algorithm.
  15820. </summary>
  15821. <remarks>
  15822. The <see cref="P:MailKit.MessageThread.UniqueId"/> can be used with methods such as
  15823. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  15824. </remarks>
  15825. <returns>An array of message threads.</returns>
  15826. <param name="uids">The subset of UIDs</param>
  15827. <param name="algorithm">The threading algorithm to use.</param>
  15828. <param name="query">The search query.</param>
  15829. <param name="cancellationToken">The cancellation token.</param>
  15830. <exception cref="T:System.ArgumentOutOfRangeException">
  15831. <paramref name="algorithm"/> is not supported.
  15832. </exception>
  15833. <exception cref="T:System.ArgumentNullException">
  15834. <para><paramref name="uids"/> is <c>null</c>.</para>
  15835. <para>-or-</para>
  15836. <para><paramref name="query"/> is <c>null</c>.</para>
  15837. </exception>
  15838. <exception cref="T:System.ArgumentException">
  15839. <para><paramref name="uids"/> is empty.</para>
  15840. <para>-or-</para>
  15841. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  15842. </exception>
  15843. <exception cref="T:System.NotSupportedException">
  15844. <para>One or more search terms in the <paramref name="query"/> are not supported by the IMAP server.</para>
  15845. <para>-or-</para>
  15846. <para>The server does not support the THREAD extension.</para>
  15847. </exception>
  15848. <exception cref="T:System.ObjectDisposedException">
  15849. The <see cref="T:MailKit.Net.Imap.ImapClient"/> has been disposed.
  15850. </exception>
  15851. <exception cref="T:MailKit.ServiceNotConnectedException">
  15852. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not connected.
  15853. </exception>
  15854. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  15855. The <see cref="T:MailKit.Net.Imap.ImapClient"/> is not authenticated.
  15856. </exception>
  15857. <exception cref="T:MailKit.FolderNotOpenException">
  15858. The <see cref="T:MailKit.Net.Imap.ImapFolder"/> is not currently open.
  15859. </exception>
  15860. <exception cref="T:System.OperationCanceledException">
  15861. The operation was canceled via the cancellation token.
  15862. </exception>
  15863. <exception cref="T:System.IO.IOException">
  15864. An I/O error occurred.
  15865. </exception>
  15866. <exception cref="T:MailKit.Net.Imap.ImapProtocolException">
  15867. The server's response contained unexpected tokens.
  15868. </exception>
  15869. <exception cref="T:MailKit.Net.Imap.ImapCommandException">
  15870. The server replied with a NO or BAD response.
  15871. </exception>
  15872. </member>
  15873. <member name="T:MailKit.Net.Imap.ImapFolderConstructorArgs">
  15874. <summary>
  15875. Constructor arguments for <see cref="T:MailKit.Net.Imap.ImapFolder"/>.
  15876. </summary>
  15877. <remarks>
  15878. Constructor arguments for <see cref="T:MailKit.Net.Imap.ImapFolder"/>.
  15879. </remarks>
  15880. </member>
  15881. <member name="M:MailKit.Net.Imap.ImapFolderConstructorArgs.#ctor(MailKit.Net.Imap.ImapEngine,System.String,MailKit.FolderAttributes,System.Char)">
  15882. <summary>
  15883. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapFolderConstructorArgs"/> class.
  15884. </summary>
  15885. <param name="engine">The IMAP command engine.</param>
  15886. <param name="encodedName">The encoded name.</param>
  15887. <param name="attributes">The attributes.</param>
  15888. <param name="delim">The directory separator.</param>
  15889. </member>
  15890. <member name="P:MailKit.Net.Imap.ImapFolderConstructorArgs.Attributes">
  15891. <summary>
  15892. Get the folder attributes.
  15893. </summary>
  15894. <remarks>
  15895. Gets the folder attributes.
  15896. </remarks>
  15897. <value>The folder attributes.</value>
  15898. </member>
  15899. <member name="P:MailKit.Net.Imap.ImapFolderConstructorArgs.DirectorySeparator">
  15900. <summary>
  15901. Get the directory separator.
  15902. </summary>
  15903. <remarks>
  15904. Gets the directory separator.
  15905. </remarks>
  15906. <value>The directory separator.</value>
  15907. </member>
  15908. <member name="P:MailKit.Net.Imap.ImapFolderConstructorArgs.FullName">
  15909. <summary>
  15910. Get the full name of the folder.
  15911. </summary>
  15912. <remarks>
  15913. This is the equivalent of the full path of a file on a file system.
  15914. </remarks>
  15915. <value>The full name of the folder.</value>
  15916. </member>
  15917. <member name="P:MailKit.Net.Imap.ImapFolderConstructorArgs.Name">
  15918. <summary>
  15919. Get the name of the folder.
  15920. </summary>
  15921. <remarks>
  15922. This is the equivalent of the file name of a file on the file system.
  15923. </remarks>
  15924. <value>The name of the folder.</value>
  15925. </member>
  15926. <member name="T:MailKit.Net.Imap.ImapImplementation">
  15927. <summary>
  15928. The details of an IMAP client or server implementation.
  15929. </summary>
  15930. <remarks>
  15931. Allows an IMAP client and server to share their implementation details
  15932. with each other for the purposes of debugging.
  15933. </remarks>
  15934. <example>
  15935. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  15936. </example>
  15937. </member>
  15938. <member name="M:MailKit.Net.Imap.ImapImplementation.#ctor">
  15939. <summary>
  15940. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapImplementation"/> class.
  15941. </summary>
  15942. <remarks>
  15943. Creates a new <see cref="T:MailKit.Net.Imap.ImapImplementation"/>.
  15944. </remarks>
  15945. <example>
  15946. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  15947. </example>
  15948. </member>
  15949. <member name="P:MailKit.Net.Imap.ImapImplementation.Properties">
  15950. <summary>
  15951. Get the identification properties.
  15952. </summary>
  15953. <remarks>
  15954. Gets the dictionary of raw identification properties.
  15955. </remarks>
  15956. <example>
  15957. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  15958. </example>
  15959. <value>The properties.</value>
  15960. </member>
  15961. <member name="P:MailKit.Net.Imap.ImapImplementation.Name">
  15962. <summary>
  15963. Get or set the name of the program.
  15964. </summary>
  15965. <remarks>
  15966. Gets or sets the name of the program.
  15967. </remarks>
  15968. <example>
  15969. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  15970. </example>
  15971. <value>The program name.</value>
  15972. </member>
  15973. <member name="P:MailKit.Net.Imap.ImapImplementation.Version">
  15974. <summary>
  15975. Get or set the version of the program.
  15976. </summary>
  15977. <remarks>
  15978. Gets or sets the version of the program.
  15979. </remarks>
  15980. <example>
  15981. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  15982. </example>
  15983. <value>The program version.</value>
  15984. </member>
  15985. <member name="P:MailKit.Net.Imap.ImapImplementation.OS">
  15986. <summary>
  15987. Get or set the name of the operating system.
  15988. </summary>
  15989. <remarks>
  15990. Gets or sets the name of the operating system.
  15991. </remarks>
  15992. <value>The name of the operation system.</value>
  15993. </member>
  15994. <member name="P:MailKit.Net.Imap.ImapImplementation.OSVersion">
  15995. <summary>
  15996. Get or set the version of the operating system.
  15997. </summary>
  15998. <remarks>
  15999. Gets or sets the version of the operating system.
  16000. </remarks>
  16001. <value>The version of the operation system.</value>
  16002. </member>
  16003. <member name="P:MailKit.Net.Imap.ImapImplementation.Vendor">
  16004. <summary>
  16005. Get or set the name of the vendor.
  16006. </summary>
  16007. <remarks>
  16008. Gets or sets the name of the vendor.
  16009. </remarks>
  16010. <value>The name of the vendor.</value>
  16011. </member>
  16012. <member name="P:MailKit.Net.Imap.ImapImplementation.SupportUrl">
  16013. <summary>
  16014. Get or set the support URL.
  16015. </summary>
  16016. <remarks>
  16017. Gets or sets the support URL.
  16018. </remarks>
  16019. <value>The support URL.</value>
  16020. </member>
  16021. <member name="P:MailKit.Net.Imap.ImapImplementation.Address">
  16022. <summary>
  16023. Get or set the postal address of the vendor.
  16024. </summary>
  16025. <remarks>
  16026. Gets or sets the postal address of the vendor.
  16027. </remarks>
  16028. <value>The postal address.</value>
  16029. </member>
  16030. <member name="P:MailKit.Net.Imap.ImapImplementation.ReleaseDate">
  16031. <summary>
  16032. Get or set the release date of the program.
  16033. </summary>
  16034. <remarks>
  16035. Gets or sets the release date of the program.
  16036. </remarks>
  16037. <value>The release date.</value>
  16038. </member>
  16039. <member name="P:MailKit.Net.Imap.ImapImplementation.Command">
  16040. <summary>
  16041. Get or set the command used to start the program.
  16042. </summary>
  16043. <remarks>
  16044. Gets or sets the command used to start the program.
  16045. </remarks>
  16046. <value>The command used to start the program.</value>
  16047. </member>
  16048. <member name="P:MailKit.Net.Imap.ImapImplementation.Arguments">
  16049. <summary>
  16050. Get or set the command-line arguments used to start the program.
  16051. </summary>
  16052. <remarks>
  16053. Gets or sets the command-line arguments used to start the program.
  16054. </remarks>
  16055. <value>The command-line arguments used to start the program.</value>
  16056. </member>
  16057. <member name="P:MailKit.Net.Imap.ImapImplementation.Environment">
  16058. <summary>
  16059. Get or set the environment variables available to the program.
  16060. </summary>
  16061. <remarks>
  16062. Get or set the environment variables available to the program.
  16063. </remarks>
  16064. <value>The environment variables.</value>
  16065. </member>
  16066. <member name="T:MailKit.Net.Imap.ImapProtocolException">
  16067. <summary>
  16068. An IMAP protocol exception.
  16069. </summary>
  16070. <remarks>
  16071. The exception that is thrown when there is an error communicating with an IMAP server. An
  16072. <see cref="T:MailKit.Net.Imap.ImapProtocolException"/> is typically fatal and requires the <see cref="T:MailKit.Net.Imap.ImapClient"/>
  16073. to be reconnected.
  16074. </remarks>
  16075. </member>
  16076. <member name="M:MailKit.Net.Imap.ImapProtocolException.#ctor(System.String,System.Exception)">
  16077. <summary>
  16078. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapProtocolException"/> class.
  16079. </summary>
  16080. <remarks>
  16081. Creates a new <see cref="T:MailKit.Net.Imap.ImapProtocolException"/>.
  16082. </remarks>
  16083. <param name="message">The error message.</param>
  16084. <param name="innerException">An inner exception.</param>
  16085. </member>
  16086. <member name="M:MailKit.Net.Imap.ImapProtocolException.#ctor(System.String)">
  16087. <summary>
  16088. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapProtocolException"/> class.
  16089. </summary>
  16090. <remarks>
  16091. Creates a new <see cref="T:MailKit.Net.Imap.ImapProtocolException"/>.
  16092. </remarks>
  16093. <param name="message">The error message.</param>
  16094. </member>
  16095. <member name="M:MailKit.Net.Imap.ImapProtocolException.#ctor">
  16096. <summary>
  16097. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapProtocolException"/> class.
  16098. </summary>
  16099. <remarks>
  16100. Creates a new <see cref="T:MailKit.Net.Imap.ImapProtocolException"/>.
  16101. </remarks>
  16102. </member>
  16103. <member name="P:MailKit.Net.Imap.ImapProtocolException.UnexpectedToken">
  16104. <summary>
  16105. Gets or sets whether or not this exception was thrown due to an unexpected token.
  16106. </summary>
  16107. <remarks>
  16108. Gets or sets whether or not this exception was thrown due to an unexpected token.
  16109. </remarks>
  16110. <value><c>true</c> if an unexpected token was encountered; otherwise, <c>false</c>.</value>
  16111. </member>
  16112. <member name="T:MailKit.Net.Imap.ImapStreamMode">
  16113. <summary>
  16114. An enumeration of the possible IMAP streaming modes.
  16115. </summary>
  16116. <remarks>
  16117. Normal operation is done in the <see cref="F:MailKit.Net.Imap.ImapStreamMode.Token"/> mode,
  16118. but when reading literal string data, the
  16119. <see cref="F:MailKit.Net.Imap.ImapStreamMode.Literal"/> mode should be used.
  16120. </remarks>
  16121. </member>
  16122. <member name="F:MailKit.Net.Imap.ImapStreamMode.Token">
  16123. <summary>
  16124. Reads 1 token at a time.
  16125. </summary>
  16126. </member>
  16127. <member name="F:MailKit.Net.Imap.ImapStreamMode.Literal">
  16128. <summary>
  16129. Reads literal string data.
  16130. </summary>
  16131. </member>
  16132. <member name="M:MailKit.Net.Imap.ImapStream.#ctor(System.IO.Stream,MailKit.IProtocolLogger)">
  16133. <summary>
  16134. Initializes a new instance of the <see cref="T:MailKit.Net.Imap.ImapStream"/> class.
  16135. </summary>
  16136. <remarks>
  16137. Creates a new <see cref="T:MailKit.Net.Imap.ImapStream"/>.
  16138. </remarks>
  16139. <param name="source">The underlying network stream.</param>
  16140. <param name="protocolLogger">The protocol logger.</param>
  16141. </member>
  16142. <member name="P:MailKit.Net.Imap.ImapStream.Stream">
  16143. <summary>
  16144. Get or sets the underlying network stream.
  16145. </summary>
  16146. <remarks>
  16147. Gets or sets the underlying network stream.
  16148. </remarks>
  16149. <value>The underlying network stream.</value>
  16150. </member>
  16151. <member name="P:MailKit.Net.Imap.ImapStream.Mode">
  16152. <summary>
  16153. Get or sets the mode used for reading.
  16154. </summary>
  16155. <remarks>
  16156. Gets or sets the mode used for reading.
  16157. </remarks>
  16158. <value>The mode.</value>
  16159. </member>
  16160. <member name="P:MailKit.Net.Imap.ImapStream.LiteralLength">
  16161. <summary>
  16162. Get the length of the literal.
  16163. </summary>
  16164. <remarks>
  16165. Gets the length of the literal.
  16166. </remarks>
  16167. <value>The length of the literal.</value>
  16168. </member>
  16169. <member name="P:MailKit.Net.Imap.ImapStream.IsConnected">
  16170. <summary>
  16171. Get whether or not the stream is connected.
  16172. </summary>
  16173. <remarks>
  16174. Gets whether or not the stream is connected.
  16175. </remarks>
  16176. <value><c>true</c> if the stream is connected; otherwise, <c>false</c>.</value>
  16177. </member>
  16178. <member name="P:MailKit.Net.Imap.ImapStream.CanRead">
  16179. <summary>
  16180. Get whether the stream supports reading.
  16181. </summary>
  16182. <remarks>
  16183. Gets whether the stream supports reading.
  16184. </remarks>
  16185. <value><c>true</c> if the stream supports reading; otherwise, <c>false</c>.</value>
  16186. </member>
  16187. <member name="P:MailKit.Net.Imap.ImapStream.CanWrite">
  16188. <summary>
  16189. Get whether the stream supports writing.
  16190. </summary>
  16191. <remarks>
  16192. Gets whether the stream supports writing.
  16193. </remarks>
  16194. <value><c>true</c> if the stream supports writing; otherwise, <c>false</c>.</value>
  16195. </member>
  16196. <member name="P:MailKit.Net.Imap.ImapStream.CanSeek">
  16197. <summary>
  16198. Get whether the stream supports seeking.
  16199. </summary>
  16200. <remarks>
  16201. Gets whether the stream supports seeking.
  16202. </remarks>
  16203. <value><c>true</c> if the stream supports seeking; otherwise, <c>false</c>.</value>
  16204. </member>
  16205. <member name="P:MailKit.Net.Imap.ImapStream.CanTimeout">
  16206. <summary>
  16207. Get whether the stream supports I/O timeouts.
  16208. </summary>
  16209. <remarks>
  16210. Gets whether the stream supports I/O timeouts.
  16211. </remarks>
  16212. <value><c>true</c> if the stream supports I/O timeouts; otherwise, <c>false</c>.</value>
  16213. </member>
  16214. <member name="P:MailKit.Net.Imap.ImapStream.ReadTimeout">
  16215. <summary>
  16216. Get or set a value, in milliseconds, that determines how long the stream will attempt to read before timing out.
  16217. </summary>
  16218. <remarks>
  16219. Gets or sets a value, in milliseconds, that determines how long the stream will attempt to read before timing out.
  16220. </remarks>
  16221. <returns>A value, in milliseconds, that determines how long the stream will attempt to read before timing out.</returns>
  16222. <value>The read timeout.</value>
  16223. </member>
  16224. <member name="P:MailKit.Net.Imap.ImapStream.WriteTimeout">
  16225. <summary>
  16226. Get or set a value, in milliseconds, that determines how long the stream will attempt to write before timing out.
  16227. </summary>
  16228. <remarks>
  16229. Gets or sets a value, in milliseconds, that determines how long the stream will attempt to write before timing out.
  16230. </remarks>
  16231. <returns>A value, in milliseconds, that determines how long the stream will attempt to write before timing out.</returns>
  16232. <value>The write timeout.</value>
  16233. </member>
  16234. <member name="P:MailKit.Net.Imap.ImapStream.Position">
  16235. <summary>
  16236. Get or set the position within the current stream.
  16237. </summary>
  16238. <remarks>
  16239. Gets or sets the position within the current stream.
  16240. </remarks>
  16241. <returns>The current position within the stream.</returns>
  16242. <value>The position of the stream.</value>
  16243. <exception cref="T:System.IO.IOException">
  16244. An I/O error occurred.
  16245. </exception>
  16246. <exception cref="T:System.NotSupportedException">
  16247. The stream does not support seeking.
  16248. </exception>
  16249. <exception cref="T:System.ObjectDisposedException">
  16250. The stream has been disposed.
  16251. </exception>
  16252. </member>
  16253. <member name="P:MailKit.Net.Imap.ImapStream.Length">
  16254. <summary>
  16255. Get the length of the stream, in bytes.
  16256. </summary>
  16257. <remarks>
  16258. Gets the length of the stream, in bytes.
  16259. </remarks>
  16260. <returns>A long value representing the length of the stream in bytes.</returns>
  16261. <value>The length of the stream.</value>
  16262. <exception cref="T:System.NotSupportedException">
  16263. The stream does not support seeking.
  16264. </exception>
  16265. <exception cref="T:System.ObjectDisposedException">
  16266. The stream has been disposed.
  16267. </exception>
  16268. </member>
  16269. <member name="M:MailKit.Net.Imap.ImapStream.Read(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  16270. <summary>
  16271. Reads a sequence of bytes from the stream and advances the position
  16272. within the stream by the number of bytes read.
  16273. </summary>
  16274. <returns>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many
  16275. bytes are not currently available, or zero (0) if the end of the stream has been reached.</returns>
  16276. <param name="buffer">The buffer.</param>
  16277. <param name="offset">The buffer offset.</param>
  16278. <param name="count">The number of bytes to read.</param>
  16279. <param name="cancellationToken">The cancellation token.</param>
  16280. <exception cref="T:System.ArgumentNullException">
  16281. <paramref name="buffer"/> is <c>null</c>.
  16282. </exception>
  16283. <exception cref="T:System.ArgumentOutOfRangeException">
  16284. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  16285. <para>-or-</para>
  16286. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  16287. at the specified <paramref name="offset"/>.</para>
  16288. </exception>
  16289. <exception cref="T:System.ObjectDisposedException">
  16290. The stream has been disposed.
  16291. </exception>
  16292. <exception cref="T:System.InvalidOperationException">
  16293. The stream is in token mode (see <see cref="F:MailKit.Net.Imap.ImapStreamMode.Token"/>).
  16294. </exception>
  16295. <exception cref="T:System.OperationCanceledException">
  16296. The operation was canceled via the cancellation token.
  16297. </exception>
  16298. <exception cref="T:System.IO.IOException">
  16299. An I/O error occurred.
  16300. </exception>
  16301. </member>
  16302. <member name="M:MailKit.Net.Imap.ImapStream.Read(System.Byte[],System.Int32,System.Int32)">
  16303. <summary>
  16304. Reads a sequence of bytes from the stream and advances the position
  16305. within the stream by the number of bytes read.
  16306. </summary>
  16307. <returns>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many
  16308. bytes are not currently available, or zero (0) if the end of the stream has been reached.</returns>
  16309. <param name="buffer">The buffer.</param>
  16310. <param name="offset">The buffer offset.</param>
  16311. <param name="count">The number of bytes to read.</param>
  16312. <exception cref="T:System.ArgumentNullException">
  16313. <paramref name="buffer"/> is <c>null</c>.
  16314. </exception>
  16315. <exception cref="T:System.ArgumentOutOfRangeException">
  16316. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  16317. <para>-or-</para>
  16318. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  16319. at the specified <paramref name="offset"/>.</para>
  16320. </exception>
  16321. <exception cref="T:System.ObjectDisposedException">
  16322. The stream has been disposed.
  16323. </exception>
  16324. <exception cref="T:System.InvalidOperationException">
  16325. The stream is in token mode (see <see cref="F:MailKit.Net.Imap.ImapStreamMode.Token"/>).
  16326. </exception>
  16327. <exception cref="T:System.IO.IOException">
  16328. An I/O error occurred.
  16329. </exception>
  16330. </member>
  16331. <member name="M:MailKit.Net.Imap.ImapStream.ReadAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  16332. <summary>
  16333. Reads a sequence of bytes from the stream and advances the position
  16334. within the stream by the number of bytes read.
  16335. </summary>
  16336. <remarks>
  16337. Reads a sequence of bytes from the stream and advances the position
  16338. within the stream by the number of bytes read.
  16339. </remarks>
  16340. <returns>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many
  16341. bytes are not currently available, or zero (0) if the end of the stream has been reached.</returns>
  16342. <param name="buffer">The buffer.</param>
  16343. <param name="offset">The buffer offset.</param>
  16344. <param name="count">The number of bytes to read.</param>
  16345. <param name="cancellationToken">The cancellation token.</param>
  16346. <exception cref="T:System.ArgumentNullException">
  16347. <paramref name="buffer"/> is <c>null</c>.
  16348. </exception>
  16349. <exception cref="T:System.ArgumentOutOfRangeException">
  16350. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  16351. <para>-or-</para>
  16352. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  16353. at the specified <paramref name="offset"/>.</para>
  16354. </exception>
  16355. <exception cref="T:System.ObjectDisposedException">
  16356. The stream has been disposed.
  16357. </exception>
  16358. <exception cref="T:System.OperationCanceledException">
  16359. The operation was canceled via the cancellation token.
  16360. </exception>
  16361. <exception cref="T:System.IO.IOException">
  16362. An I/O error occurred.
  16363. </exception>
  16364. </member>
  16365. <member name="M:MailKit.Net.Imap.ImapStream.ReadToken(System.Threading.CancellationToken)">
  16366. <summary>
  16367. Reads the next available token from the stream.
  16368. </summary>
  16369. <returns>The token.</returns>
  16370. <param name="cancellationToken">The cancellation token.</param>
  16371. <exception cref="T:System.ObjectDisposedException">
  16372. The stream has been disposed.
  16373. </exception>
  16374. <exception cref="T:System.OperationCanceledException">
  16375. The operation was canceled via the cancellation token.
  16376. </exception>
  16377. <exception cref="T:System.IO.IOException">
  16378. An I/O error occurred.
  16379. </exception>
  16380. </member>
  16381. <member name="M:MailKit.Net.Imap.ImapStream.ReadTokenAsync(System.Threading.CancellationToken)">
  16382. <summary>
  16383. Asynchronously reads the next available token from the stream.
  16384. </summary>
  16385. <returns>The token.</returns>
  16386. <param name="cancellationToken">The cancellation token.</param>
  16387. <exception cref="T:System.ObjectDisposedException">
  16388. The stream has been disposed.
  16389. </exception>
  16390. <exception cref="T:System.OperationCanceledException">
  16391. The operation was canceled via the cancellation token.
  16392. </exception>
  16393. <exception cref="T:System.IO.IOException">
  16394. An I/O error occurred.
  16395. </exception>
  16396. </member>
  16397. <member name="M:MailKit.Net.Imap.ImapStream.UngetToken(MailKit.Net.Imap.ImapToken)">
  16398. <summary>
  16399. Ungets a token.
  16400. </summary>
  16401. <param name="token">The token.</param>
  16402. </member>
  16403. <member name="M:MailKit.Net.Imap.ImapStream.ReadLine(System.IO.Stream,System.Threading.CancellationToken)">
  16404. <summary>
  16405. Reads a single line of input from the stream.
  16406. </summary>
  16407. <remarks>
  16408. This method should be called in a loop until it returns <c>true</c>.
  16409. </remarks>
  16410. <returns><c>true</c>, if reading the line is complete, <c>false</c> otherwise.</returns>
  16411. <param name="ostream">The output stream to write the line data into.</param>
  16412. <param name="cancellationToken">The cancellation token.</param>
  16413. <exception cref="T:System.ObjectDisposedException">
  16414. The stream has been disposed.
  16415. </exception>
  16416. <exception cref="T:System.OperationCanceledException">
  16417. The operation was canceled via the cancellation token.
  16418. </exception>
  16419. <exception cref="T:System.IO.IOException">
  16420. An I/O error occurred.
  16421. </exception>
  16422. </member>
  16423. <member name="M:MailKit.Net.Imap.ImapStream.ReadLineAsync(System.IO.Stream,System.Threading.CancellationToken)">
  16424. <summary>
  16425. Asynchronously reads a single line of input from the stream.
  16426. </summary>
  16427. <remarks>
  16428. This method should be called in a loop until it returns <c>true</c>.
  16429. </remarks>
  16430. <returns><c>true</c>, if reading the line is complete, <c>false</c> otherwise.</returns>
  16431. <param name="ostream">The output stream to write the line data into.</param>
  16432. <param name="cancellationToken">The cancellation token.</param>
  16433. <exception cref="T:System.ObjectDisposedException">
  16434. The stream has been disposed.
  16435. </exception>
  16436. <exception cref="T:System.OperationCanceledException">
  16437. The operation was canceled via the cancellation token.
  16438. </exception>
  16439. <exception cref="T:System.IO.IOException">
  16440. An I/O error occurred.
  16441. </exception>
  16442. </member>
  16443. <member name="M:MailKit.Net.Imap.ImapStream.Write(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  16444. <summary>
  16445. Writes a sequence of bytes to the stream and advances the current
  16446. position within this stream by the number of bytes written.
  16447. </summary>
  16448. <remarks>
  16449. Writes a sequence of bytes to the stream and advances the current
  16450. position within this stream by the number of bytes written.
  16451. </remarks>
  16452. <param name='buffer'>The buffer to write.</param>
  16453. <param name='offset'>The offset of the first byte to write.</param>
  16454. <param name='count'>The number of bytes to write.</param>
  16455. <param name="cancellationToken">The cancellation token.</param>
  16456. <exception cref="T:System.ArgumentNullException">
  16457. <paramref name="buffer"/> is <c>null</c>.
  16458. </exception>
  16459. <exception cref="T:System.ArgumentOutOfRangeException">
  16460. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  16461. <para>-or-</para>
  16462. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  16463. at the specified <paramref name="offset"/>.</para>
  16464. </exception>
  16465. <exception cref="T:System.ObjectDisposedException">
  16466. The stream has been disposed.
  16467. </exception>
  16468. <exception cref="T:System.NotSupportedException">
  16469. The stream does not support writing.
  16470. </exception>
  16471. <exception cref="T:System.OperationCanceledException">
  16472. The operation was canceled via the cancellation token.
  16473. </exception>
  16474. <exception cref="T:System.IO.IOException">
  16475. An I/O error occurred.
  16476. </exception>
  16477. </member>
  16478. <member name="M:MailKit.Net.Imap.ImapStream.Write(System.Byte[],System.Int32,System.Int32)">
  16479. <summary>
  16480. Writes a sequence of bytes to the stream and advances the current
  16481. position within this stream by the number of bytes written.
  16482. </summary>
  16483. <remarks>
  16484. Writes a sequence of bytes to the stream and advances the current
  16485. position within this stream by the number of bytes written.
  16486. </remarks>
  16487. <param name='buffer'>The buffer to write.</param>
  16488. <param name='offset'>The offset of the first byte to write.</param>
  16489. <param name='count'>The number of bytes to write.</param>
  16490. <exception cref="T:System.ArgumentNullException">
  16491. <paramref name="buffer"/> is <c>null</c>.
  16492. </exception>
  16493. <exception cref="T:System.ArgumentOutOfRangeException">
  16494. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  16495. <para>-or-</para>
  16496. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  16497. at the specified <paramref name="offset"/>.</para>
  16498. </exception>
  16499. <exception cref="T:System.ObjectDisposedException">
  16500. The stream has been disposed.
  16501. </exception>
  16502. <exception cref="T:System.NotSupportedException">
  16503. The stream does not support writing.
  16504. </exception>
  16505. <exception cref="T:System.IO.IOException">
  16506. An I/O error occurred.
  16507. </exception>
  16508. </member>
  16509. <member name="M:MailKit.Net.Imap.ImapStream.WriteAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  16510. <summary>
  16511. Writes a sequence of bytes to the stream and advances the current
  16512. position within this stream by the number of bytes written.
  16513. </summary>
  16514. <remarks>
  16515. Writes a sequence of bytes to the stream and advances the current
  16516. position within this stream by the number of bytes written.
  16517. </remarks>
  16518. <returns>A task that represents the asynchronous write operation.</returns>
  16519. <param name='buffer'>The buffer to write.</param>
  16520. <param name='offset'>The offset of the first byte to write.</param>
  16521. <param name='count'>The number of bytes to write.</param>
  16522. <param name="cancellationToken">The cancellation token.</param>
  16523. <exception cref="T:System.ArgumentNullException">
  16524. <paramref name="buffer"/> is <c>null</c>.
  16525. </exception>
  16526. <exception cref="T:System.ArgumentOutOfRangeException">
  16527. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  16528. <para>-or-</para>
  16529. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  16530. at the specified <paramref name="offset"/>.</para>
  16531. </exception>
  16532. <exception cref="T:System.ObjectDisposedException">
  16533. The stream has been disposed.
  16534. </exception>
  16535. <exception cref="T:System.NotSupportedException">
  16536. The stream does not support writing.
  16537. </exception>
  16538. <exception cref="T:System.OperationCanceledException">
  16539. The operation was canceled via the cancellation token.
  16540. </exception>
  16541. <exception cref="T:System.IO.IOException">
  16542. An I/O error occurred.
  16543. </exception>
  16544. </member>
  16545. <member name="M:MailKit.Net.Imap.ImapStream.Flush(System.Threading.CancellationToken)">
  16546. <summary>
  16547. Clears all output buffers for this stream and causes any buffered data to be written
  16548. to the underlying device.
  16549. </summary>
  16550. <remarks>
  16551. Clears all output buffers for this stream and causes any buffered data to be written
  16552. to the underlying device.
  16553. </remarks>
  16554. <param name="cancellationToken">The cancellation token.</param>
  16555. <exception cref="T:System.ObjectDisposedException">
  16556. The stream has been disposed.
  16557. </exception>
  16558. <exception cref="T:System.NotSupportedException">
  16559. The stream does not support writing.
  16560. </exception>
  16561. <exception cref="T:System.OperationCanceledException">
  16562. The operation was canceled via the cancellation token.
  16563. </exception>
  16564. <exception cref="T:System.IO.IOException">
  16565. An I/O error occurred.
  16566. </exception>
  16567. </member>
  16568. <member name="M:MailKit.Net.Imap.ImapStream.Flush">
  16569. <summary>
  16570. Clears all output buffers for this stream and causes any buffered data to be written
  16571. to the underlying device.
  16572. </summary>
  16573. <remarks>
  16574. Clears all output buffers for this stream and causes any buffered data to be written
  16575. to the underlying device.
  16576. </remarks>
  16577. <exception cref="T:System.ObjectDisposedException">
  16578. The stream has been disposed.
  16579. </exception>
  16580. <exception cref="T:System.NotSupportedException">
  16581. The stream does not support writing.
  16582. </exception>
  16583. <exception cref="T:System.IO.IOException">
  16584. An I/O error occurred.
  16585. </exception>
  16586. </member>
  16587. <member name="M:MailKit.Net.Imap.ImapStream.FlushAsync(System.Threading.CancellationToken)">
  16588. <summary>
  16589. Clears all buffers for this stream and causes any buffered data to be written
  16590. to the underlying device.
  16591. </summary>
  16592. <remarks>
  16593. Clears all buffers for this stream and causes any buffered data to be written
  16594. to the underlying device.
  16595. </remarks>
  16596. <returns>A task that represents the asynchronous flush operation.</returns>
  16597. <param name="cancellationToken">The cancellation token.</param>
  16598. <exception cref="T:System.ObjectDisposedException">
  16599. The stream has been disposed.
  16600. </exception>
  16601. <exception cref="T:System.NotSupportedException">
  16602. The stream does not support writing.
  16603. </exception>
  16604. <exception cref="T:System.OperationCanceledException">
  16605. The operation was canceled via the cancellation token.
  16606. </exception>
  16607. <exception cref="T:System.IO.IOException">
  16608. An I/O error occurred.
  16609. </exception>
  16610. </member>
  16611. <member name="M:MailKit.Net.Imap.ImapStream.Seek(System.Int64,System.IO.SeekOrigin)">
  16612. <summary>
  16613. Sets the position within the current stream.
  16614. </summary>
  16615. <remarks>
  16616. It is not possible to seek within a <see cref="T:MailKit.Net.Imap.ImapStream"/>.
  16617. </remarks>
  16618. <returns>The new position within the stream.</returns>
  16619. <param name="offset">The offset into the stream relative to the <paramref name="origin"/>.</param>
  16620. <param name="origin">The origin to seek from.</param>
  16621. <exception cref="T:System.NotSupportedException">
  16622. The stream does not support seeking.
  16623. </exception>
  16624. </member>
  16625. <member name="M:MailKit.Net.Imap.ImapStream.SetLength(System.Int64)">
  16626. <summary>
  16627. Sets the length of the stream.
  16628. </summary>
  16629. <remarks>
  16630. It is not possible to set the length of a <see cref="T:MailKit.Net.Imap.ImapStream"/>.
  16631. </remarks>
  16632. <param name="value">The desired length of the stream in bytes.</param>
  16633. <exception cref="T:System.NotSupportedException">
  16634. The stream does not support setting the length.
  16635. </exception>
  16636. </member>
  16637. <member name="M:MailKit.Net.Imap.ImapStream.Dispose(System.Boolean)">
  16638. <summary>
  16639. Releases the unmanaged resources used by the <see cref="T:MailKit.Net.Imap.ImapStream"/> and
  16640. optionally releases the managed resources.
  16641. </summary>
  16642. <remarks>
  16643. Releases the unmanaged resources used by the <see cref="T:MailKit.Net.Imap.ImapStream"/> and
  16644. optionally releases the managed resources.
  16645. </remarks>
  16646. <param name="disposing"><c>true</c> to release both managed and unmanaged resources;
  16647. <c>false</c> to release only the unmanaged resources.</param>
  16648. </member>
  16649. <member name="T:MailKit.Net.Imap.ImapUtils">
  16650. <summary>
  16651. IMAP utility functions.
  16652. </summary>
  16653. </member>
  16654. <member name="M:MailKit.Net.Imap.ImapUtils.FormatInternalDate(System.DateTimeOffset)">
  16655. <summary>
  16656. Formats a date in a format suitable for use with the APPEND command.
  16657. </summary>
  16658. <returns>The formatted date string.</returns>
  16659. <param name="date">The date.</param>
  16660. </member>
  16661. <member name="M:MailKit.Net.Imap.ImapUtils.ParseInternalDate(System.String)">
  16662. <summary>
  16663. Parses the internal date string.
  16664. </summary>
  16665. <returns>The date.</returns>
  16666. <param name="text">The text to parse.</param>
  16667. </member>
  16668. <member name="M:MailKit.Net.Imap.ImapUtils.FormatAnnotations(System.Text.StringBuilder,System.Collections.Generic.IList{MailKit.Annotation},System.Collections.Generic.List{System.Object},System.Boolean)">
  16669. <summary>
  16670. Formats a list of annotations for a STORE or APPEND command.
  16671. </summary>
  16672. <param name="command">The command builder.</param>
  16673. <param name="annotations">The annotations.</param>
  16674. <param name="args">the argument list.</param>
  16675. <param name="throwOnError">Throw an exception if there are any annotations without properties.</param>
  16676. </member>
  16677. <member name="M:MailKit.Net.Imap.ImapUtils.FormatIndexSet(System.Collections.Generic.IList{System.Int32})">
  16678. <summary>
  16679. Formats the array of indexes as a string suitable for use with IMAP commands.
  16680. </summary>
  16681. <returns>The index set.</returns>
  16682. <param name="indexes">The indexes.</param>
  16683. <exception cref="T:System.ArgumentNullException">
  16684. <paramref name="indexes"/> is <c>null</c>.
  16685. </exception>
  16686. <exception cref="T:System.ArgumentOutOfRangeException">
  16687. One or more of the indexes has a negative value.
  16688. </exception>
  16689. </member>
  16690. <member name="M:MailKit.Net.Imap.ImapUtils.ParseImplementationAsync(MailKit.Net.Imap.ImapEngine,MailKit.Net.Imap.ImapCommand,System.Int32,System.Boolean)">
  16691. <summary>
  16692. Parses an untagged ID response.
  16693. </summary>
  16694. <param name="engine">The IMAP engine.</param>
  16695. <param name="ic">The IMAP command.</param>
  16696. <param name="index">The index.</param>
  16697. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  16698. </member>
  16699. <member name="M:MailKit.Net.Imap.ImapUtils.CanonicalizeMailboxName(System.String,System.Char)">
  16700. <summary>
  16701. Canonicalize the name of the mailbox.
  16702. </summary>
  16703. <remarks>
  16704. Canonicalizes the name of the mailbox by replacing various
  16705. capitalizations of "INBOX" with the literal "INBOX" string.
  16706. </remarks>
  16707. <returns>The mailbox name.</returns>
  16708. <param name="mailboxName">The encoded mailbox name.</param>
  16709. <param name="directorySeparator">The directory separator.</param>
  16710. </member>
  16711. <member name="M:MailKit.Net.Imap.ImapUtils.IsInbox(System.String)">
  16712. <summary>
  16713. Determines whether the specified mailbox is the Inbox.
  16714. </summary>
  16715. <returns><c>true</c> if the specified mailbox name is the Inbox; otherwise, <c>false</c>.</returns>
  16716. <param name="mailboxName">The mailbox name.</param>
  16717. </member>
  16718. <member name="M:MailKit.Net.Imap.ImapUtils.ParseFolderListAsync(MailKit.Net.Imap.ImapEngine,System.Collections.Generic.List{MailKit.Net.Imap.ImapFolder},System.Boolean,System.Boolean,System.Boolean,System.Threading.CancellationToken)">
  16719. <summary>
  16720. Parses an untagged LIST or LSUB response.
  16721. </summary>
  16722. <param name="engine">The IMAP engine.</param>
  16723. <param name="list">The list of folders to be populated.</param>
  16724. <param name="isLsub"><c>true</c> if it is an LSUB response; otherwise, <c>false</c>.</param>
  16725. <param name="returnsSubscribed"><c>true</c> if the LIST response is expected to return \Subscribed flags; otherwise, <c>false</c>.</param>
  16726. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  16727. <param name="cancellationToken">The cancellation token.</param>
  16728. </member>
  16729. <member name="M:MailKit.Net.Imap.ImapUtils.ParseFolderListAsync(MailKit.Net.Imap.ImapEngine,MailKit.Net.Imap.ImapCommand,System.Int32,System.Boolean)">
  16730. <summary>
  16731. Parses an untagged LIST or LSUB response.
  16732. </summary>
  16733. <param name="engine">The IMAP engine.</param>
  16734. <param name="ic">The IMAP command.</param>
  16735. <param name="index">The index.</param>
  16736. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  16737. </member>
  16738. <member name="M:MailKit.Net.Imap.ImapUtils.ParseMetadataAsync(MailKit.Net.Imap.ImapEngine,MailKit.MetadataCollection,System.Boolean,System.Threading.CancellationToken)">
  16739. <summary>
  16740. Parses an untagged METADATA response.
  16741. </summary>
  16742. <returns>The encoded name of the folder that the metadata belongs to.</returns>
  16743. <param name="engine">The IMAP engine.</param>
  16744. <param name="metadata">The metadata collection to be populated.</param>
  16745. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  16746. <param name="cancellationToken">The cancellation token.</param>
  16747. </member>
  16748. <member name="M:MailKit.Net.Imap.ImapUtils.ParseMetadataAsync(MailKit.Net.Imap.ImapEngine,MailKit.Net.Imap.ImapCommand,System.Int32,System.Boolean)">
  16749. <summary>
  16750. Parses an untagged METADATA response.
  16751. </summary>
  16752. <param name="engine">The IMAP engine.</param>
  16753. <param name="ic">The IMAP command.</param>
  16754. <param name="index">The index.</param>
  16755. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  16756. </member>
  16757. <member name="M:MailKit.Net.Imap.ImapUtils.ParseEnvelopeAsync(MailKit.Net.Imap.ImapEngine,System.Boolean,System.Threading.CancellationToken)">
  16758. <summary>
  16759. Parses the ENVELOPE parenthesized list.
  16760. </summary>
  16761. <returns>The envelope.</returns>
  16762. <param name="engine">The IMAP engine.</param>
  16763. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  16764. <param name="cancellationToken">The cancellation token.</param>
  16765. </member>
  16766. <member name="M:MailKit.Net.Imap.ImapUtils.FormatFlagsList(MailKit.MessageFlags,System.Int32)">
  16767. <summary>
  16768. Formats a flags list suitable for use with the APPEND command.
  16769. </summary>
  16770. <returns>The flags list string.</returns>
  16771. <param name="flags">The message flags.</param>
  16772. <param name="numUserFlags">The number of user-defined flags.</param>
  16773. </member>
  16774. <member name="M:MailKit.Net.Imap.ImapUtils.ParseFlagsListAsync(MailKit.Net.Imap.ImapEngine,System.String,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  16775. <summary>
  16776. Parses the flags list.
  16777. </summary>
  16778. <returns>The message flags.</returns>
  16779. <param name="engine">The IMAP engine.</param>
  16780. <param name="name">The name of the flags being parsed.</param>
  16781. <param name="keywords">A hash set of user-defined message flags that will be populated if non-null.</param>
  16782. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  16783. <param name="cancellationToken">The cancellation token.</param>
  16784. </member>
  16785. <member name="M:MailKit.Net.Imap.ImapUtils.ParseAnnotationsAsync(MailKit.Net.Imap.ImapEngine,System.Boolean,System.Threading.CancellationToken)">
  16786. <summary>
  16787. Parses the ANNOTATION list.
  16788. </summary>
  16789. <returns>The list of annotations.</returns>
  16790. <param name="engine">The IMAP engine.</param>
  16791. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  16792. <param name="cancellationToken">The cancellation token.</param>
  16793. </member>
  16794. <member name="M:MailKit.Net.Imap.ImapUtils.ParseLabelsListAsync(MailKit.Net.Imap.ImapEngine,System.Boolean,System.Threading.CancellationToken)">
  16795. <summary>
  16796. Parses the X-GM-LABELS list.
  16797. </summary>
  16798. <returns>The message labels.</returns>
  16799. <param name="engine">The IMAP engine.</param>
  16800. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  16801. <param name="cancellationToken">The cancellation token.</param>
  16802. </member>
  16803. <member name="M:MailKit.Net.Imap.ImapUtils.ParseThreadsAsync(MailKit.Net.Imap.ImapEngine,System.UInt32,System.Boolean,System.Threading.CancellationToken)">
  16804. <summary>
  16805. Parses the threads.
  16806. </summary>
  16807. <returns>The threads.</returns>
  16808. <param name="engine">The IMAP engine.</param>
  16809. <param name="uidValidity">The UIDVALIDITY of the folder.</param>
  16810. <param name="doAsync">Whether or not asynchronous IO methods should be used.</param>
  16811. <param name="cancellationToken">The cancellation token.</param>
  16812. </member>
  16813. <member name="T:MailKit.Net.Pop3.Pop3Client">
  16814. <summary>
  16815. A POP3 client that can be used to retrieve messages from a server.
  16816. </summary>
  16817. <remarks>
  16818. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> class supports both the "pop" and "pops" protocols. The "pop" protocol
  16819. makes a clear-text connection to the POP3 server and does not use SSL or TLS unless the POP3 server
  16820. supports the <a href="https://tools.ietf.org/html/rfc2595">STLS</a> extension. The "pops" protocol,
  16821. however, connects to the POP3 server using an SSL-wrapped connection.
  16822. </remarks>
  16823. <example>
  16824. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadMessages"/>
  16825. </example>
  16826. </member>
  16827. <member name="M:MailKit.Net.Pop3.Pop3Client.AuthenticateAsync(MailKit.Security.SaslMechanism,System.Threading.CancellationToken)">
  16828. <summary>
  16829. Asynchronously authenticate using the specified SASL mechanism.
  16830. </summary>
  16831. <remarks>
  16832. <para>Authenticates using the specified SASL mechanism.</para>
  16833. <para>For a list of available SASL authentication mechanisms supported by the server,
  16834. check the <see cref="P:MailKit.Net.Pop3.Pop3Client.AuthenticationMechanisms"/> property after the service has been
  16835. connected.</para>
  16836. </remarks>
  16837. <returns>An asynchronous task context.</returns>
  16838. <param name="mechanism">The SASL mechanism.</param>
  16839. <param name="cancellationToken">The cancellation token.</param>
  16840. <exception cref="T:System.ArgumentNullException">
  16841. <paramref name="mechanism"/> is <c>null</c>.
  16842. </exception>
  16843. <exception cref="T:System.ObjectDisposedException">
  16844. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  16845. </exception>
  16846. <exception cref="T:MailKit.ServiceNotConnectedException">
  16847. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  16848. </exception>
  16849. <exception cref="T:System.InvalidOperationException">
  16850. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is already authenticated.
  16851. </exception>
  16852. <exception cref="T:System.OperationCanceledException">
  16853. The operation was canceled via the cancellation token.
  16854. </exception>
  16855. <exception cref="T:MailKit.Security.AuthenticationException">
  16856. Authentication using the supplied credentials has failed.
  16857. </exception>
  16858. <exception cref="T:MailKit.Security.SaslException">
  16859. A SASL authentication error occurred.
  16860. </exception>
  16861. <exception cref="T:System.IO.IOException">
  16862. An I/O error occurred.
  16863. </exception>
  16864. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  16865. A POP3 command failed.
  16866. </exception>
  16867. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  16868. An POP3 protocol error occurred.
  16869. </exception>
  16870. </member>
  16871. <member name="M:MailKit.Net.Pop3.Pop3Client.AuthenticateAsync(System.Text.Encoding,System.Net.ICredentials,System.Threading.CancellationToken)">
  16872. <summary>
  16873. Asynchronously authenticates using the supplied credentials.
  16874. </summary>
  16875. <remarks>
  16876. <para>If the POP3 server supports the APOP authentication mechanism,
  16877. then APOP is used.</para>
  16878. <para>If the APOP authentication mechanism is not supported and the
  16879. server supports one or more SASL authentication mechanisms, then
  16880. the SASL mechanisms that both the client and server support are tried
  16881. in order of greatest security to weakest security. Once a SASL
  16882. authentication mechanism is found that both client and server support,
  16883. the credentials are used to authenticate.</para>
  16884. <para>If the server does not support SASL or if no common SASL mechanisms
  16885. can be found, then the <c>USER</c> and <c>PASS</c> commands are used as a
  16886. fallback.</para>
  16887. <note type="tip"><para>To prevent the usage of certain authentication mechanisms,
  16888. simply remove them from the <see cref="P:MailKit.Net.Pop3.Pop3Client.AuthenticationMechanisms"/> hash set
  16889. before calling this method.</para>
  16890. <para>In the case of the APOP authentication mechanism, remove it from the
  16891. <see cref="P:MailKit.Net.Pop3.Pop3Client.Capabilities"/> property instead.</para></note>
  16892. </remarks>
  16893. <returns>An asynchronous task context.</returns>
  16894. <param name="encoding">The text encoding to use for the user's credentials.</param>
  16895. <param name="credentials">The user's credentials.</param>
  16896. <param name="cancellationToken">The cancellation token.</param>
  16897. <exception cref="T:System.ArgumentNullException">
  16898. <para><paramref name="encoding"/> is <c>null</c>.</para>
  16899. <para>-or-</para>
  16900. <para><paramref name="credentials"/> is <c>null</c>.</para>
  16901. </exception>
  16902. <exception cref="T:System.ObjectDisposedException">
  16903. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  16904. </exception>
  16905. <exception cref="T:MailKit.ServiceNotConnectedException">
  16906. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  16907. </exception>
  16908. <exception cref="T:System.InvalidOperationException">
  16909. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is already authenticated.
  16910. </exception>
  16911. <exception cref="T:System.OperationCanceledException">
  16912. The operation was canceled via the cancellation token.
  16913. </exception>
  16914. <exception cref="T:MailKit.Security.AuthenticationException">
  16915. Authentication using the supplied credentials has failed.
  16916. </exception>
  16917. <exception cref="T:MailKit.Security.SaslException">
  16918. A SASL authentication error occurred.
  16919. </exception>
  16920. <exception cref="T:System.IO.IOException">
  16921. An I/O error occurred.
  16922. </exception>
  16923. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  16924. A POP3 command failed.
  16925. </exception>
  16926. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  16927. An POP3 protocol error occurred.
  16928. </exception>
  16929. </member>
  16930. <member name="M:MailKit.Net.Pop3.Pop3Client.ConnectAsync(System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  16931. <summary>
  16932. Asynchronously establish a connection to the specified POP3 or POP3/S server.
  16933. </summary>
  16934. <remarks>
  16935. <para>Establishes a connection to the specified POP3 or POP3/S server.</para>
  16936. <para>If the <paramref name="port"/> has a value of <c>0</c>, then the
  16937. <paramref name="options"/> parameter is used to determine the default port to
  16938. connect to. The default port used with <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>
  16939. is <c>995</c>. All other values will use a default port of <c>110</c>.</para>
  16940. <para>If the <paramref name="options"/> has a value of
  16941. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  16942. to determine the default security options. If the <paramref name="port"/> has a value
  16943. of <c>995</c>, then the default options used will be
  16944. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  16945. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  16946. <para>Once a connection is established, properties such as
  16947. <see cref="P:MailKit.Net.Pop3.Pop3Client.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Pop3.Pop3Client.Capabilities"/> will be
  16948. populated.</para>
  16949. </remarks>
  16950. <example>
  16951. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadMessages"/>
  16952. </example>
  16953. <returns>An asynchronous task context.</returns>
  16954. <param name="host">The host name to connect to.</param>
  16955. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  16956. <param name="options">The secure socket options to when connecting.</param>
  16957. <param name="cancellationToken">The cancellation token.</param>
  16958. <exception cref="T:System.ArgumentNullException">
  16959. <paramref name="host"/> is <c>null</c>.
  16960. </exception>
  16961. <exception cref="T:System.ArgumentOutOfRangeException">
  16962. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  16963. </exception>
  16964. <exception cref="T:System.ArgumentException">
  16965. The <paramref name="host"/> is a zero-length string.
  16966. </exception>
  16967. <exception cref="T:System.ObjectDisposedException">
  16968. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  16969. </exception>
  16970. <exception cref="T:System.InvalidOperationException">
  16971. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is already connected.
  16972. </exception>
  16973. <exception cref="T:System.OperationCanceledException">
  16974. The operation was canceled via the cancellation token.
  16975. </exception>
  16976. <exception cref="T:System.NotSupportedException">
  16977. <paramref name="options"/> was set to
  16978. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  16979. and the POP3 server does not support the STLS extension.
  16980. </exception>
  16981. <exception cref="T:System.Net.Sockets.SocketException">
  16982. A socket error occurred trying to connect to the remote host.
  16983. </exception>
  16984. <exception cref="T:MailKit.Security.SslHandshakeException">
  16985. An error occurred during the SSL/TLS negotiations.
  16986. </exception>
  16987. <exception cref="T:System.IO.IOException">
  16988. An I/O error occurred.
  16989. </exception>
  16990. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  16991. A POP3 command failed.
  16992. </exception>
  16993. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  16994. A POP3 protocol error occurred.
  16995. </exception>
  16996. </member>
  16997. <member name="M:MailKit.Net.Pop3.Pop3Client.ConnectAsync(System.Net.Sockets.Socket,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  16998. <summary>
  16999. Asynchronously establish a connection to the specified POP3 or POP3/S server using the provided socket.
  17000. </summary>
  17001. <remarks>
  17002. <para>Establishes a connection to the specified POP3 or POP3/S server using
  17003. the provided socket.</para>
  17004. <para>If the <paramref name="options"/> has a value of
  17005. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  17006. to determine the default security options. If the <paramref name="port"/> has a value
  17007. of <c>995</c>, then the default options used will be
  17008. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  17009. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  17010. <para>Once a connection is established, properties such as
  17011. <see cref="P:MailKit.Net.Pop3.Pop3Client.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Pop3.Pop3Client.Capabilities"/> will be
  17012. populated.</para>
  17013. <note type="info">With the exception of using the <paramref name="port"/> to determine the
  17014. default <see cref="T:MailKit.Security.SecureSocketOptions"/> to use when the <paramref name="options"/> value
  17015. is <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, the <paramref name="host"/> and
  17016. <paramref name="port"/> parameters are only used for logging purposes.</note>
  17017. </remarks>
  17018. <returns>An asynchronous task context.</returns>
  17019. <param name="socket">The socket to use for the connection.</param>
  17020. <param name="host">The host name to connect to.</param>
  17021. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  17022. <param name="options">The secure socket options to when connecting.</param>
  17023. <param name="cancellationToken">The cancellation token.</param>
  17024. <exception cref="T:System.ArgumentNullException">
  17025. <para><paramref name="socket"/> is <c>null</c>.</para>
  17026. <para>-or-</para>
  17027. <para><paramref name="host"/> is <c>null</c>.</para>
  17028. </exception>
  17029. <exception cref="T:System.ArgumentOutOfRangeException">
  17030. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  17031. </exception>
  17032. <exception cref="T:System.ArgumentException">
  17033. <para><paramref name="socket"/> is not connected.</para>
  17034. <para>-or-</para>
  17035. <para>The <paramref name="host"/> is a zero-length string.</para>
  17036. </exception>
  17037. <exception cref="T:System.ObjectDisposedException">
  17038. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17039. </exception>
  17040. <exception cref="T:System.InvalidOperationException">
  17041. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is already connected.
  17042. </exception>
  17043. <exception cref="T:System.NotSupportedException">
  17044. <paramref name="options"/> was set to
  17045. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  17046. and the POP3 server does not support the STLS extension.
  17047. </exception>
  17048. <exception cref="T:System.OperationCanceledException">
  17049. The operation was canceled via the cancellation token.
  17050. </exception>
  17051. <exception cref="T:MailKit.Security.SslHandshakeException">
  17052. An error occurred during the SSL/TLS negotiations.
  17053. </exception>
  17054. <exception cref="T:System.IO.IOException">
  17055. An I/O error occurred.
  17056. </exception>
  17057. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17058. A POP3 command failed.
  17059. </exception>
  17060. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17061. A POP3 protocol error occurred.
  17062. </exception>
  17063. </member>
  17064. <member name="M:MailKit.Net.Pop3.Pop3Client.ConnectAsync(System.IO.Stream,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  17065. <summary>
  17066. Asynchronously establish a connection to the specified POP3 or POP3/S server using the provided stream.
  17067. </summary>
  17068. <remarks>
  17069. <para>Establishes a connection to the specified POP3 or POP3/S server using
  17070. the provided stream.</para>
  17071. <para>If the <paramref name="options"/> has a value of
  17072. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  17073. to determine the default security options. If the <paramref name="port"/> has a value
  17074. of <c>995</c>, then the default options used will be
  17075. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  17076. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  17077. <para>Once a connection is established, properties such as
  17078. <see cref="P:MailKit.Net.Pop3.Pop3Client.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Pop3.Pop3Client.Capabilities"/> will be
  17079. populated.</para>
  17080. <note type="info">With the exception of using the <paramref name="port"/> to determine the
  17081. default <see cref="T:MailKit.Security.SecureSocketOptions"/> to use when the <paramref name="options"/> value
  17082. is <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, the <paramref name="host"/> and
  17083. <paramref name="port"/> parameters are only used for logging purposes.</note>
  17084. </remarks>
  17085. <returns>An asynchronous task context.</returns>
  17086. <param name="stream">The socket to use for the connection.</param>
  17087. <param name="host">The host name to connect to.</param>
  17088. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  17089. <param name="options">The secure socket options to when connecting.</param>
  17090. <param name="cancellationToken">The cancellation token.</param>
  17091. <exception cref="T:System.ArgumentNullException">
  17092. <para><paramref name="stream"/> is <c>null</c>.</para>
  17093. <para>-or-</para>
  17094. <para><paramref name="host"/> is <c>null</c>.</para>
  17095. </exception>
  17096. <exception cref="T:System.ArgumentOutOfRangeException">
  17097. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  17098. </exception>
  17099. <exception cref="T:System.ArgumentException">
  17100. The <paramref name="host"/> is a zero-length string.
  17101. </exception>
  17102. <exception cref="T:System.ObjectDisposedException">
  17103. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17104. </exception>
  17105. <exception cref="T:System.InvalidOperationException">
  17106. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is already connected.
  17107. </exception>
  17108. <exception cref="T:System.NotSupportedException">
  17109. <paramref name="options"/> was set to
  17110. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  17111. and the POP3 server does not support the STLS extension.
  17112. </exception>
  17113. <exception cref="T:System.OperationCanceledException">
  17114. The operation was canceled via the cancellation token.
  17115. </exception>
  17116. <exception cref="T:MailKit.Security.SslHandshakeException">
  17117. An error occurred during the SSL/TLS negotiations.
  17118. </exception>
  17119. <exception cref="T:System.IO.IOException">
  17120. An I/O error occurred.
  17121. </exception>
  17122. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17123. A POP3 command failed.
  17124. </exception>
  17125. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17126. A POP3 protocol error occurred.
  17127. </exception>
  17128. </member>
  17129. <member name="M:MailKit.Net.Pop3.Pop3Client.DisconnectAsync(System.Boolean,System.Threading.CancellationToken)">
  17130. <summary>
  17131. Asynchronously disconnect the service.
  17132. </summary>
  17133. <remarks>
  17134. If <paramref name="quit"/> is <c>true</c>, a <c>QUIT</c> command will be issued in order to disconnect cleanly.
  17135. </remarks>
  17136. <example>
  17137. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadMessages"/>
  17138. </example>
  17139. <returns>An asynchronous task context.</returns>
  17140. <param name="quit">If set to <c>true</c>, a <c>QUIT</c> command will be issued in order to disconnect cleanly.</param>
  17141. <param name="cancellationToken">The cancellation token.</param>
  17142. <exception cref="T:System.ObjectDisposedException">
  17143. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17144. </exception>
  17145. </member>
  17146. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageCountAsync(System.Threading.CancellationToken)">
  17147. <summary>
  17148. Asynchronously get the message count.
  17149. </summary>
  17150. <remarks>
  17151. Asynchronously gets the message count.
  17152. </remarks>
  17153. <returns>The message count.</returns>
  17154. <param name="cancellationToken">The cancellation token.</param>
  17155. <exception cref="T:System.ObjectDisposedException">
  17156. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17157. </exception>
  17158. <exception cref="T:MailKit.ServiceNotConnectedException">
  17159. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17160. </exception>
  17161. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17162. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17163. </exception>
  17164. <exception cref="T:System.OperationCanceledException">
  17165. The operation was canceled via the cancellation token.
  17166. </exception>
  17167. <exception cref="T:System.IO.IOException">
  17168. An I/O error occurred.
  17169. </exception>
  17170. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17171. The POP3 command failed.
  17172. </exception>
  17173. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17174. A POP3 protocol error occurred.
  17175. </exception>
  17176. </member>
  17177. <member name="M:MailKit.Net.Pop3.Pop3Client.NoOpAsync(System.Threading.CancellationToken)">
  17178. <summary>
  17179. Ping the POP3 server to keep the connection alive.
  17180. </summary>
  17181. <remarks>Mail servers, if left idle for too long, will automatically drop the connection.</remarks>
  17182. <returns>An asynchronous task context.</returns>
  17183. <param name="cancellationToken">The cancellation token.</param>
  17184. <exception cref="T:System.ObjectDisposedException">
  17185. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17186. </exception>
  17187. <exception cref="T:MailKit.ServiceNotConnectedException">
  17188. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17189. </exception>
  17190. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17191. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17192. </exception>
  17193. <exception cref="T:System.OperationCanceledException">
  17194. The operation was canceled via the cancellation token.
  17195. </exception>
  17196. <exception cref="T:System.IO.IOException">
  17197. An I/O error occurred.
  17198. </exception>
  17199. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17200. The POP3 command failed.
  17201. </exception>
  17202. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17203. A POP3 protocol error occurred.
  17204. </exception>
  17205. </member>
  17206. <member name="M:MailKit.Net.Pop3.Pop3Client.EnableUTF8Async(System.Threading.CancellationToken)">
  17207. <summary>
  17208. Asynchronously enable UTF8 mode.
  17209. </summary>
  17210. <remarks>
  17211. The POP3 UTF8 extension allows the client to retrieve messages in the UTF-8 encoding and
  17212. may also allow the user to authenticate using a UTF-8 encoded username or password.
  17213. </remarks>
  17214. <returns>An asynchronous task context.</returns>
  17215. <param name="cancellationToken">The cancellation token.</param>
  17216. <exception cref="T:System.ObjectDisposedException">
  17217. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17218. </exception>
  17219. <exception cref="T:MailKit.ServiceNotConnectedException">
  17220. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17221. </exception>
  17222. <exception cref="T:System.InvalidOperationException">
  17223. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has already been authenticated.
  17224. </exception>
  17225. <exception cref="T:System.OperationCanceledException">
  17226. The operation was canceled via the cancellation token.
  17227. </exception>
  17228. <exception cref="T:System.NotSupportedException">
  17229. The POP3 server does not support the UTF8 extension.
  17230. </exception>
  17231. <exception cref="T:System.IO.IOException">
  17232. An I/O error occurred.
  17233. </exception>
  17234. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17235. The POP3 command failed.
  17236. </exception>
  17237. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17238. A POP3 protocol error occurred.
  17239. </exception>
  17240. </member>
  17241. <member name="M:MailKit.Net.Pop3.Pop3Client.GetLanguagesAsync(System.Threading.CancellationToken)">
  17242. <summary>
  17243. Asynchronously get the list of languages supported by the POP3 server.
  17244. </summary>
  17245. <remarks>
  17246. If the POP3 server supports the LANG extension, it is possible to
  17247. query the list of languages supported by the POP3 server that can
  17248. be used for error messages.
  17249. </remarks>
  17250. <returns>The supported languages.</returns>
  17251. <param name="cancellationToken">The cancellation token.</param>
  17252. <exception cref="T:System.ObjectDisposedException">
  17253. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17254. </exception>
  17255. <exception cref="T:MailKit.ServiceNotConnectedException">
  17256. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17257. </exception>
  17258. <exception cref="T:System.OperationCanceledException">
  17259. The operation was canceled via the cancellation token.
  17260. </exception>
  17261. <exception cref="T:System.NotSupportedException">
  17262. The POP3 server does not support the LANG extension.
  17263. </exception>
  17264. <exception cref="T:System.IO.IOException">
  17265. An I/O error occurred.
  17266. </exception>
  17267. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17268. The POP3 command failed.
  17269. </exception>
  17270. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17271. A POP3 protocol error occurred.
  17272. </exception>
  17273. </member>
  17274. <member name="M:MailKit.Net.Pop3.Pop3Client.SetLanguageAsync(System.String,System.Threading.CancellationToken)">
  17275. <summary>
  17276. Asynchronously set the language used by the POP3 server for error messages.
  17277. </summary>
  17278. <remarks>
  17279. If the POP3 server supports the LANG extension, it is possible to
  17280. set the language used by the POP3 server for error messages.
  17281. </remarks>
  17282. <returns>An asynchronous task context.</returns>
  17283. <param name="lang">The language code.</param>
  17284. <param name="cancellationToken">The cancellation token.</param>
  17285. <exception cref="T:System.ArgumentNullException">
  17286. <paramref name="lang"/> is <c>null</c>.
  17287. </exception>
  17288. <exception cref="T:System.ArgumentException">
  17289. <paramref name="lang"/> is empty.
  17290. </exception>
  17291. <exception cref="T:System.ObjectDisposedException">
  17292. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17293. </exception>
  17294. <exception cref="T:MailKit.ServiceNotConnectedException">
  17295. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17296. </exception>
  17297. <exception cref="T:System.OperationCanceledException">
  17298. The operation was canceled via the cancellation token.
  17299. </exception>
  17300. <exception cref="T:System.NotSupportedException">
  17301. The POP3 server does not support the LANG extension.
  17302. </exception>
  17303. <exception cref="T:System.IO.IOException">
  17304. An I/O error occurred.
  17305. </exception>
  17306. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17307. The POP3 command failed.
  17308. </exception>
  17309. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17310. A POP3 protocol error occurred.
  17311. </exception>
  17312. </member>
  17313. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageUidAsync(System.Int32,System.Threading.CancellationToken)">
  17314. <summary>
  17315. Asynchronously get the UID of the message at the specified index.
  17316. </summary>
  17317. <remarks>
  17318. <para>Gets the UID of the message at the specified index.</para>
  17319. <note type="warning">Not all servers support UIDs, so you should first check the
  17320. <see cref="P:MailKit.Net.Pop3.Pop3Client.Capabilities"/> property for the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.UIDL"/> flag or
  17321. the <see cref="P:MailKit.Net.Pop3.Pop3Client.SupportsUids"/> convenience property.</note>
  17322. </remarks>
  17323. <returns>The message UID.</returns>
  17324. <param name="index">The message index.</param>
  17325. <param name="cancellationToken">The cancellation token.</param>
  17326. <exception cref="T:System.ArgumentOutOfRangeException">
  17327. <paramref name="index"/> is not a valid message index.
  17328. </exception>
  17329. <exception cref="T:System.ObjectDisposedException">
  17330. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17331. </exception>
  17332. <exception cref="T:MailKit.ServiceNotConnectedException">
  17333. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17334. </exception>
  17335. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17336. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17337. </exception>
  17338. <exception cref="T:System.NotSupportedException">
  17339. The POP3 server does not support the UIDL extension.
  17340. </exception>
  17341. <exception cref="T:System.OperationCanceledException">
  17342. The operation was canceled via the cancellation token.
  17343. </exception>
  17344. <exception cref="T:System.IO.IOException">
  17345. An I/O error occurred.
  17346. </exception>
  17347. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17348. The POP3 command failed.
  17349. </exception>
  17350. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17351. A POP3 protocol error occurred.
  17352. </exception>
  17353. </member>
  17354. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageUidsAsync(System.Threading.CancellationToken)">
  17355. <summary>
  17356. Asynchronously get the full list of available message UIDs.
  17357. </summary>
  17358. <remarks>
  17359. <para>Gets the full list of available message UIDs.</para>
  17360. <note type="warning">Not all servers support UIDs, so you should first check the
  17361. <see cref="P:MailKit.Net.Pop3.Pop3Client.Capabilities"/> property for the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.UIDL"/> flag or
  17362. the <see cref="P:MailKit.Net.Pop3.Pop3Client.SupportsUids"/> convenience property.</note>
  17363. </remarks>
  17364. <example>
  17365. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadNewMessages"/>
  17366. </example>
  17367. <returns>The message uids.</returns>
  17368. <param name="cancellationToken">The cancellation token.</param>
  17369. <exception cref="T:System.ObjectDisposedException">
  17370. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17371. </exception>
  17372. <exception cref="T:MailKit.ServiceNotConnectedException">
  17373. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17374. </exception>
  17375. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17376. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17377. </exception>
  17378. <exception cref="T:System.NotSupportedException">
  17379. The POP3 server does not support the UIDL extension.
  17380. </exception>
  17381. <exception cref="T:System.OperationCanceledException">
  17382. The operation was canceled via the cancellation token.
  17383. </exception>
  17384. <exception cref="T:System.IO.IOException">
  17385. An I/O error occurred.
  17386. </exception>
  17387. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17388. The POP3 command failed.
  17389. </exception>
  17390. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17391. A POP3 protocol error occurred.
  17392. </exception>
  17393. </member>
  17394. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageSizeAsync(System.Int32,System.Threading.CancellationToken)">
  17395. <summary>
  17396. Asynchronously get the size of the specified message, in bytes.
  17397. </summary>
  17398. <remarks>
  17399. Gets the size of the specified message, in bytes.
  17400. </remarks>
  17401. <returns>The message size, in bytes.</returns>
  17402. <param name="index">The index of the message.</param>
  17403. <param name="cancellationToken">The cancellation token.</param>
  17404. <exception cref="T:System.ArgumentOutOfRangeException">
  17405. <paramref name="index"/> is not a valid message index.
  17406. </exception>
  17407. <exception cref="T:System.ObjectDisposedException">
  17408. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17409. </exception>
  17410. <exception cref="T:MailKit.ServiceNotConnectedException">
  17411. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17412. </exception>
  17413. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17414. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17415. </exception>
  17416. <exception cref="T:System.OperationCanceledException">
  17417. The operation was canceled via the cancellation token.
  17418. </exception>
  17419. <exception cref="T:System.IO.IOException">
  17420. An I/O error occurred.
  17421. </exception>
  17422. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17423. The POP3 command failed.
  17424. </exception>
  17425. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17426. A POP3 protocol error occurred.
  17427. </exception>
  17428. </member>
  17429. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageSizesAsync(System.Threading.CancellationToken)">
  17430. <summary>
  17431. Asynchronously get the sizes for all available messages, in bytes.
  17432. </summary>
  17433. <remarks>
  17434. Gets the sizes for all available messages, in bytes.
  17435. </remarks>
  17436. <returns>The message sizes, in bytes.</returns>
  17437. <param name="cancellationToken">The cancellation token.</param>
  17438. <exception cref="T:System.ObjectDisposedException">
  17439. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17440. </exception>
  17441. <exception cref="T:MailKit.ServiceNotConnectedException">
  17442. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17443. </exception>
  17444. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17445. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17446. </exception>
  17447. <exception cref="T:System.OperationCanceledException">
  17448. The operation was canceled via the cancellation token.
  17449. </exception>
  17450. <exception cref="T:System.IO.IOException">
  17451. An I/O error occurred.
  17452. </exception>
  17453. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17454. The POP3 command failed.
  17455. </exception>
  17456. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17457. A POP3 protocol error occurred.
  17458. </exception>
  17459. </member>
  17460. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageHeadersAsync(System.Int32,System.Threading.CancellationToken)">
  17461. <summary>
  17462. Asynchronously get the headers for the message at the specified index.
  17463. </summary>
  17464. <remarks>
  17465. Gets the headers for the message at the specified index.
  17466. </remarks>
  17467. <returns>The message headers.</returns>
  17468. <param name="index">The index of the message.</param>
  17469. <param name="cancellationToken">The cancellation token.</param>
  17470. <exception cref="T:System.ArgumentOutOfRangeException">
  17471. <paramref name="index"/> is not a valid message index.
  17472. </exception>
  17473. <exception cref="T:System.ObjectDisposedException">
  17474. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17475. </exception>
  17476. <exception cref="T:MailKit.ServiceNotConnectedException">
  17477. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17478. </exception>
  17479. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17480. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17481. </exception>
  17482. <exception cref="T:System.OperationCanceledException">
  17483. The operation was canceled via the cancellation token.
  17484. </exception>
  17485. <exception cref="T:System.IO.IOException">
  17486. An I/O error occurred.
  17487. </exception>
  17488. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17489. The POP3 command failed.
  17490. </exception>
  17491. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17492. A POP3 protocol error occurred.
  17493. </exception>
  17494. </member>
  17495. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageHeadersAsync(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken)">
  17496. <summary>
  17497. Asynchronously get the headers for the messages at the specified indexes.
  17498. </summary>
  17499. <remarks>
  17500. <para>Gets the headers for the messages at the specified indexes.</para>
  17501. <para>When the POP3 server supports the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.Pipelining"/>
  17502. extension, this method will likely be more efficient than using
  17503. <see cref="M:MailKit.Net.Pop3.Pop3Client.GetMessageHeaders(System.Int32,System.Threading.CancellationToken)"/> for each message because
  17504. it will batch the commands to reduce latency.</para>
  17505. </remarks>
  17506. <returns>The headers for the specified messages.</returns>
  17507. <param name="indexes">The indexes of the messages.</param>
  17508. <param name="cancellationToken">The cancellation token.</param>
  17509. <exception cref="T:System.ArgumentNullException">
  17510. <paramref name="indexes"/> is <c>null</c>.
  17511. </exception>
  17512. <exception cref="T:System.ArgumentException">
  17513. One or more of the <paramref name="indexes"/> are invalid.
  17514. </exception>
  17515. <exception cref="T:System.ObjectDisposedException">
  17516. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17517. </exception>
  17518. <exception cref="T:MailKit.ServiceNotConnectedException">
  17519. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17520. </exception>
  17521. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17522. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17523. </exception>
  17524. <exception cref="T:System.NotSupportedException">
  17525. The POP3 server does not support the UIDL extension.
  17526. </exception>
  17527. <exception cref="T:System.OperationCanceledException">
  17528. The operation was canceled via the cancellation token.
  17529. </exception>
  17530. <exception cref="T:System.IO.IOException">
  17531. An I/O error occurred.
  17532. </exception>
  17533. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17534. The POP3 command failed.
  17535. </exception>
  17536. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17537. A POP3 protocol error occurred.
  17538. </exception>
  17539. </member>
  17540. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageHeadersAsync(System.Int32,System.Int32,System.Threading.CancellationToken)">
  17541. <summary>
  17542. Asynchronously get the headers of the messages within the specified range.
  17543. </summary>
  17544. <remarks>
  17545. <para>Gets the headers of the messages within the specified range.</para>
  17546. <para>When the POP3 server supports the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.Pipelining"/>
  17547. extension, this method will likely be more efficient than using
  17548. <see cref="M:MailKit.Net.Pop3.Pop3Client.GetMessageHeaders(System.Int32,System.Threading.CancellationToken)"/> for each message because
  17549. it will batch the commands to reduce latency.</para>
  17550. </remarks>
  17551. <returns>The headers of the messages within the specified range.</returns>
  17552. <param name="startIndex">The index of the first message to get.</param>
  17553. <param name="count">The number of messages to get.</param>
  17554. <param name="cancellationToken">The cancellation token.</param>
  17555. <exception cref="T:System.ArgumentOutOfRangeException">
  17556. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  17557. a valid range of messages.
  17558. </exception>
  17559. <exception cref="T:System.ObjectDisposedException">
  17560. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17561. </exception>
  17562. <exception cref="T:MailKit.ServiceNotConnectedException">
  17563. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17564. </exception>
  17565. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17566. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17567. </exception>
  17568. <exception cref="T:System.NotSupportedException">
  17569. The POP3 server does not support the UIDL extension.
  17570. </exception>
  17571. <exception cref="T:System.OperationCanceledException">
  17572. The operation was canceled via the cancellation token.
  17573. </exception>
  17574. <exception cref="T:System.IO.IOException">
  17575. An I/O error occurred.
  17576. </exception>
  17577. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17578. The POP3 command failed.
  17579. </exception>
  17580. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17581. A POP3 protocol error occurred.
  17582. </exception>
  17583. </member>
  17584. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageAsync(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  17585. <summary>
  17586. Asynchronously get the message at the specified index.
  17587. </summary>
  17588. <remarks>
  17589. Gets the message at the specified index.
  17590. </remarks>
  17591. <example>
  17592. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadMessages"/>
  17593. </example>
  17594. <returns>The message.</returns>
  17595. <param name="index">The index of the message.</param>
  17596. <param name="cancellationToken">The cancellation token.</param>
  17597. <param name="progress">The progress reporting mechanism.</param>
  17598. <exception cref="T:System.ArgumentOutOfRangeException">
  17599. <paramref name="index"/> is not a valid message index.
  17600. </exception>
  17601. <exception cref="T:System.ObjectDisposedException">
  17602. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17603. </exception>
  17604. <exception cref="T:MailKit.ServiceNotConnectedException">
  17605. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17606. </exception>
  17607. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17608. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17609. </exception>
  17610. <exception cref="T:System.OperationCanceledException">
  17611. The operation was canceled via the cancellation token.
  17612. </exception>
  17613. <exception cref="T:System.IO.IOException">
  17614. An I/O error occurred.
  17615. </exception>
  17616. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17617. The POP3 command failed.
  17618. </exception>
  17619. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17620. A POP3 protocol error occurred.
  17621. </exception>
  17622. </member>
  17623. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessagesAsync(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  17624. <summary>
  17625. Asynchronously get the messages at the specified indexes.
  17626. </summary>
  17627. <remarks>
  17628. <para>Gets the messages at the specified indexes.</para>
  17629. <para>When the POP3 server supports the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.Pipelining"/>
  17630. extension, this method will likely be more efficient than using
  17631. <see cref="M:MailKit.Net.Pop3.Pop3Client.GetMessage(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)"/> for each message
  17632. because it will batch the commands to reduce latency.</para>
  17633. </remarks>
  17634. <returns>The messages.</returns>
  17635. <param name="indexes">The indexes of the messages.</param>
  17636. <param name="cancellationToken">The cancellation token.</param>
  17637. <param name="progress">The progress reporting mechanism.</param>
  17638. <exception cref="T:System.ArgumentNullException">
  17639. <paramref name="indexes"/> is <c>null</c>.
  17640. </exception>
  17641. <exception cref="T:System.ArgumentException">
  17642. One or more of the <paramref name="indexes"/> are invalid.
  17643. </exception>
  17644. <exception cref="T:System.ObjectDisposedException">
  17645. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17646. </exception>
  17647. <exception cref="T:MailKit.ServiceNotConnectedException">
  17648. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17649. </exception>
  17650. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17651. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17652. </exception>
  17653. <exception cref="T:System.NotSupportedException">
  17654. The POP3 server does not support the UIDL extension.
  17655. </exception>
  17656. <exception cref="T:System.OperationCanceledException">
  17657. The operation was canceled via the cancellation token.
  17658. </exception>
  17659. <exception cref="T:System.IO.IOException">
  17660. An I/O error occurred.
  17661. </exception>
  17662. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17663. The POP3 command failed.
  17664. </exception>
  17665. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17666. A POP3 protocol error occurred.
  17667. </exception>
  17668. </member>
  17669. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessagesAsync(System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  17670. <summary>
  17671. Asynchronously get the messages within the specified range.
  17672. </summary>
  17673. <remarks>
  17674. <para>Gets the messages within the specified range.</para>
  17675. <para>When the POP3 server supports the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.Pipelining"/>
  17676. extension, this method will likely be more efficient than using
  17677. <see cref="M:MailKit.Net.Pop3.Pop3Client.GetMessage(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)"/> for each message
  17678. because it will batch the commands to reduce latency.</para>
  17679. </remarks>
  17680. <example>
  17681. <code language="c#" source="Examples\Pop3Examples.cs" region="BatchDownloadMessages"/>
  17682. </example>
  17683. <returns>The messages.</returns>
  17684. <param name="startIndex">The index of the first message to get.</param>
  17685. <param name="count">The number of messages to get.</param>
  17686. <param name="cancellationToken">The cancellation token.</param>
  17687. <param name="progress">The progress reporting mechanism.</param>
  17688. <exception cref="T:System.ArgumentOutOfRangeException">
  17689. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  17690. a valid range of messages.
  17691. </exception>
  17692. <exception cref="T:System.ObjectDisposedException">
  17693. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17694. </exception>
  17695. <exception cref="T:MailKit.ServiceNotConnectedException">
  17696. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17697. </exception>
  17698. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17699. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17700. </exception>
  17701. <exception cref="T:System.NotSupportedException">
  17702. The POP3 server does not support the UIDL extension.
  17703. </exception>
  17704. <exception cref="T:System.OperationCanceledException">
  17705. The operation was canceled via the cancellation token.
  17706. </exception>
  17707. <exception cref="T:System.IO.IOException">
  17708. An I/O error occurred.
  17709. </exception>
  17710. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17711. The POP3 command failed.
  17712. </exception>
  17713. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17714. A POP3 protocol error occurred.
  17715. </exception>
  17716. </member>
  17717. <member name="M:MailKit.Net.Pop3.Pop3Client.GetStreamAsync(System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  17718. <summary>
  17719. Asynchronously get the message or header stream at the specified index.
  17720. </summary>
  17721. <remarks>
  17722. Gets the message or header stream at the specified index.
  17723. </remarks>
  17724. <returns>The message or header stream.</returns>
  17725. <param name="index">The index of the message.</param>
  17726. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  17727. <param name="cancellationToken">The cancellation token.</param>
  17728. <param name="progress">The progress reporting mechanism.</param>
  17729. <exception cref="T:System.ArgumentOutOfRangeException">
  17730. <paramref name="index"/> is not a valid message index.
  17731. </exception>
  17732. <exception cref="T:System.ObjectDisposedException">
  17733. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17734. </exception>
  17735. <exception cref="T:MailKit.ServiceNotConnectedException">
  17736. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17737. </exception>
  17738. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17739. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17740. </exception>
  17741. <exception cref="T:System.OperationCanceledException">
  17742. The operation was canceled via the cancellation token.
  17743. </exception>
  17744. <exception cref="T:System.IO.IOException">
  17745. An I/O error occurred.
  17746. </exception>
  17747. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17748. The POP3 command failed.
  17749. </exception>
  17750. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17751. A POP3 protocol error occurred.
  17752. </exception>
  17753. </member>
  17754. <member name="M:MailKit.Net.Pop3.Pop3Client.GetStreamsAsync(System.Collections.Generic.IList{System.Int32},System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  17755. <summary>
  17756. Asynchronously get the message or header streams at the specified indexes.
  17757. </summary>
  17758. <remarks>
  17759. <para>Get the message or header streams at the specified indexes.</para>
  17760. <para>If the POP3 server supports the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.Pipelining"/>
  17761. extension, this method will likely be more efficient than using
  17762. <see cref="M:MailKit.Net.Pop3.Pop3Client.GetStream(System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)"/> for each message
  17763. because it will batch the commands to reduce latency.</para>
  17764. </remarks>
  17765. <returns>The message or header streams.</returns>
  17766. <param name="indexes">The indexes of the messages.</param>
  17767. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  17768. <param name="cancellationToken">The cancellation token.</param>
  17769. <param name="progress">The progress reporting mechanism.</param>
  17770. <exception cref="T:System.ArgumentNullException">
  17771. <paramref name="indexes"/> is <c>null</c>.
  17772. </exception>
  17773. <exception cref="T:System.ArgumentException">
  17774. One or more of the <paramref name="indexes"/> are invalid.
  17775. </exception>
  17776. <exception cref="T:System.ObjectDisposedException">
  17777. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17778. </exception>
  17779. <exception cref="T:MailKit.ServiceNotConnectedException">
  17780. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17781. </exception>
  17782. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17783. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17784. </exception>
  17785. <exception cref="T:System.NotSupportedException">
  17786. The POP3 server does not support the UIDL extension.
  17787. </exception>
  17788. <exception cref="T:System.OperationCanceledException">
  17789. The operation was canceled via the cancellation token.
  17790. </exception>
  17791. <exception cref="T:System.IO.IOException">
  17792. An I/O error occurred.
  17793. </exception>
  17794. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17795. The POP3 command failed.
  17796. </exception>
  17797. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17798. A POP3 protocol error occurred.
  17799. </exception>
  17800. </member>
  17801. <member name="M:MailKit.Net.Pop3.Pop3Client.GetStreamsAsync(System.Int32,System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  17802. <summary>
  17803. Asynchronously get the message or header streams within the specified range.
  17804. </summary>
  17805. <remarks>
  17806. <para>Gets the message or header streams within the specified range.</para>
  17807. <para>If the POP3 server supports the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.Pipelining"/>
  17808. extension, this method will likely be more efficient than using
  17809. <see cref="M:MailKit.Net.Pop3.Pop3Client.GetStream(System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)"/> for each message
  17810. because it will batch the commands to reduce latency.</para>
  17811. </remarks>
  17812. <returns>The message or header streams.</returns>
  17813. <param name="startIndex">The index of the first stream to get.</param>
  17814. <param name="count">The number of streams to get.</param>
  17815. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  17816. <param name="cancellationToken">The cancellation token.</param>
  17817. <param name="progress">The progress reporting mechanism.</param>
  17818. <exception cref="T:System.ArgumentOutOfRangeException">
  17819. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  17820. a valid range of messages.
  17821. </exception>
  17822. <exception cref="T:System.ObjectDisposedException">
  17823. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17824. </exception>
  17825. <exception cref="T:MailKit.ServiceNotConnectedException">
  17826. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17827. </exception>
  17828. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17829. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17830. </exception>
  17831. <exception cref="T:System.NotSupportedException">
  17832. The POP3 server does not support the UIDL extension.
  17833. </exception>
  17834. <exception cref="T:System.OperationCanceledException">
  17835. The operation was canceled via the cancellation token.
  17836. </exception>
  17837. <exception cref="T:System.IO.IOException">
  17838. An I/O error occurred.
  17839. </exception>
  17840. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17841. The POP3 command failed.
  17842. </exception>
  17843. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17844. A POP3 protocol error occurred.
  17845. </exception>
  17846. </member>
  17847. <member name="M:MailKit.Net.Pop3.Pop3Client.DeleteMessageAsync(System.Int32,System.Threading.CancellationToken)">
  17848. <summary>
  17849. Asynchronously mark the specified message for deletion.
  17850. </summary>
  17851. <remarks>
  17852. Messages marked for deletion are not actually deleted until the session
  17853. is cleanly disconnected
  17854. (see <see cref="M:MailKit.Net.Pop3.Pop3Client.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  17855. </remarks>
  17856. <example>
  17857. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadMessages"/>
  17858. </example>
  17859. <returns>An asynchronous task context.</returns>
  17860. <param name="index">The index of the message.</param>
  17861. <param name="cancellationToken">The cancellation token.</param>
  17862. <exception cref="T:System.ArgumentOutOfRangeException">
  17863. <paramref name="index"/> is not a valid message index.
  17864. </exception>
  17865. <exception cref="T:System.ObjectDisposedException">
  17866. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17867. </exception>
  17868. <exception cref="T:MailKit.ServiceNotConnectedException">
  17869. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17870. </exception>
  17871. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17872. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17873. </exception>
  17874. <exception cref="T:System.OperationCanceledException">
  17875. The operation was canceled via the cancellation token.
  17876. </exception>
  17877. <exception cref="T:System.IO.IOException">
  17878. An I/O error occurred.
  17879. </exception>
  17880. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17881. The POP3 command failed.
  17882. </exception>
  17883. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17884. A POP3 protocol error occurred.
  17885. </exception>
  17886. </member>
  17887. <member name="M:MailKit.Net.Pop3.Pop3Client.DeleteMessagesAsync(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken)">
  17888. <summary>
  17889. Asynchronously mark the specified messages for deletion.
  17890. </summary>
  17891. <remarks>
  17892. Messages marked for deletion are not actually deleted until the session
  17893. is cleanly disconnected
  17894. (see <see cref="M:MailKit.Net.Pop3.Pop3Client.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  17895. </remarks>
  17896. <returns>An asynchronous task context.</returns>
  17897. <param name="indexes">The indexes of the messages.</param>
  17898. <param name="cancellationToken">The cancellation token.</param>
  17899. <exception cref="T:System.ArgumentNullException">
  17900. <paramref name="indexes"/> is <c>null</c>.
  17901. </exception>
  17902. <exception cref="T:System.ArgumentException">
  17903. One or more of the <paramref name="indexes"/> are invalid.
  17904. </exception>
  17905. <exception cref="T:System.ObjectDisposedException">
  17906. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17907. </exception>
  17908. <exception cref="T:MailKit.ServiceNotConnectedException">
  17909. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17910. </exception>
  17911. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17912. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17913. </exception>
  17914. <exception cref="T:System.OperationCanceledException">
  17915. The operation was canceled via the cancellation token.
  17916. </exception>
  17917. <exception cref="T:System.IO.IOException">
  17918. An I/O error occurred.
  17919. </exception>
  17920. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17921. The POP3 command failed.
  17922. </exception>
  17923. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17924. A POP3 protocol error occurred.
  17925. </exception>
  17926. </member>
  17927. <member name="M:MailKit.Net.Pop3.Pop3Client.DeleteMessagesAsync(System.Int32,System.Int32,System.Threading.CancellationToken)">
  17928. <summary>
  17929. Asynchronously mark the specified range of messages for deletion.
  17930. </summary>
  17931. <remarks>
  17932. Messages marked for deletion are not actually deleted until the session
  17933. is cleanly disconnected
  17934. (see <see cref="M:MailKit.Net.Pop3.Pop3Client.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  17935. </remarks>
  17936. <example>
  17937. <code language="c#" source="Examples\Pop3Examples.cs" region="BatchDownloadMessages"/>
  17938. </example>
  17939. <returns>An asynchronous task context.</returns>
  17940. <param name="startIndex">The index of the first message to mark for deletion.</param>
  17941. <param name="count">The number of messages to mark for deletion.</param>
  17942. <param name="cancellationToken">The cancellation token.</param>
  17943. <exception cref="T:System.ArgumentOutOfRangeException">
  17944. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  17945. a valid range of messages.
  17946. </exception>
  17947. <exception cref="T:System.ObjectDisposedException">
  17948. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17949. </exception>
  17950. <exception cref="T:MailKit.ServiceNotConnectedException">
  17951. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17952. </exception>
  17953. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17954. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17955. </exception>
  17956. <exception cref="T:System.OperationCanceledException">
  17957. The operation was canceled via the cancellation token.
  17958. </exception>
  17959. <exception cref="T:System.IO.IOException">
  17960. An I/O error occurred.
  17961. </exception>
  17962. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17963. The POP3 command failed.
  17964. </exception>
  17965. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17966. A POP3 protocol error occurred.
  17967. </exception>
  17968. </member>
  17969. <member name="M:MailKit.Net.Pop3.Pop3Client.DeleteAllMessagesAsync(System.Threading.CancellationToken)">
  17970. <summary>
  17971. Asynchronously mark all messages for deletion.
  17972. </summary>
  17973. <remarks>
  17974. Messages marked for deletion are not actually deleted until the session
  17975. is cleanly disconnected
  17976. (see <see cref="M:MailKit.Net.Pop3.Pop3Client.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  17977. </remarks>
  17978. <returns>An asynchronous task context.</returns>
  17979. <param name="cancellationToken">The cancellation token.</param>
  17980. <exception cref="T:System.ObjectDisposedException">
  17981. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  17982. </exception>
  17983. <exception cref="T:MailKit.ServiceNotConnectedException">
  17984. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  17985. </exception>
  17986. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  17987. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  17988. </exception>
  17989. <exception cref="T:System.OperationCanceledException">
  17990. The operation was canceled via the cancellation token.
  17991. </exception>
  17992. <exception cref="T:System.IO.IOException">
  17993. An I/O error occurred.
  17994. </exception>
  17995. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  17996. The POP3 command failed.
  17997. </exception>
  17998. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  17999. A POP3 protocol error occurred.
  18000. </exception>
  18001. </member>
  18002. <member name="M:MailKit.Net.Pop3.Pop3Client.ResetAsync(System.Threading.CancellationToken)">
  18003. <summary>
  18004. Asynchronously reset the state of all messages marked for deletion.
  18005. </summary>
  18006. <remarks>
  18007. Messages marked for deletion are not actually deleted until the session
  18008. is cleanly disconnected
  18009. (see <see cref="M:MailKit.Net.Pop3.Pop3Client.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  18010. </remarks>
  18011. <returns>An awaitable task.</returns>
  18012. <param name="cancellationToken">The cancellation token.</param>
  18013. <exception cref="T:System.ObjectDisposedException">
  18014. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18015. </exception>
  18016. <exception cref="T:MailKit.ServiceNotConnectedException">
  18017. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18018. </exception>
  18019. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  18020. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  18021. </exception>
  18022. <exception cref="T:System.OperationCanceledException">
  18023. The operation was canceled via the cancellation token.
  18024. </exception>
  18025. <exception cref="T:System.IO.IOException">
  18026. An I/O error occurred.
  18027. </exception>
  18028. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18029. The POP3 command failed.
  18030. </exception>
  18031. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18032. A POP3 protocol error occurred.
  18033. </exception>
  18034. </member>
  18035. <member name="M:MailKit.Net.Pop3.Pop3Client.#ctor(MailKit.IProtocolLogger)">
  18036. <summary>
  18037. Initializes a new instance of the <see cref="T:MailKit.Net.Pop3.Pop3Client"/> class.
  18038. </summary>
  18039. <remarks>
  18040. Before you can retrieve messages with the <see cref="T:MailKit.Net.Pop3.Pop3Client"/>, you must first call
  18041. one of the <a href="Overload_MailKit_Net_Pop3_Pop3Client_Connect.htm">Connect</a> methods
  18042. and authenticate using one of the
  18043. <a href="Overload_MailKit_Net_Pop3_Pop3Client_Authenticate.htm">Authenticate</a> methods.
  18044. </remarks>
  18045. <example>
  18046. <code language="c#" source="Examples\Pop3Examples.cs" region="ProtocolLogger"/>
  18047. </example>
  18048. <param name="protocolLogger">The protocol logger.</param>
  18049. <exception cref="T:System.ArgumentNullException">
  18050. <paramref name="protocolLogger"/> is <c>null</c>.
  18051. </exception>
  18052. </member>
  18053. <member name="M:MailKit.Net.Pop3.Pop3Client.#ctor">
  18054. <summary>
  18055. Initializes a new instance of the <see cref="T:MailKit.Net.Pop3.Pop3Client"/> class.
  18056. </summary>
  18057. <remarks>
  18058. Before you can retrieve messages with the <see cref="T:MailKit.Net.Pop3.Pop3Client"/>, you must first call
  18059. one of the <a href="Overload_MailKit_Net_Pop3_Pop3Client_Connect.htm">Connect</a> methods
  18060. and authenticate using one of the
  18061. <a href="Overload_MailKit_Net_Pop3_Pop3Client_Authenticate.htm">Authenticate</a> methods.
  18062. </remarks>
  18063. </member>
  18064. <member name="P:MailKit.Net.Pop3.Pop3Client.SyncRoot">
  18065. <summary>
  18066. Gets an object that can be used to synchronize access to the POP3 server.
  18067. </summary>
  18068. <remarks>
  18069. <para>Gets an object that can be used to synchronize access to the POP3 server.</para>
  18070. <para>When using the non-Async methods from multiple threads, it is important to lock the
  18071. <see cref="P:MailKit.Net.Pop3.Pop3Client.SyncRoot"/> object for thread safety when using the synchronous methods.</para>
  18072. </remarks>
  18073. <value>The lock object.</value>
  18074. </member>
  18075. <member name="P:MailKit.Net.Pop3.Pop3Client.Protocol">
  18076. <summary>
  18077. Gets the protocol supported by the message service.
  18078. </summary>
  18079. <remarks>
  18080. Gets the protocol supported by the message service.
  18081. </remarks>
  18082. <value>The protocol.</value>
  18083. </member>
  18084. <member name="P:MailKit.Net.Pop3.Pop3Client.Capabilities">
  18085. <summary>
  18086. Gets the capabilities supported by the POP3 server.
  18087. </summary>
  18088. <remarks>
  18089. The capabilities will not be known until a successful connection has been made
  18090. and may change once the client is authenticated.
  18091. </remarks>
  18092. <example>
  18093. <code language="c#" source="Examples\Pop3Examples.cs" region="Capabilities"/>
  18094. </example>
  18095. <value>The capabilities.</value>
  18096. <exception cref="T:System.ArgumentException">
  18097. Capabilities cannot be enabled, they may only be disabled.
  18098. </exception>
  18099. </member>
  18100. <member name="P:MailKit.Net.Pop3.Pop3Client.ExpirePolicy">
  18101. <summary>
  18102. Gets the expiration policy.
  18103. </summary>
  18104. <remarks>
  18105. <para>If the server supports the EXPIRE capability (<see cref="F:MailKit.Net.Pop3.Pop3Capabilities.Expire"/>), the value
  18106. of the <see cref="P:MailKit.Net.Pop3.Pop3Client.ExpirePolicy"/> property will reflect the value advertized by the server.</para>
  18107. <para>A value of <c>-1</c> indicates that messages will never expire.</para>
  18108. <para>A value of <c>0</c> indicates that messages that have been retrieved during the current session
  18109. will be purged immediately after the connection is closed via the <c>QUIT</c> command.</para>
  18110. <para>Values larger than <c>0</c> indicate the minimum number of days that the server will retain
  18111. messages which have been retrieved.</para>
  18112. </remarks>
  18113. <example>
  18114. <code language="c#" source="Examples\Pop3Examples.cs" region="Capabilities"/>
  18115. </example>
  18116. <value>The expiration policy.</value>
  18117. </member>
  18118. <member name="P:MailKit.Net.Pop3.Pop3Client.Implementation">
  18119. <summary>
  18120. Gets the implementation details of the server.
  18121. </summary>
  18122. <remarks>
  18123. If the server advertizes its implementation details, this value will be set to a string containing the
  18124. information details provided by the server.
  18125. </remarks>
  18126. <value>The implementation details.</value>
  18127. </member>
  18128. <member name="P:MailKit.Net.Pop3.Pop3Client.LoginDelay">
  18129. <summary>
  18130. Gets the minimum delay, in milliseconds, between logins.
  18131. </summary>
  18132. <remarks>
  18133. If the server supports the LOGIN-DELAY capability (<see cref="F:MailKit.Net.Pop3.Pop3Capabilities.LoginDelay"/>), this value
  18134. will be set to the minimum number of milliseconds that the client must wait between logins.
  18135. </remarks>
  18136. <example>
  18137. <code language="c#" source="Examples\Pop3Examples.cs" region="Capabilities"/>
  18138. </example>
  18139. <value>The login delay.</value>
  18140. </member>
  18141. <member name="P:MailKit.Net.Pop3.Pop3Client.AuthenticationMechanisms">
  18142. <summary>
  18143. Gets the authentication mechanisms supported by the POP3 server.
  18144. </summary>
  18145. <remarks>
  18146. <para>The authentication mechanisms are queried as part of the
  18147. connection process.</para>
  18148. <para>Servers that do not support the SASL capability will typically
  18149. support either the <c>APOP</c> authentication mechanism
  18150. (<see cref="F:MailKit.Net.Pop3.Pop3Capabilities.Apop"/>) or the ability to login using the
  18151. <c>USER</c> and <c>PASS</c> commands (<see cref="F:MailKit.Net.Pop3.Pop3Capabilities.User"/>).
  18152. </para>
  18153. <note type="tip"><para>To prevent the usage of certain authentication mechanisms,
  18154. simply remove them from the <see cref="P:MailKit.Net.Pop3.Pop3Client.AuthenticationMechanisms"/> hash set
  18155. before authenticating.</para>
  18156. <para>In the case of the APOP authentication mechanism, remove it from the
  18157. <see cref="P:MailKit.Net.Pop3.Pop3Client.Capabilities"/> property instead.</para></note>
  18158. </remarks>
  18159. <example>
  18160. <code language="c#" source="Examples\Pop3Examples.cs" region="Capabilities"/>
  18161. </example>
  18162. <value>The authentication mechanisms.</value>
  18163. </member>
  18164. <member name="P:MailKit.Net.Pop3.Pop3Client.Timeout">
  18165. <summary>
  18166. Gets or sets the timeout for network streaming operations, in milliseconds.
  18167. </summary>
  18168. <remarks>
  18169. Gets or sets the underlying socket stream's <see cref="P:System.IO.Stream.ReadTimeout"/>
  18170. and <see cref="P:System.IO.Stream.WriteTimeout"/> values.
  18171. </remarks>
  18172. <value>The timeout in milliseconds.</value>
  18173. </member>
  18174. <member name="P:MailKit.Net.Pop3.Pop3Client.IsConnected">
  18175. <summary>
  18176. Gets whether or not the client is currently connected to an POP3 server.
  18177. </summary>
  18178. <remarks>
  18179. <para>The <see cref="P:MailKit.Net.Pop3.Pop3Client.IsConnected"/> state is set to <c>true</c> immediately after
  18180. one of the <a href="Overload_MailKit_Net_Pop3_Pop3Client_Connect.htm">Connect</a>
  18181. methods succeeds and is not set back to <c>false</c> until either the client
  18182. is disconnected via <see cref="M:MailKit.Net.Pop3.Pop3Client.Disconnect(System.Boolean,System.Threading.CancellationToken)"/> or until a
  18183. <see cref="T:MailKit.Net.Pop3.Pop3ProtocolException"/> is thrown while attempting to read or write to
  18184. the underlying network socket.</para>
  18185. <para>When an <see cref="T:MailKit.Net.Pop3.Pop3ProtocolException"/> is caught, the connection state of the
  18186. <see cref="T:MailKit.Net.Pop3.Pop3Client"/> should be checked before continuing.</para>
  18187. </remarks>
  18188. <example>
  18189. <code language="c#" source="Examples\Pop3Examples.cs" region="ExceptionHandling"/>
  18190. </example>
  18191. <value><c>true</c> if the client is connected; otherwise, <c>false</c>.</value>
  18192. </member>
  18193. <member name="P:MailKit.Net.Pop3.Pop3Client.IsSecure">
  18194. <summary>
  18195. Get whether or not the connection is secure (typically via SSL or TLS).
  18196. </summary>
  18197. <remarks>
  18198. Gets whether or not the connection is secure (typically via SSL or TLS).
  18199. </remarks>
  18200. <value><c>true</c> if the connection is secure; otherwise, <c>false</c>.</value>
  18201. </member>
  18202. <member name="P:MailKit.Net.Pop3.Pop3Client.IsAuthenticated">
  18203. <summary>
  18204. Get whether or not the client is currently authenticated with the POP3 server.
  18205. </summary>
  18206. <remarks>
  18207. <para>Gets whether or not the client is currently authenticated with the POP3 server.</para>
  18208. <para>To authenticate with the POP3 server, use one of the
  18209. <a href="Overload_MailKit_Net_Pop3_Pop3Client_Authenticate.htm">Authenticate</a> methods.</para>
  18210. </remarks>
  18211. <value><c>true</c> if the client is connected; otherwise, <c>false</c>.</value>
  18212. </member>
  18213. <member name="M:MailKit.Net.Pop3.Pop3Client.Authenticate(MailKit.Security.SaslMechanism,System.Threading.CancellationToken)">
  18214. <summary>
  18215. Authenticate using the specified SASL mechanism.
  18216. </summary>
  18217. <remarks>
  18218. <para>Authenticates using the specified SASL mechanism.</para>
  18219. <para>For a list of available SASL authentication mechanisms supported by the server,
  18220. check the <see cref="P:MailKit.Net.Pop3.Pop3Client.AuthenticationMechanisms"/> property after the service has been
  18221. connected.</para>
  18222. </remarks>
  18223. <param name="mechanism">The SASL mechanism.</param>
  18224. <param name="cancellationToken">The cancellation token.</param>
  18225. <exception cref="T:System.ArgumentNullException">
  18226. <paramref name="mechanism"/> is <c>null</c>.
  18227. </exception>
  18228. <exception cref="T:System.ObjectDisposedException">
  18229. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18230. </exception>
  18231. <exception cref="T:MailKit.ServiceNotConnectedException">
  18232. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18233. </exception>
  18234. <exception cref="T:System.InvalidOperationException">
  18235. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is already authenticated.
  18236. </exception>
  18237. <exception cref="T:System.OperationCanceledException">
  18238. The operation was canceled via the cancellation token.
  18239. </exception>
  18240. <exception cref="T:MailKit.Security.AuthenticationException">
  18241. Authentication using the supplied credentials has failed.
  18242. </exception>
  18243. <exception cref="T:MailKit.Security.SaslException">
  18244. A SASL authentication error occurred.
  18245. </exception>
  18246. <exception cref="T:System.IO.IOException">
  18247. An I/O error occurred.
  18248. </exception>
  18249. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18250. A POP3 command failed.
  18251. </exception>
  18252. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18253. An POP3 protocol error occurred.
  18254. </exception>
  18255. </member>
  18256. <member name="M:MailKit.Net.Pop3.Pop3Client.Authenticate(System.Text.Encoding,System.Net.ICredentials,System.Threading.CancellationToken)">
  18257. <summary>
  18258. Authenticate using the supplied credentials.
  18259. </summary>
  18260. <remarks>
  18261. <para>If the POP3 server supports the APOP authentication mechanism,
  18262. then APOP is used.</para>
  18263. <para>If the APOP authentication mechanism is not supported and the
  18264. server supports one or more SASL authentication mechanisms, then
  18265. the SASL mechanisms that both the client and server support are tried
  18266. in order of greatest security to weakest security. Once a SASL
  18267. authentication mechanism is found that both client and server support,
  18268. the credentials are used to authenticate.</para>
  18269. <para>If the server does not support SASL or if no common SASL mechanisms
  18270. can be found, then the <c>USER</c> and <c>PASS</c> commands are used as a
  18271. fallback.</para>
  18272. <note type="tip"><para>To prevent the usage of certain authentication mechanisms,
  18273. simply remove them from the <see cref="P:MailKit.Net.Pop3.Pop3Client.AuthenticationMechanisms"/> hash set
  18274. before calling this method.</para>
  18275. <para>In the case of the APOP authentication mechanism, remove it from the
  18276. <see cref="P:MailKit.Net.Pop3.Pop3Client.Capabilities"/> property instead.</para></note>
  18277. </remarks>
  18278. <param name="encoding">The text encoding to use for the user's credentials.</param>
  18279. <param name="credentials">The user's credentials.</param>
  18280. <param name="cancellationToken">The cancellation token.</param>
  18281. <exception cref="T:System.ArgumentNullException">
  18282. <para><paramref name="encoding"/> is <c>null</c>.</para>
  18283. <para>-or-</para>
  18284. <para><paramref name="credentials"/> is <c>null</c>.</para>
  18285. </exception>
  18286. <exception cref="T:System.ObjectDisposedException">
  18287. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18288. </exception>
  18289. <exception cref="T:MailKit.ServiceNotConnectedException">
  18290. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18291. </exception>
  18292. <exception cref="T:System.InvalidOperationException">
  18293. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is already authenticated.
  18294. </exception>
  18295. <exception cref="T:System.OperationCanceledException">
  18296. The operation was canceled via the cancellation token.
  18297. </exception>
  18298. <exception cref="T:MailKit.Security.AuthenticationException">
  18299. Authentication using the supplied credentials has failed.
  18300. </exception>
  18301. <exception cref="T:MailKit.Security.SaslException">
  18302. A SASL authentication error occurred.
  18303. </exception>
  18304. <exception cref="T:System.IO.IOException">
  18305. An I/O error occurred.
  18306. </exception>
  18307. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18308. A POP3 command failed.
  18309. </exception>
  18310. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18311. An POP3 protocol error occurred.
  18312. </exception>
  18313. </member>
  18314. <member name="M:MailKit.Net.Pop3.Pop3Client.Connect(System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  18315. <summary>
  18316. Establish a connection to the specified POP3 or POP3/S server.
  18317. </summary>
  18318. <remarks>
  18319. <para>Establishes a connection to the specified POP3 or POP3/S server.</para>
  18320. <para>If the <paramref name="port"/> has a value of <c>0</c>, then the
  18321. <paramref name="options"/> parameter is used to determine the default port to
  18322. connect to. The default port used with <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>
  18323. is <c>995</c>. All other values will use a default port of <c>110</c>.</para>
  18324. <para>If the <paramref name="options"/> has a value of
  18325. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  18326. to determine the default security options. If the <paramref name="port"/> has a value
  18327. of <c>995</c>, then the default options used will be
  18328. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  18329. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  18330. <para>Once a connection is established, properties such as
  18331. <see cref="P:MailKit.Net.Pop3.Pop3Client.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Pop3.Pop3Client.Capabilities"/> will be
  18332. populated.</para>
  18333. </remarks>
  18334. <example>
  18335. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadMessages"/>
  18336. </example>
  18337. <param name="host">The host name to connect to.</param>
  18338. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  18339. <param name="options">The secure socket options to when connecting.</param>
  18340. <param name="cancellationToken">The cancellation token.</param>
  18341. <exception cref="T:System.ArgumentNullException">
  18342. <paramref name="host"/> is <c>null</c>.
  18343. </exception>
  18344. <exception cref="T:System.ArgumentOutOfRangeException">
  18345. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  18346. </exception>
  18347. <exception cref="T:System.ArgumentException">
  18348. The <paramref name="host"/> is a zero-length string.
  18349. </exception>
  18350. <exception cref="T:System.ObjectDisposedException">
  18351. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18352. </exception>
  18353. <exception cref="T:System.InvalidOperationException">
  18354. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is already connected.
  18355. </exception>
  18356. <exception cref="T:System.OperationCanceledException">
  18357. The operation was canceled via the cancellation token.
  18358. </exception>
  18359. <exception cref="T:System.NotSupportedException">
  18360. <paramref name="options"/> was set to
  18361. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  18362. and the POP3 server does not support the STLS extension.
  18363. </exception>
  18364. <exception cref="T:System.Net.Sockets.SocketException">
  18365. A socket error occurred trying to connect to the remote host.
  18366. </exception>
  18367. <exception cref="T:MailKit.Security.SslHandshakeException">
  18368. An error occurred during the SSL/TLS negotiations.
  18369. </exception>
  18370. <exception cref="T:System.IO.IOException">
  18371. An I/O error occurred.
  18372. </exception>
  18373. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18374. A POP3 command failed.
  18375. </exception>
  18376. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18377. A POP3 protocol error occurred.
  18378. </exception>
  18379. </member>
  18380. <member name="M:MailKit.Net.Pop3.Pop3Client.Connect(System.Net.Sockets.Socket,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  18381. <summary>
  18382. Establish a connection to the specified POP3 or POP3/S server using the provided socket.
  18383. </summary>
  18384. <remarks>
  18385. <para>Establishes a connection to the specified POP3 or POP3/S server using
  18386. the provided socket.</para>
  18387. <para>If the <paramref name="options"/> has a value of
  18388. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  18389. to determine the default security options. If the <paramref name="port"/> has a value
  18390. of <c>995</c>, then the default options used will be
  18391. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  18392. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  18393. <para>Once a connection is established, properties such as
  18394. <see cref="P:MailKit.Net.Pop3.Pop3Client.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Pop3.Pop3Client.Capabilities"/> will be
  18395. populated.</para>
  18396. <note type="info">With the exception of using the <paramref name="port"/> to determine the
  18397. default <see cref="T:MailKit.Security.SecureSocketOptions"/> to use when the <paramref name="options"/> value
  18398. is <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, the <paramref name="host"/> and
  18399. <paramref name="port"/> parameters are only used for logging purposes.</note>
  18400. </remarks>
  18401. <param name="socket">The socket to use for the connection.</param>
  18402. <param name="host">The host name to connect to.</param>
  18403. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  18404. <param name="options">The secure socket options to when connecting.</param>
  18405. <param name="cancellationToken">The cancellation token.</param>
  18406. <exception cref="T:System.ArgumentNullException">
  18407. <para><paramref name="socket"/> is <c>null</c>.</para>
  18408. <para>-or-</para>
  18409. <para><paramref name="host"/> is <c>null</c>.</para>
  18410. </exception>
  18411. <exception cref="T:System.ArgumentOutOfRangeException">
  18412. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  18413. </exception>
  18414. <exception cref="T:System.ArgumentException">
  18415. <para><paramref name="socket"/> is not connected.</para>
  18416. <para>-or-</para>
  18417. <para>The <paramref name="host"/> is a zero-length string.</para>
  18418. </exception>
  18419. <exception cref="T:System.ObjectDisposedException">
  18420. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18421. </exception>
  18422. <exception cref="T:System.InvalidOperationException">
  18423. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is already connected.
  18424. </exception>
  18425. <exception cref="T:System.NotSupportedException">
  18426. <paramref name="options"/> was set to
  18427. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  18428. and the POP3 server does not support the STLS extension.
  18429. </exception>
  18430. <exception cref="T:System.OperationCanceledException">
  18431. The operation was canceled via the cancellation token.
  18432. </exception>
  18433. <exception cref="T:MailKit.Security.SslHandshakeException">
  18434. An error occurred during the SSL/TLS negotiations.
  18435. </exception>
  18436. <exception cref="T:System.IO.IOException">
  18437. An I/O error occurred.
  18438. </exception>
  18439. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18440. A POP3 command failed.
  18441. </exception>
  18442. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18443. A POP3 protocol error occurred.
  18444. </exception>
  18445. </member>
  18446. <member name="M:MailKit.Net.Pop3.Pop3Client.Connect(System.IO.Stream,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  18447. <summary>
  18448. Establish a connection to the specified POP3 or POP3/S server using the provided stream.
  18449. </summary>
  18450. <remarks>
  18451. <para>Establishes a connection to the specified POP3 or POP3/S server using
  18452. the provided stream.</para>
  18453. <para>If the <paramref name="options"/> has a value of
  18454. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  18455. to determine the default security options. If the <paramref name="port"/> has a value
  18456. of <c>995</c>, then the default options used will be
  18457. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  18458. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  18459. <para>Once a connection is established, properties such as
  18460. <see cref="P:MailKit.Net.Pop3.Pop3Client.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Pop3.Pop3Client.Capabilities"/> will be
  18461. populated.</para>
  18462. <note type="info">With the exception of using the <paramref name="port"/> to determine the
  18463. default <see cref="T:MailKit.Security.SecureSocketOptions"/> to use when the <paramref name="options"/> value
  18464. is <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, the <paramref name="host"/> and
  18465. <paramref name="port"/> parameters are only used for logging purposes.</note>
  18466. </remarks>
  18467. <param name="stream">The stream to use for the connection.</param>
  18468. <param name="host">The host name to connect to.</param>
  18469. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  18470. <param name="options">The secure socket options to when connecting.</param>
  18471. <param name="cancellationToken">The cancellation token.</param>
  18472. <exception cref="T:System.ArgumentNullException">
  18473. <para><paramref name="stream"/> is <c>null</c>.</para>
  18474. <para>-or-</para>
  18475. <para><paramref name="host"/> is <c>null</c>.</para>
  18476. </exception>
  18477. <exception cref="T:System.ArgumentOutOfRangeException">
  18478. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  18479. </exception>
  18480. <exception cref="T:System.ArgumentException">
  18481. The <paramref name="host"/> is a zero-length string.
  18482. </exception>
  18483. <exception cref="T:System.ObjectDisposedException">
  18484. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18485. </exception>
  18486. <exception cref="T:System.InvalidOperationException">
  18487. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is already connected.
  18488. </exception>
  18489. <exception cref="T:System.NotSupportedException">
  18490. <paramref name="options"/> was set to
  18491. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  18492. and the POP3 server does not support the STLS extension.
  18493. </exception>
  18494. <exception cref="T:System.OperationCanceledException">
  18495. The operation was canceled via the cancellation token.
  18496. </exception>
  18497. <exception cref="T:MailKit.Security.SslHandshakeException">
  18498. An error occurred during the SSL/TLS negotiations.
  18499. </exception>
  18500. <exception cref="T:System.IO.IOException">
  18501. An I/O error occurred.
  18502. </exception>
  18503. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18504. A POP3 command failed.
  18505. </exception>
  18506. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18507. A POP3 protocol error occurred.
  18508. </exception>
  18509. </member>
  18510. <member name="M:MailKit.Net.Pop3.Pop3Client.Disconnect(System.Boolean,System.Threading.CancellationToken)">
  18511. <summary>
  18512. Disconnect the service.
  18513. </summary>
  18514. <remarks>
  18515. If <paramref name="quit"/> is <c>true</c>, a <c>QUIT</c> command will be issued in order to disconnect cleanly.
  18516. </remarks>
  18517. <example>
  18518. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadMessages"/>
  18519. </example>
  18520. <param name="quit">If set to <c>true</c>, a <c>QUIT</c> command will be issued in order to disconnect cleanly.</param>
  18521. <param name="cancellationToken">The cancellation token.</param>
  18522. <exception cref="T:System.ObjectDisposedException">
  18523. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18524. </exception>
  18525. </member>
  18526. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageCount(System.Threading.CancellationToken)">
  18527. <summary>
  18528. Get the message count.
  18529. </summary>
  18530. <remarks>
  18531. Gets the message count.
  18532. </remarks>
  18533. <returns>The message count.</returns>
  18534. <param name="cancellationToken">The cancellation token.</param>
  18535. <exception cref="T:System.ObjectDisposedException">
  18536. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18537. </exception>
  18538. <exception cref="T:MailKit.ServiceNotConnectedException">
  18539. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18540. </exception>
  18541. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  18542. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  18543. </exception>
  18544. <exception cref="T:System.OperationCanceledException">
  18545. The operation was canceled via the cancellation token.
  18546. </exception>
  18547. <exception cref="T:System.IO.IOException">
  18548. An I/O error occurred.
  18549. </exception>
  18550. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18551. The POP3 command failed.
  18552. </exception>
  18553. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18554. A POP3 protocol error occurred.
  18555. </exception>
  18556. </member>
  18557. <member name="M:MailKit.Net.Pop3.Pop3Client.NoOp(System.Threading.CancellationToken)">
  18558. <summary>
  18559. Ping the POP3 server to keep the connection alive.
  18560. </summary>
  18561. <remarks>Mail servers, if left idle for too long, will automatically drop the connection.</remarks>
  18562. <param name="cancellationToken">The cancellation token.</param>
  18563. <exception cref="T:System.ObjectDisposedException">
  18564. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18565. </exception>
  18566. <exception cref="T:MailKit.ServiceNotConnectedException">
  18567. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18568. </exception>
  18569. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  18570. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  18571. </exception>
  18572. <exception cref="T:System.OperationCanceledException">
  18573. The operation was canceled via the cancellation token.
  18574. </exception>
  18575. <exception cref="T:System.IO.IOException">
  18576. An I/O error occurred.
  18577. </exception>
  18578. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18579. The POP3 command failed.
  18580. </exception>
  18581. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18582. A POP3 protocol error occurred.
  18583. </exception>
  18584. </member>
  18585. <member name="M:MailKit.Net.Pop3.Pop3Client.EnableUTF8(System.Threading.CancellationToken)">
  18586. <summary>
  18587. Enable UTF8 mode.
  18588. </summary>
  18589. <remarks>
  18590. The POP3 UTF8 extension allows the client to retrieve messages in the UTF-8 encoding and
  18591. may also allow the user to authenticate using a UTF-8 encoded username or password.
  18592. </remarks>
  18593. <param name="cancellationToken">The cancellation token.</param>
  18594. <exception cref="T:System.ObjectDisposedException">
  18595. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18596. </exception>
  18597. <exception cref="T:MailKit.ServiceNotConnectedException">
  18598. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18599. </exception>
  18600. <exception cref="T:System.InvalidOperationException">
  18601. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has already been authenticated.
  18602. </exception>
  18603. <exception cref="T:System.OperationCanceledException">
  18604. The operation was canceled via the cancellation token.
  18605. </exception>
  18606. <exception cref="T:System.NotSupportedException">
  18607. The POP3 server does not support the UTF8 extension.
  18608. </exception>
  18609. <exception cref="T:System.IO.IOException">
  18610. An I/O error occurred.
  18611. </exception>
  18612. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18613. The POP3 command failed.
  18614. </exception>
  18615. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18616. A POP3 protocol error occurred.
  18617. </exception>
  18618. </member>
  18619. <member name="M:MailKit.Net.Pop3.Pop3Client.GetLanguages(System.Threading.CancellationToken)">
  18620. <summary>
  18621. Get the list of languages supported by the POP3 server.
  18622. </summary>
  18623. <remarks>
  18624. If the POP3 server supports the LANG extension, it is possible to
  18625. query the list of languages supported by the POP3 server that can
  18626. be used for error messages.
  18627. </remarks>
  18628. <returns>The supported languages.</returns>
  18629. <param name="cancellationToken">The cancellation token.</param>
  18630. <exception cref="T:System.ObjectDisposedException">
  18631. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18632. </exception>
  18633. <exception cref="T:MailKit.ServiceNotConnectedException">
  18634. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18635. </exception>
  18636. <exception cref="T:System.OperationCanceledException">
  18637. The operation was canceled via the cancellation token.
  18638. </exception>
  18639. <exception cref="T:System.NotSupportedException">
  18640. The POP3 server does not support the LANG extension.
  18641. </exception>
  18642. <exception cref="T:System.IO.IOException">
  18643. An I/O error occurred.
  18644. </exception>
  18645. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18646. The POP3 command failed.
  18647. </exception>
  18648. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18649. A POP3 protocol error occurred.
  18650. </exception>
  18651. </member>
  18652. <member name="M:MailKit.Net.Pop3.Pop3Client.SetLanguage(System.String,System.Threading.CancellationToken)">
  18653. <summary>
  18654. Set the language used by the POP3 server for error messages.
  18655. </summary>
  18656. <remarks>
  18657. If the POP3 server supports the LANG extension, it is possible to
  18658. set the language used by the POP3 server for error messages.
  18659. </remarks>
  18660. <param name="lang">The language code.</param>
  18661. <param name="cancellationToken">The cancellation token.</param>
  18662. <exception cref="T:System.ArgumentNullException">
  18663. <paramref name="lang"/> is <c>null</c>.
  18664. </exception>
  18665. <exception cref="T:System.ArgumentException">
  18666. <paramref name="lang"/> is empty.
  18667. </exception>
  18668. <exception cref="T:System.ObjectDisposedException">
  18669. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18670. </exception>
  18671. <exception cref="T:MailKit.ServiceNotConnectedException">
  18672. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18673. </exception>
  18674. <exception cref="T:System.OperationCanceledException">
  18675. The operation was canceled via the cancellation token.
  18676. </exception>
  18677. <exception cref="T:System.NotSupportedException">
  18678. The POP3 server does not support the LANG extension.
  18679. </exception>
  18680. <exception cref="T:System.IO.IOException">
  18681. An I/O error occurred.
  18682. </exception>
  18683. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18684. The POP3 command failed.
  18685. </exception>
  18686. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18687. A POP3 protocol error occurred.
  18688. </exception>
  18689. </member>
  18690. <member name="P:MailKit.Net.Pop3.Pop3Client.Count">
  18691. <summary>
  18692. Get the number of messages available in the message spool.
  18693. </summary>
  18694. <remarks>
  18695. <para>Gets the number of messages available on the POP3 server.</para>
  18696. <para>Once authenticated, the <see cref="P:MailKit.Net.Pop3.Pop3Client.Count"/> property will be set
  18697. to the number of available messages on the POP3 server.</para>
  18698. </remarks>
  18699. <example>
  18700. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadMessages"/>
  18701. </example>
  18702. <value>The message count.</value>
  18703. <exception cref="T:System.ObjectDisposedException">
  18704. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18705. </exception>
  18706. <exception cref="T:MailKit.ServiceNotConnectedException">
  18707. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18708. </exception>
  18709. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  18710. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  18711. </exception>
  18712. </member>
  18713. <member name="P:MailKit.Net.Pop3.Pop3Client.SupportsUids">
  18714. <summary>
  18715. Gets whether or not the <see cref="T:MailKit.Net.Pop3.Pop3Client"/> supports referencing messages by UIDs.
  18716. </summary>
  18717. <remarks>
  18718. <para>Not all servers support referencing messages by UID, so this property should
  18719. be checked before using <see cref="M:MailKit.Net.Pop3.Pop3Client.GetMessageUid(System.Int32,System.Threading.CancellationToken)"/>
  18720. and <see cref="M:MailKit.Net.Pop3.Pop3Client.GetMessageUids(System.Threading.CancellationToken)"/>.</para>
  18721. <para>If the server does not support UIDs, then all methods that take UID arguments
  18722. along with <see cref="M:MailKit.Net.Pop3.Pop3Client.GetMessageUid(System.Int32,System.Threading.CancellationToken)"/> and
  18723. <see cref="M:MailKit.Net.Pop3.Pop3Client.GetMessageUids(System.Threading.CancellationToken)"/> will fail.</para>
  18724. </remarks>
  18725. <value><c>true</c> if supports UIDs; otherwise, <c>false</c>.</value>
  18726. <exception cref="T:System.ObjectDisposedException">
  18727. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18728. </exception>
  18729. <exception cref="T:MailKit.ServiceNotConnectedException">
  18730. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18731. </exception>
  18732. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  18733. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  18734. </exception>
  18735. </member>
  18736. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageUid(System.Int32,System.Threading.CancellationToken)">
  18737. <summary>
  18738. Get the UID of the message at the specified index.
  18739. </summary>
  18740. <remarks>
  18741. <para>Gets the UID of the message at the specified index.</para>
  18742. <note type="warning">Not all servers support UIDs, so you should first check the
  18743. <see cref="P:MailKit.Net.Pop3.Pop3Client.Capabilities"/> property for the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.UIDL"/> flag or
  18744. the <see cref="P:MailKit.Net.Pop3.Pop3Client.SupportsUids"/> convenience property.</note>
  18745. </remarks>
  18746. <returns>The message UID.</returns>
  18747. <param name="index">The message index.</param>
  18748. <param name="cancellationToken">The cancellation token.</param>
  18749. <exception cref="T:System.ArgumentOutOfRangeException">
  18750. <paramref name="index"/> is not a valid message index.
  18751. </exception>
  18752. <exception cref="T:System.ObjectDisposedException">
  18753. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18754. </exception>
  18755. <exception cref="T:MailKit.ServiceNotConnectedException">
  18756. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18757. </exception>
  18758. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  18759. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  18760. </exception>
  18761. <exception cref="T:System.NotSupportedException">
  18762. The POP3 server does not support the UIDL extension.
  18763. </exception>
  18764. <exception cref="T:System.OperationCanceledException">
  18765. The operation was canceled via the cancellation token.
  18766. </exception>
  18767. <exception cref="T:System.IO.IOException">
  18768. An I/O error occurred.
  18769. </exception>
  18770. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18771. The POP3 command failed.
  18772. </exception>
  18773. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18774. A POP3 protocol error occurred.
  18775. </exception>
  18776. </member>
  18777. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageUids(System.Threading.CancellationToken)">
  18778. <summary>
  18779. Get the full list of available message UIDs.
  18780. </summary>
  18781. <remarks>
  18782. <para>Gets the full list of available message UIDs.</para>
  18783. <note type="warning">Not all servers support UIDs, so you should first check the
  18784. <see cref="P:MailKit.Net.Pop3.Pop3Client.Capabilities"/> property for the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.UIDL"/> flag or
  18785. the <see cref="P:MailKit.Net.Pop3.Pop3Client.SupportsUids"/> convenience property.</note>
  18786. </remarks>
  18787. <example>
  18788. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadNewMessages"/>
  18789. </example>
  18790. <returns>The message uids.</returns>
  18791. <param name="cancellationToken">The cancellation token.</param>
  18792. <exception cref="T:System.ObjectDisposedException">
  18793. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18794. </exception>
  18795. <exception cref="T:MailKit.ServiceNotConnectedException">
  18796. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18797. </exception>
  18798. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  18799. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  18800. </exception>
  18801. <exception cref="T:System.NotSupportedException">
  18802. The POP3 server does not support the UIDL extension.
  18803. </exception>
  18804. <exception cref="T:System.OperationCanceledException">
  18805. The operation was canceled via the cancellation token.
  18806. </exception>
  18807. <exception cref="T:System.IO.IOException">
  18808. An I/O error occurred.
  18809. </exception>
  18810. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18811. The POP3 command failed.
  18812. </exception>
  18813. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18814. A POP3 protocol error occurred.
  18815. </exception>
  18816. </member>
  18817. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageSize(System.Int32,System.Threading.CancellationToken)">
  18818. <summary>
  18819. Get the size of the specified message, in bytes.
  18820. </summary>
  18821. <remarks>
  18822. Gets the size of the specified message, in bytes.
  18823. </remarks>
  18824. <returns>The message size, in bytes.</returns>
  18825. <param name="index">The index of the message.</param>
  18826. <param name="cancellationToken">The cancellation token.</param>
  18827. <exception cref="T:System.ArgumentOutOfRangeException">
  18828. <paramref name="index"/> is not a valid message index.
  18829. </exception>
  18830. <exception cref="T:System.ObjectDisposedException">
  18831. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18832. </exception>
  18833. <exception cref="T:MailKit.ServiceNotConnectedException">
  18834. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18835. </exception>
  18836. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  18837. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  18838. </exception>
  18839. <exception cref="T:System.OperationCanceledException">
  18840. The operation was canceled via the cancellation token.
  18841. </exception>
  18842. <exception cref="T:System.IO.IOException">
  18843. An I/O error occurred.
  18844. </exception>
  18845. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18846. The POP3 command failed.
  18847. </exception>
  18848. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18849. A POP3 protocol error occurred.
  18850. </exception>
  18851. </member>
  18852. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageSizes(System.Threading.CancellationToken)">
  18853. <summary>
  18854. Get the sizes for all available messages, in bytes.
  18855. </summary>
  18856. <remarks>
  18857. Gets the sizes for all available messages, in bytes.
  18858. </remarks>
  18859. <returns>The message sizes, in bytes.</returns>
  18860. <param name="cancellationToken">The cancellation token.</param>
  18861. <exception cref="T:System.ObjectDisposedException">
  18862. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18863. </exception>
  18864. <exception cref="T:MailKit.ServiceNotConnectedException">
  18865. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18866. </exception>
  18867. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  18868. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  18869. </exception>
  18870. <exception cref="T:System.OperationCanceledException">
  18871. The operation was canceled via the cancellation token.
  18872. </exception>
  18873. <exception cref="T:System.IO.IOException">
  18874. An I/O error occurred.
  18875. </exception>
  18876. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18877. The POP3 command failed.
  18878. </exception>
  18879. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18880. A POP3 protocol error occurred.
  18881. </exception>
  18882. </member>
  18883. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageHeaders(System.Int32,System.Threading.CancellationToken)">
  18884. <summary>
  18885. Get the headers for the message at the specified index.
  18886. </summary>
  18887. <remarks>
  18888. Gets the headers for the message at the specified index.
  18889. </remarks>
  18890. <returns>The message headers.</returns>
  18891. <param name="index">The index of the message.</param>
  18892. <param name="cancellationToken">The cancellation token.</param>
  18893. <exception cref="T:System.ArgumentOutOfRangeException">
  18894. <paramref name="index"/> is not a valid message index.
  18895. </exception>
  18896. <exception cref="T:System.ObjectDisposedException">
  18897. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18898. </exception>
  18899. <exception cref="T:MailKit.ServiceNotConnectedException">
  18900. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18901. </exception>
  18902. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  18903. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  18904. </exception>
  18905. <exception cref="T:System.OperationCanceledException">
  18906. The operation was canceled via the cancellation token.
  18907. </exception>
  18908. <exception cref="T:System.IO.IOException">
  18909. An I/O error occurred.
  18910. </exception>
  18911. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18912. The POP3 command failed.
  18913. </exception>
  18914. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18915. A POP3 protocol error occurred.
  18916. </exception>
  18917. </member>
  18918. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageHeaders(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken)">
  18919. <summary>
  18920. Get the headers for the messages at the specified indexes.
  18921. </summary>
  18922. <remarks>
  18923. <para>Gets the headers for the messages at the specified indexes.</para>
  18924. <para>When the POP3 server supports the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.Pipelining"/>
  18925. extension, this method will likely be more efficient than using
  18926. <see cref="M:MailKit.Net.Pop3.Pop3Client.GetMessageHeaders(System.Int32,System.Threading.CancellationToken)"/> for each message because
  18927. it will batch the commands to reduce latency.</para>
  18928. </remarks>
  18929. <returns>The headers for the specified messages.</returns>
  18930. <param name="indexes">The indexes of the messages.</param>
  18931. <param name="cancellationToken">The cancellation token.</param>
  18932. <exception cref="T:System.ArgumentNullException">
  18933. <paramref name="indexes"/> is <c>null</c>.
  18934. </exception>
  18935. <exception cref="T:System.ArgumentException">
  18936. One or more of the <paramref name="indexes"/> are invalid.
  18937. </exception>
  18938. <exception cref="T:System.ObjectDisposedException">
  18939. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18940. </exception>
  18941. <exception cref="T:MailKit.ServiceNotConnectedException">
  18942. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18943. </exception>
  18944. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  18945. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  18946. </exception>
  18947. <exception cref="T:System.NotSupportedException">
  18948. The POP3 server does not support the UIDL extension.
  18949. </exception>
  18950. <exception cref="T:System.OperationCanceledException">
  18951. The operation was canceled via the cancellation token.
  18952. </exception>
  18953. <exception cref="T:System.IO.IOException">
  18954. An I/O error occurred.
  18955. </exception>
  18956. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  18957. The POP3 command failed.
  18958. </exception>
  18959. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  18960. A POP3 protocol error occurred.
  18961. </exception>
  18962. </member>
  18963. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessageHeaders(System.Int32,System.Int32,System.Threading.CancellationToken)">
  18964. <summary>
  18965. Get the headers of the messages within the specified range.
  18966. </summary>
  18967. <remarks>
  18968. <para>Gets the headers of the messages within the specified range.</para>
  18969. <para>When the POP3 server supports the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.Pipelining"/>
  18970. extension, this method will likely be more efficient than using
  18971. <see cref="M:MailKit.Net.Pop3.Pop3Client.GetMessageHeaders(System.Int32,System.Threading.CancellationToken)"/> for each message because
  18972. it will batch the commands to reduce latency.</para>
  18973. </remarks>
  18974. <returns>The headers of the messages within the specified range.</returns>
  18975. <param name="startIndex">The index of the first message to get.</param>
  18976. <param name="count">The number of messages to get.</param>
  18977. <param name="cancellationToken">The cancellation token.</param>
  18978. <exception cref="T:System.ArgumentOutOfRangeException">
  18979. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  18980. a valid range of messages.
  18981. </exception>
  18982. <exception cref="T:System.ObjectDisposedException">
  18983. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  18984. </exception>
  18985. <exception cref="T:MailKit.ServiceNotConnectedException">
  18986. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  18987. </exception>
  18988. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  18989. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  18990. </exception>
  18991. <exception cref="T:System.NotSupportedException">
  18992. The POP3 server does not support the UIDL extension.
  18993. </exception>
  18994. <exception cref="T:System.OperationCanceledException">
  18995. The operation was canceled via the cancellation token.
  18996. </exception>
  18997. <exception cref="T:System.IO.IOException">
  18998. An I/O error occurred.
  18999. </exception>
  19000. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19001. The POP3 command failed.
  19002. </exception>
  19003. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19004. A POP3 protocol error occurred.
  19005. </exception>
  19006. </member>
  19007. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessage(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  19008. <summary>
  19009. Get the message at the specified index.
  19010. </summary>
  19011. <remarks>
  19012. Gets the message at the specified index.
  19013. </remarks>
  19014. <example>
  19015. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadMessages"/>
  19016. </example>
  19017. <returns>The message.</returns>
  19018. <param name="index">The index of the message.</param>
  19019. <param name="cancellationToken">The cancellation token.</param>
  19020. <param name="progress">The progress reporting mechanism.</param>
  19021. <exception cref="T:System.ArgumentOutOfRangeException">
  19022. <paramref name="index"/> is not a valid message index.
  19023. </exception>
  19024. <exception cref="T:System.ObjectDisposedException">
  19025. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19026. </exception>
  19027. <exception cref="T:MailKit.ServiceNotConnectedException">
  19028. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19029. </exception>
  19030. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  19031. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  19032. </exception>
  19033. <exception cref="T:System.OperationCanceledException">
  19034. The operation was canceled via the cancellation token.
  19035. </exception>
  19036. <exception cref="T:System.IO.IOException">
  19037. An I/O error occurred.
  19038. </exception>
  19039. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19040. The POP3 command failed.
  19041. </exception>
  19042. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19043. A POP3 protocol error occurred.
  19044. </exception>
  19045. </member>
  19046. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessages(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  19047. <summary>
  19048. Get the messages at the specified indexes.
  19049. </summary>
  19050. <remarks>
  19051. <para>Gets the messages at the specified indexes.</para>
  19052. <para>When the POP3 server supports the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.Pipelining"/>
  19053. extension, this method will likely be more efficient than using
  19054. <see cref="M:MailKit.Net.Pop3.Pop3Client.GetMessage(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)"/> for each message
  19055. because it will batch the commands to reduce latency.</para>
  19056. </remarks>
  19057. <returns>The messages.</returns>
  19058. <param name="indexes">The indexes of the messages.</param>
  19059. <param name="cancellationToken">The cancellation token.</param>
  19060. <param name="progress">The progress reporting mechanism.</param>
  19061. <exception cref="T:System.ArgumentNullException">
  19062. <paramref name="indexes"/> is <c>null</c>.
  19063. </exception>
  19064. <exception cref="T:System.ArgumentException">
  19065. One or more of the <paramref name="indexes"/> are invalid.
  19066. </exception>
  19067. <exception cref="T:System.ObjectDisposedException">
  19068. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19069. </exception>
  19070. <exception cref="T:MailKit.ServiceNotConnectedException">
  19071. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19072. </exception>
  19073. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  19074. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  19075. </exception>
  19076. <exception cref="T:System.NotSupportedException">
  19077. The POP3 server does not support the UIDL extension.
  19078. </exception>
  19079. <exception cref="T:System.OperationCanceledException">
  19080. The operation was canceled via the cancellation token.
  19081. </exception>
  19082. <exception cref="T:System.IO.IOException">
  19083. An I/O error occurred.
  19084. </exception>
  19085. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19086. The POP3 command failed.
  19087. </exception>
  19088. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19089. A POP3 protocol error occurred.
  19090. </exception>
  19091. </member>
  19092. <member name="M:MailKit.Net.Pop3.Pop3Client.GetMessages(System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  19093. <summary>
  19094. Get the messages within the specified range.
  19095. </summary>
  19096. <remarks>
  19097. <para>Gets the messages within the specified range.</para>
  19098. <para>When the POP3 server supports the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.Pipelining"/>
  19099. extension, this method will likely be more efficient than using
  19100. <see cref="M:MailKit.Net.Pop3.Pop3Client.GetMessage(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)"/> for each message
  19101. because it will batch the commands to reduce latency.</para>
  19102. </remarks>
  19103. <example>
  19104. <code language="c#" source="Examples\Pop3Examples.cs" region="BatchDownloadMessages"/>
  19105. </example>
  19106. <returns>The messages.</returns>
  19107. <param name="startIndex">The index of the first message to get.</param>
  19108. <param name="count">The number of messages to get.</param>
  19109. <param name="cancellationToken">The cancellation token.</param>
  19110. <param name="progress">The progress reporting mechanism.</param>
  19111. <exception cref="T:System.ArgumentOutOfRangeException">
  19112. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  19113. a valid range of messages.
  19114. </exception>
  19115. <exception cref="T:System.ObjectDisposedException">
  19116. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19117. </exception>
  19118. <exception cref="T:MailKit.ServiceNotConnectedException">
  19119. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19120. </exception>
  19121. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  19122. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  19123. </exception>
  19124. <exception cref="T:System.NotSupportedException">
  19125. The POP3 server does not support the UIDL extension.
  19126. </exception>
  19127. <exception cref="T:System.OperationCanceledException">
  19128. The operation was canceled via the cancellation token.
  19129. </exception>
  19130. <exception cref="T:System.IO.IOException">
  19131. An I/O error occurred.
  19132. </exception>
  19133. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19134. The POP3 command failed.
  19135. </exception>
  19136. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19137. A POP3 protocol error occurred.
  19138. </exception>
  19139. </member>
  19140. <member name="M:MailKit.Net.Pop3.Pop3Client.GetStream(System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  19141. <summary>
  19142. Get the message or header stream at the specified index.
  19143. </summary>
  19144. <remarks>
  19145. Gets the message or header stream at the specified index.
  19146. </remarks>
  19147. <returns>The message or header stream.</returns>
  19148. <param name="index">The index of the message.</param>
  19149. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  19150. <param name="cancellationToken">The cancellation token.</param>
  19151. <param name="progress">The progress reporting mechanism.</param>
  19152. <exception cref="T:System.ArgumentOutOfRangeException">
  19153. <paramref name="index"/> is not a valid message index.
  19154. </exception>
  19155. <exception cref="T:System.ObjectDisposedException">
  19156. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19157. </exception>
  19158. <exception cref="T:MailKit.ServiceNotConnectedException">
  19159. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19160. </exception>
  19161. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  19162. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  19163. </exception>
  19164. <exception cref="T:System.OperationCanceledException">
  19165. The operation was canceled via the cancellation token.
  19166. </exception>
  19167. <exception cref="T:System.IO.IOException">
  19168. An I/O error occurred.
  19169. </exception>
  19170. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19171. The POP3 command failed.
  19172. </exception>
  19173. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19174. A POP3 protocol error occurred.
  19175. </exception>
  19176. </member>
  19177. <member name="M:MailKit.Net.Pop3.Pop3Client.GetStreams(System.Collections.Generic.IList{System.Int32},System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  19178. <summary>
  19179. Get the message or header streams at the specified indexes.
  19180. </summary>
  19181. <remarks>
  19182. <para>Get the message or header streams at the specified indexes.</para>
  19183. <para>If the POP3 server supports the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.Pipelining"/>
  19184. extension, this method will likely be more efficient than using
  19185. <see cref="M:MailKit.Net.Pop3.Pop3Client.GetStream(System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)"/> for each message
  19186. because it will batch the commands to reduce latency.</para>
  19187. </remarks>
  19188. <returns>The message or header streams.</returns>
  19189. <param name="indexes">The indexes of the messages.</param>
  19190. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  19191. <param name="cancellationToken">The cancellation token.</param>
  19192. <param name="progress">The progress reporting mechanism.</param>
  19193. <exception cref="T:System.ArgumentNullException">
  19194. <paramref name="indexes"/> is <c>null</c>.
  19195. </exception>
  19196. <exception cref="T:System.ArgumentException">
  19197. One or more of the <paramref name="indexes"/> are invalid.
  19198. </exception>
  19199. <exception cref="T:System.ObjectDisposedException">
  19200. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19201. </exception>
  19202. <exception cref="T:MailKit.ServiceNotConnectedException">
  19203. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19204. </exception>
  19205. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  19206. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  19207. </exception>
  19208. <exception cref="T:System.NotSupportedException">
  19209. The POP3 server does not support the UIDL extension.
  19210. </exception>
  19211. <exception cref="T:System.OperationCanceledException">
  19212. The operation was canceled via the cancellation token.
  19213. </exception>
  19214. <exception cref="T:System.IO.IOException">
  19215. An I/O error occurred.
  19216. </exception>
  19217. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19218. The POP3 command failed.
  19219. </exception>
  19220. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19221. A POP3 protocol error occurred.
  19222. </exception>
  19223. </member>
  19224. <member name="M:MailKit.Net.Pop3.Pop3Client.GetStreams(System.Int32,System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  19225. <summary>
  19226. Get the message or header streams within the specified range.
  19227. </summary>
  19228. <remarks>
  19229. <para>Gets the message or header streams within the specified range.</para>
  19230. <para>If the POP3 server supports the <see cref="F:MailKit.Net.Pop3.Pop3Capabilities.Pipelining"/>
  19231. extension, this method will likely be more efficient than using
  19232. <see cref="M:MailKit.Net.Pop3.Pop3Client.GetStream(System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)"/> for each message
  19233. because it will batch the commands to reduce latency.</para>
  19234. </remarks>
  19235. <returns>The message or header streams.</returns>
  19236. <param name="startIndex">The index of the first stream to get.</param>
  19237. <param name="count">The number of streams to get.</param>
  19238. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  19239. <param name="cancellationToken">The cancellation token.</param>
  19240. <param name="progress">The progress reporting mechanism.</param>
  19241. <exception cref="T:System.ArgumentOutOfRangeException">
  19242. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  19243. a valid range of messages.
  19244. </exception>
  19245. <exception cref="T:System.ObjectDisposedException">
  19246. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19247. </exception>
  19248. <exception cref="T:MailKit.ServiceNotConnectedException">
  19249. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19250. </exception>
  19251. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  19252. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  19253. </exception>
  19254. <exception cref="T:System.NotSupportedException">
  19255. The POP3 server does not support the UIDL extension.
  19256. </exception>
  19257. <exception cref="T:System.OperationCanceledException">
  19258. The operation was canceled via the cancellation token.
  19259. </exception>
  19260. <exception cref="T:System.IO.IOException">
  19261. An I/O error occurred.
  19262. </exception>
  19263. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19264. The POP3 command failed.
  19265. </exception>
  19266. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19267. A POP3 protocol error occurred.
  19268. </exception>
  19269. </member>
  19270. <member name="M:MailKit.Net.Pop3.Pop3Client.DeleteMessage(System.Int32,System.Threading.CancellationToken)">
  19271. <summary>
  19272. Mark the specified message for deletion.
  19273. </summary>
  19274. <remarks>
  19275. Messages marked for deletion are not actually deleted until the session
  19276. is cleanly disconnected
  19277. (see <see cref="M:MailKit.Net.Pop3.Pop3Client.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  19278. </remarks>
  19279. <example>
  19280. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadMessages"/>
  19281. </example>
  19282. <param name="index">The index of the message.</param>
  19283. <param name="cancellationToken">The cancellation token.</param>
  19284. <exception cref="T:System.ArgumentOutOfRangeException">
  19285. <paramref name="index"/> is not a valid message index.
  19286. </exception>
  19287. <exception cref="T:System.ObjectDisposedException">
  19288. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19289. </exception>
  19290. <exception cref="T:MailKit.ServiceNotConnectedException">
  19291. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19292. </exception>
  19293. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  19294. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  19295. </exception>
  19296. <exception cref="T:System.OperationCanceledException">
  19297. The operation was canceled via the cancellation token.
  19298. </exception>
  19299. <exception cref="T:System.IO.IOException">
  19300. An I/O error occurred.
  19301. </exception>
  19302. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19303. The POP3 command failed.
  19304. </exception>
  19305. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19306. A POP3 protocol error occurred.
  19307. </exception>
  19308. </member>
  19309. <member name="M:MailKit.Net.Pop3.Pop3Client.DeleteMessages(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken)">
  19310. <summary>
  19311. Mark the specified messages for deletion.
  19312. </summary>
  19313. <remarks>
  19314. Messages marked for deletion are not actually deleted until the session
  19315. is cleanly disconnected
  19316. (see <see cref="M:MailKit.Net.Pop3.Pop3Client.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  19317. </remarks>
  19318. <param name="indexes">The indexes of the messages.</param>
  19319. <param name="cancellationToken">The cancellation token.</param>
  19320. <exception cref="T:System.ArgumentNullException">
  19321. <paramref name="indexes"/> is <c>null</c>.
  19322. </exception>
  19323. <exception cref="T:System.ArgumentException">
  19324. One or more of the <paramref name="indexes"/> are invalid.
  19325. </exception>
  19326. <exception cref="T:System.ObjectDisposedException">
  19327. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19328. </exception>
  19329. <exception cref="T:MailKit.ServiceNotConnectedException">
  19330. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19331. </exception>
  19332. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  19333. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  19334. </exception>
  19335. <exception cref="T:System.OperationCanceledException">
  19336. The operation was canceled via the cancellation token.
  19337. </exception>
  19338. <exception cref="T:System.IO.IOException">
  19339. An I/O error occurred.
  19340. </exception>
  19341. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19342. The POP3 command failed.
  19343. </exception>
  19344. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19345. A POP3 protocol error occurred.
  19346. </exception>
  19347. </member>
  19348. <member name="M:MailKit.Net.Pop3.Pop3Client.DeleteMessages(System.Int32,System.Int32,System.Threading.CancellationToken)">
  19349. <summary>
  19350. Mark the specified range of messages for deletion.
  19351. </summary>
  19352. <remarks>
  19353. Messages marked for deletion are not actually deleted until the session
  19354. is cleanly disconnected
  19355. (see <see cref="M:MailKit.Net.Pop3.Pop3Client.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  19356. </remarks>
  19357. <example>
  19358. <code language="c#" source="Examples\Pop3Examples.cs" region="BatchDownloadMessages"/>
  19359. </example>
  19360. <param name="startIndex">The index of the first message to mark for deletion.</param>
  19361. <param name="count">The number of messages to mark for deletion.</param>
  19362. <param name="cancellationToken">The cancellation token.</param>
  19363. <exception cref="T:System.ArgumentOutOfRangeException">
  19364. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  19365. a valid range of messages.
  19366. </exception>
  19367. <exception cref="T:System.ObjectDisposedException">
  19368. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19369. </exception>
  19370. <exception cref="T:MailKit.ServiceNotConnectedException">
  19371. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19372. </exception>
  19373. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  19374. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  19375. </exception>
  19376. <exception cref="T:System.OperationCanceledException">
  19377. The operation was canceled via the cancellation token.
  19378. </exception>
  19379. <exception cref="T:System.IO.IOException">
  19380. An I/O error occurred.
  19381. </exception>
  19382. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19383. The POP3 command failed.
  19384. </exception>
  19385. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19386. A POP3 protocol error occurred.
  19387. </exception>
  19388. </member>
  19389. <member name="M:MailKit.Net.Pop3.Pop3Client.DeleteAllMessages(System.Threading.CancellationToken)">
  19390. <summary>
  19391. Mark all messages for deletion.
  19392. </summary>
  19393. <remarks>
  19394. Messages marked for deletion are not actually deleted until the session
  19395. is cleanly disconnected
  19396. (see <see cref="M:MailKit.Net.Pop3.Pop3Client.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  19397. </remarks>
  19398. <param name="cancellationToken">The cancellation token.</param>
  19399. <exception cref="T:System.ObjectDisposedException">
  19400. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19401. </exception>
  19402. <exception cref="T:MailKit.ServiceNotConnectedException">
  19403. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19404. </exception>
  19405. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  19406. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  19407. </exception>
  19408. <exception cref="T:System.OperationCanceledException">
  19409. The operation was canceled via the cancellation token.
  19410. </exception>
  19411. <exception cref="T:System.IO.IOException">
  19412. An I/O error occurred.
  19413. </exception>
  19414. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19415. The POP3 command failed.
  19416. </exception>
  19417. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19418. A POP3 protocol error occurred.
  19419. </exception>
  19420. </member>
  19421. <member name="M:MailKit.Net.Pop3.Pop3Client.Reset(System.Threading.CancellationToken)">
  19422. <summary>
  19423. Reset the state of all messages marked for deletion.
  19424. </summary>
  19425. <remarks>
  19426. Messages marked for deletion are not actually deleted until the session
  19427. is cleanly disconnected
  19428. (see <see cref="M:MailKit.Net.Pop3.Pop3Client.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  19429. </remarks>
  19430. <param name="cancellationToken">The cancellation token.</param>
  19431. <exception cref="T:System.ObjectDisposedException">
  19432. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19433. </exception>
  19434. <exception cref="T:MailKit.ServiceNotConnectedException">
  19435. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19436. </exception>
  19437. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  19438. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  19439. </exception>
  19440. <exception cref="T:System.OperationCanceledException">
  19441. The operation was canceled via the cancellation token.
  19442. </exception>
  19443. <exception cref="T:System.IO.IOException">
  19444. An I/O error occurred.
  19445. </exception>
  19446. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19447. The POP3 command failed.
  19448. </exception>
  19449. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19450. A POP3 protocol error occurred.
  19451. </exception>
  19452. </member>
  19453. <member name="M:MailKit.Net.Pop3.Pop3Client.GetEnumerator">
  19454. <summary>
  19455. Get an enumerator for the messages in the folder.
  19456. </summary>
  19457. <remarks>
  19458. Gets an enumerator for the messages in the folder.
  19459. </remarks>
  19460. <returns>The enumerator.</returns>
  19461. <exception cref="T:System.ObjectDisposedException">
  19462. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19463. </exception>
  19464. <exception cref="T:MailKit.ServiceNotConnectedException">
  19465. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19466. </exception>
  19467. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  19468. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not authenticated.
  19469. </exception>
  19470. <exception cref="T:System.OperationCanceledException">
  19471. The operation was canceled via the cancellation token.
  19472. </exception>
  19473. <exception cref="T:System.IO.IOException">
  19474. An I/O error occurred.
  19475. </exception>
  19476. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19477. A POP3 command failed.
  19478. </exception>
  19479. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19480. A POP3 protocol error occurred.
  19481. </exception>
  19482. </member>
  19483. <member name="M:MailKit.Net.Pop3.Pop3Client.Dispose(System.Boolean)">
  19484. <summary>
  19485. Releases the unmanaged resources used by the <see cref="T:MailKit.Net.Pop3.Pop3Client"/> and
  19486. optionally releases the managed resources.
  19487. </summary>
  19488. <remarks>
  19489. Releases the unmanaged resources used by the <see cref="T:MailKit.Net.Pop3.Pop3Client"/> and
  19490. optionally releases the managed resources.
  19491. </remarks>
  19492. <param name="disposing"><c>true</c> to release both managed and unmanaged resources;
  19493. <c>false</c> to release only the unmanaged resources.</param>
  19494. </member>
  19495. <member name="T:MailKit.Net.Pop3.IPop3Client">
  19496. <summary>
  19497. An interface for a POP3 client.
  19498. </summary>
  19499. <remarks>
  19500. Implemented by <see cref="T:MailKit.Net.Pop3.Pop3Client"/>.
  19501. </remarks>
  19502. </member>
  19503. <member name="P:MailKit.Net.Pop3.IPop3Client.Capabilities">
  19504. <summary>
  19505. Gets the capabilities supported by the POP3 server.
  19506. </summary>
  19507. <remarks>
  19508. The capabilities will not be known until a successful connection has been made
  19509. and may change once the client is authenticated.
  19510. </remarks>
  19511. <example>
  19512. <code language="c#" source="Examples\Pop3Examples.cs" region="Capabilities"/>
  19513. </example>
  19514. <value>The capabilities.</value>
  19515. <exception cref="T:System.ArgumentException">
  19516. Capabilities cannot be enabled, they may only be disabled.
  19517. </exception>
  19518. </member>
  19519. <member name="P:MailKit.Net.Pop3.IPop3Client.ExpirePolicy">
  19520. <summary>
  19521. Gets the expiration policy.
  19522. </summary>
  19523. <remarks>
  19524. <para>If the server supports the EXPIRE capability (<see cref="F:MailKit.Net.Pop3.Pop3Capabilities.Expire"/>), the value
  19525. of the <see cref="P:MailKit.Net.Pop3.IPop3Client.ExpirePolicy"/> property will reflect the value advertized by the server.</para>
  19526. <para>A value of <c>-1</c> indicates that messages will never expire.</para>
  19527. <para>A value of <c>0</c> indicates that messages that have been retrieved during the current session
  19528. will be purged immediately after the connection is closed via the <c>QUIT</c> command.</para>
  19529. <para>Values larger than <c>0</c> indicate the minimum number of days that the server will retain
  19530. messages which have been retrieved.</para>
  19531. </remarks>
  19532. <example>
  19533. <code language="c#" source="Examples\Pop3Examples.cs" region="Capabilities"/>
  19534. </example>
  19535. <value>The expiration policy.</value>
  19536. </member>
  19537. <member name="P:MailKit.Net.Pop3.IPop3Client.Implementation">
  19538. <summary>
  19539. Gets the implementation details of the server.
  19540. </summary>
  19541. <remarks>
  19542. If the server advertizes its implementation details, this value will be set to a string containing the
  19543. information details provided by the server.
  19544. </remarks>
  19545. <value>The implementation details.</value>
  19546. </member>
  19547. <member name="P:MailKit.Net.Pop3.IPop3Client.LoginDelay">
  19548. <summary>
  19549. Gets the minimum delay, in milliseconds, between logins.
  19550. </summary>
  19551. <remarks>
  19552. If the server supports the LOGIN-DELAY capability (<see cref="F:MailKit.Net.Pop3.Pop3Capabilities.LoginDelay"/>), this value
  19553. will be set to the minimum number of milliseconds that the client must wait between logins.
  19554. </remarks>
  19555. <example>
  19556. <code language="c#" source="Examples\Pop3Examples.cs" region="Capabilities"/>
  19557. </example>
  19558. <value>The login delay.</value>
  19559. </member>
  19560. <member name="M:MailKit.Net.Pop3.IPop3Client.EnableUTF8(System.Threading.CancellationToken)">
  19561. <summary>
  19562. Enable UTF8 mode.
  19563. </summary>
  19564. <remarks>
  19565. The POP3 UTF8 extension allows the client to retrieve messages in the UTF-8 encoding and
  19566. may also allow the user to authenticate using a UTF-8 encoded username or password.
  19567. </remarks>
  19568. <param name="cancellationToken">The cancellation token.</param>
  19569. <exception cref="T:System.ObjectDisposedException">
  19570. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19571. </exception>
  19572. <exception cref="T:MailKit.ServiceNotConnectedException">
  19573. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19574. </exception>
  19575. <exception cref="T:System.InvalidOperationException">
  19576. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has already been authenticated.
  19577. </exception>
  19578. <exception cref="T:System.OperationCanceledException">
  19579. The operation was canceled via the cancellation token.
  19580. </exception>
  19581. <exception cref="T:System.NotSupportedException">
  19582. The POP3 server does not support the UTF8 extension.
  19583. </exception>
  19584. <exception cref="T:System.IO.IOException">
  19585. An I/O error occurred.
  19586. </exception>
  19587. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19588. The POP3 command failed.
  19589. </exception>
  19590. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19591. A POP3 protocol error occurred.
  19592. </exception>
  19593. </member>
  19594. <member name="M:MailKit.Net.Pop3.IPop3Client.EnableUTF8Async(System.Threading.CancellationToken)">
  19595. <summary>
  19596. Asynchronously enable UTF8 mode.
  19597. </summary>
  19598. <remarks>
  19599. The POP3 UTF8 extension allows the client to retrieve messages in the UTF-8 encoding and
  19600. may also allow the user to authenticate using a UTF-8 encoded username or password.
  19601. </remarks>
  19602. <returns>An asynchronous task context.</returns>
  19603. <param name="cancellationToken">The cancellation token.</param>
  19604. <exception cref="T:System.ObjectDisposedException">
  19605. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19606. </exception>
  19607. <exception cref="T:MailKit.ServiceNotConnectedException">
  19608. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19609. </exception>
  19610. <exception cref="T:System.InvalidOperationException">
  19611. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has already been authenticated.
  19612. </exception>
  19613. <exception cref="T:System.OperationCanceledException">
  19614. The operation was canceled via the cancellation token.
  19615. </exception>
  19616. <exception cref="T:System.NotSupportedException">
  19617. The POP3 server does not support the UTF8 extension.
  19618. </exception>
  19619. <exception cref="T:System.IO.IOException">
  19620. An I/O error occurred.
  19621. </exception>
  19622. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19623. The POP3 command failed.
  19624. </exception>
  19625. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19626. A POP3 protocol error occurred.
  19627. </exception>
  19628. </member>
  19629. <member name="M:MailKit.Net.Pop3.IPop3Client.GetLanguages(System.Threading.CancellationToken)">
  19630. <summary>
  19631. Get the list of languages supported by the POP3 server.
  19632. </summary>
  19633. <remarks>
  19634. If the POP3 server supports the LANG extension, it is possible to
  19635. query the list of languages supported by the POP3 server that can
  19636. be used for error messages.
  19637. </remarks>
  19638. <returns>The supported languages.</returns>
  19639. <param name="cancellationToken">The cancellation token.</param>
  19640. <exception cref="T:System.ObjectDisposedException">
  19641. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19642. </exception>
  19643. <exception cref="T:MailKit.ServiceNotConnectedException">
  19644. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19645. </exception>
  19646. <exception cref="T:System.OperationCanceledException">
  19647. The operation was canceled via the cancellation token.
  19648. </exception>
  19649. <exception cref="T:System.NotSupportedException">
  19650. The POP3 server does not support the LANG extension.
  19651. </exception>
  19652. <exception cref="T:System.IO.IOException">
  19653. An I/O error occurred.
  19654. </exception>
  19655. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19656. The POP3 command failed.
  19657. </exception>
  19658. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19659. A POP3 protocol error occurred.
  19660. </exception>
  19661. </member>
  19662. <member name="M:MailKit.Net.Pop3.IPop3Client.GetLanguagesAsync(System.Threading.CancellationToken)">
  19663. <summary>
  19664. Asynchronously get the list of languages supported by the POP3 server.
  19665. </summary>
  19666. <remarks>
  19667. If the POP3 server supports the LANG extension, it is possible to
  19668. query the list of languages supported by the POP3 server that can
  19669. be used for error messages.
  19670. </remarks>
  19671. <returns>The supported languages.</returns>
  19672. <param name="cancellationToken">The cancellation token.</param>
  19673. <exception cref="T:System.ObjectDisposedException">
  19674. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19675. </exception>
  19676. <exception cref="T:MailKit.ServiceNotConnectedException">
  19677. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19678. </exception>
  19679. <exception cref="T:System.OperationCanceledException">
  19680. The operation was canceled via the cancellation token.
  19681. </exception>
  19682. <exception cref="T:System.NotSupportedException">
  19683. The POP3 server does not support the LANG extension.
  19684. </exception>
  19685. <exception cref="T:System.IO.IOException">
  19686. An I/O error occurred.
  19687. </exception>
  19688. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19689. The POP3 command failed.
  19690. </exception>
  19691. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19692. A POP3 protocol error occurred.
  19693. </exception>
  19694. </member>
  19695. <member name="M:MailKit.Net.Pop3.IPop3Client.SetLanguage(System.String,System.Threading.CancellationToken)">
  19696. <summary>
  19697. Set the language used by the POP3 server for error messages.
  19698. </summary>
  19699. <remarks>
  19700. If the POP3 server supports the LANG extension, it is possible to
  19701. set the language used by the POP3 server for error messages.
  19702. </remarks>
  19703. <param name="lang">The language code.</param>
  19704. <param name="cancellationToken">The cancellation token.</param>
  19705. <exception cref="T:System.ArgumentNullException">
  19706. <paramref name="lang"/> is <c>null</c>.
  19707. </exception>
  19708. <exception cref="T:System.ArgumentException">
  19709. <paramref name="lang"/> is empty.
  19710. </exception>
  19711. <exception cref="T:System.ObjectDisposedException">
  19712. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19713. </exception>
  19714. <exception cref="T:MailKit.ServiceNotConnectedException">
  19715. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19716. </exception>
  19717. <exception cref="T:System.OperationCanceledException">
  19718. The operation was canceled via the cancellation token.
  19719. </exception>
  19720. <exception cref="T:System.NotSupportedException">
  19721. The POP3 server does not support the LANG extension.
  19722. </exception>
  19723. <exception cref="T:System.IO.IOException">
  19724. An I/O error occurred.
  19725. </exception>
  19726. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19727. The POP3 command failed.
  19728. </exception>
  19729. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19730. A POP3 protocol error occurred.
  19731. </exception>
  19732. </member>
  19733. <member name="M:MailKit.Net.Pop3.IPop3Client.SetLanguageAsync(System.String,System.Threading.CancellationToken)">
  19734. <summary>
  19735. Asynchronously set the language used by the POP3 server for error messages.
  19736. </summary>
  19737. <remarks>
  19738. If the POP3 server supports the LANG extension, it is possible to
  19739. set the language used by the POP3 server for error messages.
  19740. </remarks>
  19741. <returns>An asynchronous task context.</returns>
  19742. <param name="lang">The language code.</param>
  19743. <param name="cancellationToken">The cancellation token.</param>
  19744. <exception cref="T:System.ArgumentNullException">
  19745. <paramref name="lang"/> is <c>null</c>.
  19746. </exception>
  19747. <exception cref="T:System.ArgumentException">
  19748. <paramref name="lang"/> is empty.
  19749. </exception>
  19750. <exception cref="T:System.ObjectDisposedException">
  19751. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> has been disposed.
  19752. </exception>
  19753. <exception cref="T:MailKit.ServiceNotConnectedException">
  19754. The <see cref="T:MailKit.Net.Pop3.Pop3Client"/> is not connected.
  19755. </exception>
  19756. <exception cref="T:System.OperationCanceledException">
  19757. The operation was canceled via the cancellation token.
  19758. </exception>
  19759. <exception cref="T:System.NotSupportedException">
  19760. The POP3 server does not support the LANG extension.
  19761. </exception>
  19762. <exception cref="T:System.IO.IOException">
  19763. An I/O error occurred.
  19764. </exception>
  19765. <exception cref="T:MailKit.Net.Pop3.Pop3CommandException">
  19766. The POP3 command failed.
  19767. </exception>
  19768. <exception cref="T:MailKit.Net.Pop3.Pop3ProtocolException">
  19769. A POP3 protocol error occurred.
  19770. </exception>
  19771. </member>
  19772. <member name="T:MailKit.Net.Pop3.Pop3Capabilities">
  19773. <summary>
  19774. Capabilities supported by a POP3 server.
  19775. </summary>
  19776. <remarks>
  19777. Capabilities are read as part of the response to the <c>CAPA</c> command that
  19778. is issued during the connection and authentication phases of the
  19779. <see cref="T:MailKit.Net.Pop3.Pop3Client"/>.
  19780. </remarks>
  19781. <example>
  19782. <code language="c#" source="Examples\Pop3Examples.cs" region="Capabilities"/>
  19783. </example>
  19784. </member>
  19785. <member name="F:MailKit.Net.Pop3.Pop3Capabilities.None">
  19786. <summary>
  19787. The server does not support any additional extensions.
  19788. </summary>
  19789. </member>
  19790. <member name="F:MailKit.Net.Pop3.Pop3Capabilities.Apop">
  19791. <summary>
  19792. The server supports <a href="https://tools.ietf.org/html/rfc1939#page-15">APOP</a>
  19793. authentication.
  19794. </summary>
  19795. </member>
  19796. <member name="F:MailKit.Net.Pop3.Pop3Capabilities.Expire">
  19797. <summary>
  19798. The server supports the <a href="https://tools.ietf.org/html/rfc2449">EXPIRE</a> extension
  19799. and defines the expiration policy for messages (see <see cref="P:MailKit.Net.Pop3.Pop3Client.ExpirePolicy"/>).
  19800. </summary>
  19801. </member>
  19802. <member name="F:MailKit.Net.Pop3.Pop3Capabilities.LoginDelay">
  19803. <summary>
  19804. The server supports the <a href="https://tools.ietf.org/html/rfc2449">LOGIN-DELAY</a> extension,
  19805. allowing the server to specify to the client a minimum number of seconds between login attempts
  19806. (see <see cref="P:MailKit.Net.Pop3.Pop3Client.LoginDelay"/>).
  19807. </summary>
  19808. </member>
  19809. <member name="F:MailKit.Net.Pop3.Pop3Capabilities.Pipelining">
  19810. <summary>
  19811. The server supports the <a href="https://tools.ietf.org/html/rfc2449">PIPELINING</a> extension,
  19812. allowing the client to batch multiple requests to the server at at time.
  19813. </summary>
  19814. </member>
  19815. <member name="F:MailKit.Net.Pop3.Pop3Capabilities.ResponseCodes">
  19816. <summary>
  19817. The server supports the <a href="https://tools.ietf.org/html/rfc2449">RESP-CODES</a> extension,
  19818. allowing the server to provide clients with extended information in error responses.
  19819. </summary>
  19820. </member>
  19821. <member name="F:MailKit.Net.Pop3.Pop3Capabilities.Sasl">
  19822. <summary>
  19823. The server supports the <a href="https://tools.ietf.org/html/rfc2449">SASL</a> authentication
  19824. extension, allowing the client to authenticate using the advertized authentication mechanisms
  19825. (see <see cref="P:MailKit.Net.Pop3.Pop3Client.AuthenticationMechanisms"/>).
  19826. </summary>
  19827. </member>
  19828. <member name="F:MailKit.Net.Pop3.Pop3Capabilities.StartTLS">
  19829. <summary>
  19830. The server supports the <a href="https://tools.ietf.org/html/rfc2595">STLS</a> extension,
  19831. allowing clients to switch to an encrypted SSL/TLS connection after connecting.
  19832. </summary>
  19833. </member>
  19834. <member name="F:MailKit.Net.Pop3.Pop3Capabilities.Top">
  19835. <summary>
  19836. The server supports the <a href="https://tools.ietf.org/html/rfc1939#page-11">TOP</a> command,
  19837. allowing clients to fetch the headers plus an arbitrary number of lines.
  19838. </summary>
  19839. </member>
  19840. <member name="F:MailKit.Net.Pop3.Pop3Capabilities.UIDL">
  19841. <summary>
  19842. The server supports the <a href="https://tools.ietf.org/html/rfc1939#page-12">UIDL</a> command,
  19843. allowing the client to refer to messages via a UID as opposed to a sequence ID.
  19844. </summary>
  19845. </member>
  19846. <member name="F:MailKit.Net.Pop3.Pop3Capabilities.User">
  19847. <summary>
  19848. The server supports the <a href="https://tools.ietf.org/html/rfc1939#page-13">USER</a>
  19849. authentication command, allowing the client to authenticate via a plain-text username
  19850. and password command (not recommended unless no other authentication mechanisms exist).
  19851. </summary>
  19852. </member>
  19853. <member name="F:MailKit.Net.Pop3.Pop3Capabilities.UTF8">
  19854. <summary>
  19855. The server supports the <a href="https://tools.ietf.org/html/rfc6856">UTF8</a> extension,
  19856. allowing clients to retrieve messages in the UTF-8 encoding.
  19857. </summary>
  19858. </member>
  19859. <member name="F:MailKit.Net.Pop3.Pop3Capabilities.UTF8User">
  19860. <summary>
  19861. The server supports the <a href="https://tools.ietf.org/html/rfc6856">UTF8=USER</a> extension,
  19862. allowing clients to authenticate using UTF-8 encoded usernames and passwords.
  19863. </summary>
  19864. </member>
  19865. <member name="F:MailKit.Net.Pop3.Pop3Capabilities.Lang">
  19866. <summary>
  19867. The server supports the <a href="https://tools.ietf.org/html/rfc6856">LANG</a> extension,
  19868. allowing clients to specify which language the server should use for error strings.
  19869. </summary>
  19870. </member>
  19871. <member name="T:MailKit.Net.Pop3.Pop3CommandHandler">
  19872. <summary>
  19873. POP3 command handler.
  19874. </summary>
  19875. <remarks>
  19876. All exceptions thrown by the handler are considered fatal and will
  19877. force-disconnect the connection. If a non-fatal error occurs, set
  19878. it on the <see cref="P:MailKit.Net.Pop3.Pop3Command.Exception"/> property.
  19879. </remarks>
  19880. </member>
  19881. <member name="T:MailKit.Net.Pop3.Pop3CommandException">
  19882. <summary>
  19883. A POP3 command exception.
  19884. </summary>
  19885. <remarks>
  19886. The exception that is thrown when a POP3 command fails. Unlike a <see cref="T:MailKit.Net.Pop3.Pop3ProtocolException"/>,
  19887. a <see cref="T:MailKit.Net.Pop3.Pop3CommandException"/> does not require the <see cref="T:MailKit.Net.Pop3.Pop3Client"/> to be reconnected.
  19888. </remarks>
  19889. <example>
  19890. <code language="c#" source="Examples\Pop3Examples.cs" region="ExceptionHandling"/>
  19891. </example>
  19892. </member>
  19893. <member name="M:MailKit.Net.Pop3.Pop3CommandException.#ctor(System.String,System.Exception)">
  19894. <summary>
  19895. Initializes a new instance of the <see cref="T:MailKit.Net.Pop3.Pop3CommandException"/> class.
  19896. </summary>
  19897. <remarks>
  19898. Creates a new <see cref="T:MailKit.Net.Pop3.Pop3CommandException"/>.
  19899. </remarks>
  19900. <param name="message">The error message.</param>
  19901. <param name="innerException">An inner exception.</param>
  19902. </member>
  19903. <member name="M:MailKit.Net.Pop3.Pop3CommandException.#ctor(System.String,System.String,System.Exception)">
  19904. <summary>
  19905. Initializes a new instance of the <see cref="T:MailKit.Net.Pop3.Pop3CommandException"/> class.
  19906. </summary>
  19907. <remarks>
  19908. Creates a new <see cref="T:MailKit.Net.Pop3.Pop3CommandException"/>.
  19909. </remarks>
  19910. <param name="message">The error message.</param>
  19911. <param name="statusText">The response status text.</param>
  19912. <param name="innerException">An inner exception.</param>
  19913. <exception cref="T:System.ArgumentNullException">
  19914. <paramref name="statusText"/> is <c>null</c>.
  19915. </exception>
  19916. </member>
  19917. <member name="M:MailKit.Net.Pop3.Pop3CommandException.#ctor(System.String)">
  19918. <summary>
  19919. Initializes a new instance of the <see cref="T:MailKit.Net.Pop3.Pop3CommandException"/> class.
  19920. </summary>
  19921. <remarks>
  19922. Creates a new <see cref="T:MailKit.Net.Pop3.Pop3CommandException"/>.
  19923. </remarks>
  19924. <param name="message">The error message.</param>
  19925. </member>
  19926. <member name="M:MailKit.Net.Pop3.Pop3CommandException.#ctor(System.String,System.String)">
  19927. <summary>
  19928. Initializes a new instance of the <see cref="T:MailKit.Net.Pop3.Pop3CommandException"/> class.
  19929. </summary>
  19930. <remarks>
  19931. Creates a new <see cref="T:MailKit.Net.Pop3.Pop3CommandException"/>.
  19932. </remarks>
  19933. <param name="message">The error message.</param>
  19934. <param name="statusText">The response status text.</param>
  19935. <exception cref="T:System.ArgumentNullException">
  19936. <paramref name="statusText"/> is <c>null</c>.
  19937. </exception>
  19938. </member>
  19939. <member name="M:MailKit.Net.Pop3.Pop3CommandException.#ctor">
  19940. <summary>
  19941. Initializes a new instance of the <see cref="T:MailKit.Net.Pop3.Pop3CommandException"/> class.
  19942. </summary>
  19943. <remarks>
  19944. Creates a new <see cref="T:MailKit.Net.Pop3.Pop3CommandException"/>.
  19945. </remarks>
  19946. </member>
  19947. <member name="P:MailKit.Net.Pop3.Pop3CommandException.StatusText">
  19948. <summary>
  19949. Get the response status text.
  19950. </summary>
  19951. <remarks>
  19952. Gets the response status text.
  19953. </remarks>
  19954. <example>
  19955. <code language="c#" source="Examples\Pop3Examples.cs" region="ExceptionHandling"/>
  19956. </example>
  19957. <value>The response status text.</value>
  19958. </member>
  19959. <member name="T:MailKit.Net.Pop3.Pop3EngineState">
  19960. <summary>
  19961. The state of the <see cref="T:MailKit.Net.Pop3.Pop3Engine"/>.
  19962. </summary>
  19963. </member>
  19964. <member name="F:MailKit.Net.Pop3.Pop3EngineState.Disconnected">
  19965. <summary>
  19966. The Pop3Engine is in the disconnected state.
  19967. </summary>
  19968. </member>
  19969. <member name="F:MailKit.Net.Pop3.Pop3EngineState.Connected">
  19970. <summary>
  19971. The Pop3Engine is in the connected state.
  19972. </summary>
  19973. </member>
  19974. <member name="F:MailKit.Net.Pop3.Pop3EngineState.Transaction">
  19975. <summary>
  19976. The Pop3Engine is in the transaction state, indicating that it is
  19977. authenticated and may retrieve messages from the server.
  19978. </summary>
  19979. </member>
  19980. <member name="T:MailKit.Net.Pop3.Pop3Engine">
  19981. <summary>
  19982. A POP3 command engine.
  19983. </summary>
  19984. </member>
  19985. <member name="M:MailKit.Net.Pop3.Pop3Engine.#ctor">
  19986. <summary>
  19987. Initializes a new instance of the <see cref="T:MailKit.Net.Pop3.Pop3Engine"/> class.
  19988. </summary>
  19989. </member>
  19990. <member name="P:MailKit.Net.Pop3.Pop3Engine.Uri">
  19991. <summary>
  19992. Gets the URI of the POP3 server.
  19993. </summary>
  19994. <remarks>
  19995. Gets the URI of the POP3 server.
  19996. </remarks>
  19997. <value>The URI of the POP3 server.</value>
  19998. </member>
  19999. <member name="P:MailKit.Net.Pop3.Pop3Engine.AuthenticationMechanisms">
  20000. <summary>
  20001. Gets the authentication mechanisms supported by the POP3 server.
  20002. </summary>
  20003. <remarks>
  20004. The authentication mechanisms are queried durring the
  20005. <see cref="M:MailKit.Net.Pop3.Pop3Engine.ConnectAsync(MailKit.Net.Pop3.Pop3Stream,System.Threading.CancellationToken)"/> method.
  20006. </remarks>
  20007. <value>The authentication mechanisms.</value>
  20008. </member>
  20009. <member name="P:MailKit.Net.Pop3.Pop3Engine.Capabilities">
  20010. <summary>
  20011. Gets the capabilities supported by the POP3 server.
  20012. </summary>
  20013. <remarks>
  20014. The capabilities will not be known until a successful connection
  20015. has been made via the <see cref="M:MailKit.Net.Pop3.Pop3Engine.ConnectAsync(MailKit.Net.Pop3.Pop3Stream,System.Threading.CancellationToken)"/> method.
  20016. </remarks>
  20017. <value>The capabilities.</value>
  20018. </member>
  20019. <member name="P:MailKit.Net.Pop3.Pop3Engine.Stream">
  20020. <summary>
  20021. Gets the underlying POP3 stream.
  20022. </summary>
  20023. <remarks>
  20024. Gets the underlying POP3 stream.
  20025. </remarks>
  20026. <value>The pop3 stream.</value>
  20027. </member>
  20028. <member name="P:MailKit.Net.Pop3.Pop3Engine.State">
  20029. <summary>
  20030. Gets or sets the state of the engine.
  20031. </summary>
  20032. <remarks>
  20033. Gets or sets the state of the engine.
  20034. </remarks>
  20035. <value>The engine state.</value>
  20036. </member>
  20037. <member name="P:MailKit.Net.Pop3.Pop3Engine.IsConnected">
  20038. <summary>
  20039. Gets whether or not the engine is currently connected to a POP3 server.
  20040. </summary>
  20041. <remarks>
  20042. Gets whether or not the engine is currently connected to a POP3 server.
  20043. </remarks>
  20044. <value><c>true</c> if the engine is connected; otherwise, <c>false</c>.</value>
  20045. </member>
  20046. <member name="P:MailKit.Net.Pop3.Pop3Engine.ApopToken">
  20047. <summary>
  20048. Gets the APOP authentication token.
  20049. </summary>
  20050. <remarks>
  20051. Gets the APOP authentication token.
  20052. </remarks>
  20053. <value>The APOP authentication token.</value>
  20054. </member>
  20055. <member name="P:MailKit.Net.Pop3.Pop3Engine.ExpirePolicy">
  20056. <summary>
  20057. Gets the EXPIRE extension policy value.
  20058. </summary>
  20059. <remarks>
  20060. Gets the EXPIRE extension policy value.
  20061. </remarks>
  20062. <value>The EXPIRE policy.</value>
  20063. </member>
  20064. <member name="P:MailKit.Net.Pop3.Pop3Engine.Implementation">
  20065. <summary>
  20066. Gets the implementation details of the server.
  20067. </summary>
  20068. <remarks>
  20069. Gets the implementation details of the server.
  20070. </remarks>
  20071. <value>The implementation details.</value>
  20072. </member>
  20073. <member name="P:MailKit.Net.Pop3.Pop3Engine.LoginDelay">
  20074. <summary>
  20075. Gets the login delay.
  20076. </summary>
  20077. <remarks>
  20078. Gets the login delay.
  20079. </remarks>
  20080. <value>The login delay.</value>
  20081. </member>
  20082. <member name="M:MailKit.Net.Pop3.Pop3Engine.Connect(MailKit.Net.Pop3.Pop3Stream,System.Threading.CancellationToken)">
  20083. <summary>
  20084. Takes posession of the <see cref="T:MailKit.Net.Pop3.Pop3Stream"/> and reads the greeting.
  20085. </summary>
  20086. <remarks>
  20087. Takes posession of the <see cref="T:MailKit.Net.Pop3.Pop3Stream"/> and reads the greeting.
  20088. </remarks>
  20089. <param name="pop3">The pop3 stream.</param>
  20090. <param name="cancellationToken">The cancellation token</param>
  20091. </member>
  20092. <member name="M:MailKit.Net.Pop3.Pop3Engine.ConnectAsync(MailKit.Net.Pop3.Pop3Stream,System.Threading.CancellationToken)">
  20093. <summary>
  20094. Takes posession of the <see cref="T:MailKit.Net.Pop3.Pop3Stream"/> and reads the greeting.
  20095. </summary>
  20096. <remarks>
  20097. Takes posession of the <see cref="T:MailKit.Net.Pop3.Pop3Stream"/> and reads the greeting.
  20098. </remarks>
  20099. <param name="pop3">The pop3 stream.</param>
  20100. <param name="cancellationToken">The cancellation token</param>
  20101. </member>
  20102. <member name="M:MailKit.Net.Pop3.Pop3Engine.Disconnect">
  20103. <summary>
  20104. Disconnects the <see cref="T:MailKit.Net.Pop3.Pop3Engine"/>.
  20105. </summary>
  20106. <remarks>
  20107. Disconnects the <see cref="T:MailKit.Net.Pop3.Pop3Engine"/>.
  20108. </remarks>
  20109. </member>
  20110. <member name="M:MailKit.Net.Pop3.Pop3Engine.ReadLine(System.Threading.CancellationToken)">
  20111. <summary>
  20112. Reads a single line from the <see cref="T:MailKit.Net.Pop3.Pop3Stream"/>.
  20113. </summary>
  20114. <returns>The line.</returns>
  20115. <param name="cancellationToken">The cancellation token.</param>
  20116. <exception cref="T:System.InvalidOperationException">
  20117. The engine is not connected.
  20118. </exception>
  20119. <exception cref="T:System.OperationCanceledException">
  20120. The operation was canceled via the cancellation token.
  20121. </exception>
  20122. <exception cref="T:System.IO.IOException">
  20123. An I/O error occurred.
  20124. </exception>
  20125. </member>
  20126. <member name="M:MailKit.Net.Pop3.Pop3Engine.ReadLineAsync(System.Threading.CancellationToken)">
  20127. <summary>
  20128. Reads a single line from the <see cref="T:MailKit.Net.Pop3.Pop3Stream"/>.
  20129. </summary>
  20130. <returns>The line.</returns>
  20131. <param name="cancellationToken">The cancellation token.</param>
  20132. <exception cref="T:System.InvalidOperationException">
  20133. The engine is not connected.
  20134. </exception>
  20135. <exception cref="T:System.OperationCanceledException">
  20136. The operation was canceled via the cancellation token.
  20137. </exception>
  20138. <exception cref="T:System.IO.IOException">
  20139. An I/O error occurred.
  20140. </exception>
  20141. </member>
  20142. <member name="M:MailKit.Net.Pop3.Pop3Engine.Iterate">
  20143. <summary>
  20144. Iterate the command pipeline.
  20145. </summary>
  20146. <returns>The ID of the command that just completed.</returns>
  20147. </member>
  20148. <member name="M:MailKit.Net.Pop3.Pop3Engine.IterateAsync">
  20149. <summary>
  20150. Iterate the command pipeline.
  20151. </summary>
  20152. <returns>The ID of the command that just completed.</returns>
  20153. </member>
  20154. <member name="T:MailKit.Net.Pop3.Pop3Language">
  20155. <summary>
  20156. A POP3 language.
  20157. </summary>
  20158. <remarks>
  20159. A POP3 language.
  20160. </remarks>
  20161. </member>
  20162. <member name="M:MailKit.Net.Pop3.Pop3Language.#ctor(System.String,System.String)">
  20163. <summary>
  20164. Initializes a new instance of the <see cref="T:MailKit.Net.Pop3.Pop3Language"/> class.
  20165. </summary>
  20166. <remarks>
  20167. Creates a new <see cref="T:MailKit.Net.Pop3.Pop3Language"/>.
  20168. </remarks>
  20169. </member>
  20170. <member name="P:MailKit.Net.Pop3.Pop3Language.Language">
  20171. <summary>
  20172. Get the language code.
  20173. </summary>
  20174. <remarks>
  20175. Gets the language code. This is the value that should be given to
  20176. <see cref="M:MailKit.Net.Pop3.Pop3Client.SetLanguage(System.String,System.Threading.CancellationToken)"/>.
  20177. </remarks>
  20178. <value>The language.</value>
  20179. </member>
  20180. <member name="P:MailKit.Net.Pop3.Pop3Language.Description">
  20181. <summary>
  20182. Get the description.
  20183. </summary>
  20184. <remarks>
  20185. Gets the description.
  20186. </remarks>
  20187. <value>The description.</value>
  20188. </member>
  20189. <member name="T:MailKit.Net.Pop3.Pop3ProtocolException">
  20190. <summary>
  20191. A POP3 protocol exception.
  20192. </summary>
  20193. <remarks>
  20194. The exception that is thrown when there is an error communicating with a POP3 server. A
  20195. <see cref="T:MailKit.Net.Pop3.Pop3ProtocolException"/> is typically fatal and requires the <see cref="T:MailKit.Net.Pop3.Pop3Client"/>
  20196. to be reconnected.
  20197. </remarks>
  20198. <example>
  20199. <code language="c#" source="Examples\Pop3Examples.cs" region="ExceptionHandling"/>
  20200. </example>
  20201. </member>
  20202. <member name="M:MailKit.Net.Pop3.Pop3ProtocolException.#ctor(System.String,System.Exception)">
  20203. <summary>
  20204. Initializes a new instance of the <see cref="T:MailKit.Net.Pop3.Pop3ProtocolException"/> class.
  20205. </summary>
  20206. <remarks>
  20207. Creates a new <see cref="T:MailKit.Net.Pop3.Pop3ProtocolException"/>.
  20208. </remarks>
  20209. <param name="message">The error message.</param>
  20210. <param name="innerException">An inner exception.</param>
  20211. </member>
  20212. <member name="M:MailKit.Net.Pop3.Pop3ProtocolException.#ctor(System.String)">
  20213. <summary>
  20214. Initializes a new instance of the <see cref="T:MailKit.Net.Pop3.Pop3ProtocolException"/> class.
  20215. </summary>
  20216. <remarks>
  20217. Creates a new <see cref="T:MailKit.Net.Pop3.Pop3ProtocolException"/>.
  20218. </remarks>
  20219. <param name="message">The error message.</param>
  20220. </member>
  20221. <member name="M:MailKit.Net.Pop3.Pop3ProtocolException.#ctor">
  20222. <summary>
  20223. Initializes a new instance of the <see cref="T:MailKit.Net.Pop3.Pop3ProtocolException"/> class.
  20224. </summary>
  20225. <remarks>
  20226. Creates a new <see cref="T:MailKit.Net.Pop3.Pop3ProtocolException"/>.
  20227. </remarks>
  20228. </member>
  20229. <member name="T:MailKit.Net.Pop3.Pop3StreamMode">
  20230. <summary>
  20231. An enumeration of the possible POP3 streaming modes.
  20232. </summary>
  20233. <remarks>
  20234. Normal operation is done in the <see cref="F:MailKit.Net.Pop3.Pop3StreamMode.Line"/> mode,
  20235. but when retrieving messages (via RETR) or headers (via TOP), the
  20236. <see cref="F:MailKit.Net.Pop3.Pop3StreamMode.Data"/> mode should be used.
  20237. </remarks>
  20238. </member>
  20239. <member name="F:MailKit.Net.Pop3.Pop3StreamMode.Line">
  20240. <summary>
  20241. Reads 1 line at a time.
  20242. </summary>
  20243. </member>
  20244. <member name="F:MailKit.Net.Pop3.Pop3StreamMode.Data">
  20245. <summary>
  20246. Reads data in chunks, ignoring line state.
  20247. </summary>
  20248. </member>
  20249. <member name="T:MailKit.Net.Pop3.Pop3Stream">
  20250. <summary>
  20251. A stream for communicating with a POP3 server.
  20252. </summary>
  20253. <remarks>
  20254. A stream capable of reading data line-by-line (<see cref="F:MailKit.Net.Pop3.Pop3StreamMode.Line"/>)
  20255. or by raw byte streams (<see cref="F:MailKit.Net.Pop3.Pop3StreamMode.Data"/>).
  20256. </remarks>
  20257. </member>
  20258. <member name="M:MailKit.Net.Pop3.Pop3Stream.#ctor(System.IO.Stream,MailKit.IProtocolLogger)">
  20259. <summary>
  20260. Initializes a new instance of the <see cref="T:MailKit.Net.Pop3.Pop3Stream"/> class.
  20261. </summary>
  20262. <remarks>
  20263. Creates a new <see cref="T:MailKit.Net.Pop3.Pop3Stream"/>.
  20264. </remarks>
  20265. <param name="source">The underlying network stream.</param>
  20266. <param name="protocolLogger">The protocol logger.</param>
  20267. </member>
  20268. <member name="P:MailKit.Net.Pop3.Pop3Stream.Stream">
  20269. <summary>
  20270. Get or sets the underlying network stream.
  20271. </summary>
  20272. <remarks>
  20273. Gets or sets the underlying network stream.
  20274. </remarks>
  20275. <value>The underlying network stream.</value>
  20276. </member>
  20277. <member name="P:MailKit.Net.Pop3.Pop3Stream.Mode">
  20278. <summary>
  20279. Gets or sets the mode used for reading.
  20280. </summary>
  20281. <value>The mode.</value>
  20282. </member>
  20283. <member name="P:MailKit.Net.Pop3.Pop3Stream.IsConnected">
  20284. <summary>
  20285. Get whether or not the stream is connected.
  20286. </summary>
  20287. <remarks>
  20288. Gets whether or not the stream is connected.
  20289. </remarks>
  20290. <value><c>true</c> if the stream is connected; otherwise, <c>false</c>.</value>
  20291. </member>
  20292. <member name="P:MailKit.Net.Pop3.Pop3Stream.IsEndOfData">
  20293. <summary>
  20294. Get whether or not the end of the raw data has been reached in <see cref="F:MailKit.Net.Pop3.Pop3StreamMode.Data"/> mode.
  20295. </summary>
  20296. <remarks>
  20297. When reading the resonse to a command such as RETR, the end of the data is marked by line matching ".\r\n".
  20298. </remarks>
  20299. <value><c>true</c> if the end of the data has been reached; otherwise, <c>false</c>.</value>
  20300. </member>
  20301. <member name="P:MailKit.Net.Pop3.Pop3Stream.CanRead">
  20302. <summary>
  20303. Get whether the stream supports reading.
  20304. </summary>
  20305. <remarks>
  20306. Gets whether the stream supports reading.
  20307. </remarks>
  20308. <value><c>true</c> if the stream supports reading; otherwise, <c>false</c>.</value>
  20309. </member>
  20310. <member name="P:MailKit.Net.Pop3.Pop3Stream.CanWrite">
  20311. <summary>
  20312. Get whether the stream supports writing.
  20313. </summary>
  20314. <remarks>
  20315. Gets whether the stream supports writing.
  20316. </remarks>
  20317. <value><c>true</c> if the stream supports writing; otherwise, <c>false</c>.</value>
  20318. </member>
  20319. <member name="P:MailKit.Net.Pop3.Pop3Stream.CanSeek">
  20320. <summary>
  20321. Get whether the stream supports seeking.
  20322. </summary>
  20323. <remarks>
  20324. Gets whether the stream supports seeking.
  20325. </remarks>
  20326. <value><c>true</c> if the stream supports seeking; otherwise, <c>false</c>.</value>
  20327. </member>
  20328. <member name="P:MailKit.Net.Pop3.Pop3Stream.CanTimeout">
  20329. <summary>
  20330. Get whether the stream supports I/O timeouts.
  20331. </summary>
  20332. <remarks>
  20333. Gets whether the stream supports I/O timeouts.
  20334. </remarks>
  20335. <value><c>true</c> if the stream supports I/O timeouts; otherwise, <c>false</c>.</value>
  20336. </member>
  20337. <member name="P:MailKit.Net.Pop3.Pop3Stream.ReadTimeout">
  20338. <summary>
  20339. Get or set a value, in milliseconds, that determines how long the stream will attempt to read before timing out.
  20340. </summary>
  20341. <remarks>
  20342. Gets or sets a value, in milliseconds, that determines how long the stream will attempt to read before timing out.
  20343. </remarks>
  20344. <returns>A value, in milliseconds, that determines how long the stream will attempt to read before timing out.</returns>
  20345. <value>The read timeout.</value>
  20346. </member>
  20347. <member name="P:MailKit.Net.Pop3.Pop3Stream.WriteTimeout">
  20348. <summary>
  20349. Get or set a value, in milliseconds, that determines how long the stream will attempt to write before timing out.
  20350. </summary>
  20351. <remarks>
  20352. Gets or sets a value, in milliseconds, that determines how long the stream will attempt to write before timing out.
  20353. </remarks>
  20354. <returns>A value, in milliseconds, that determines how long the stream will attempt to write before timing out.</returns>
  20355. <value>The write timeout.</value>
  20356. </member>
  20357. <member name="P:MailKit.Net.Pop3.Pop3Stream.Position">
  20358. <summary>
  20359. Get or set the position within the current stream.
  20360. </summary>
  20361. <remarks>
  20362. Gets or sets the position within the current stream.
  20363. </remarks>
  20364. <returns>The current position within the stream.</returns>
  20365. <value>The position of the stream.</value>
  20366. <exception cref="T:System.IO.IOException">
  20367. An I/O error occurred.
  20368. </exception>
  20369. <exception cref="T:System.NotSupportedException">
  20370. The stream does not support seeking.
  20371. </exception>
  20372. <exception cref="T:System.ObjectDisposedException">
  20373. The stream has been disposed.
  20374. </exception>
  20375. </member>
  20376. <member name="P:MailKit.Net.Pop3.Pop3Stream.Length">
  20377. <summary>
  20378. Get the length of the stream, in bytes.
  20379. </summary>
  20380. <remarks>
  20381. Gets the length of the stream, in bytes.
  20382. </remarks>
  20383. <returns>A long value representing the length of the stream in bytes.</returns>
  20384. <value>The length of the stream.</value>
  20385. <exception cref="T:System.NotSupportedException">
  20386. The stream does not support seeking.
  20387. </exception>
  20388. <exception cref="T:System.ObjectDisposedException">
  20389. The stream has been disposed.
  20390. </exception>
  20391. </member>
  20392. <member name="M:MailKit.Net.Pop3.Pop3Stream.Read(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  20393. <summary>
  20394. Reads a sequence of bytes from the stream and advances the position
  20395. within the stream by the number of bytes read.
  20396. </summary>
  20397. <remarks>
  20398. Reads a sequence of bytes from the stream and advances the position
  20399. within the stream by the number of bytes read.
  20400. </remarks>
  20401. <returns>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many
  20402. bytes are not currently available, or zero (0) if the end of the stream has been reached.</returns>
  20403. <param name="buffer">The buffer.</param>
  20404. <param name="offset">The buffer offset.</param>
  20405. <param name="count">The number of bytes to read.</param>
  20406. <param name="cancellationToken">The cancellation token.</param>
  20407. <exception cref="T:System.ArgumentNullException">
  20408. <paramref name="buffer"/> is <c>null</c>.
  20409. </exception>
  20410. <exception cref="T:System.ArgumentOutOfRangeException">
  20411. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  20412. <para>-or-</para>
  20413. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  20414. at the specified <paramref name="offset"/>.</para>
  20415. </exception>
  20416. <exception cref="T:System.ObjectDisposedException">
  20417. The stream has been disposed.
  20418. </exception>
  20419. <exception cref="T:System.InvalidOperationException">
  20420. The stream is in line mode (see <see cref="F:MailKit.Net.Pop3.Pop3StreamMode.Line"/>).
  20421. </exception>
  20422. <exception cref="T:System.OperationCanceledException">
  20423. The operation was canceled via the cancellation token.
  20424. </exception>
  20425. <exception cref="T:System.IO.IOException">
  20426. An I/O error occurred.
  20427. </exception>
  20428. </member>
  20429. <member name="M:MailKit.Net.Pop3.Pop3Stream.Read(System.Byte[],System.Int32,System.Int32)">
  20430. <summary>
  20431. Reads a sequence of bytes from the stream and advances the position
  20432. within the stream by the number of bytes read.
  20433. </summary>
  20434. <remarks>
  20435. Reads a sequence of bytes from the stream and advances the position
  20436. within the stream by the number of bytes read.
  20437. </remarks>
  20438. <returns>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many
  20439. bytes are not currently available, or zero (0) if the end of the stream has been reached.</returns>
  20440. <param name="buffer">The buffer.</param>
  20441. <param name="offset">The buffer offset.</param>
  20442. <param name="count">The number of bytes to read.</param>
  20443. <exception cref="T:System.ArgumentNullException">
  20444. <paramref name="buffer"/> is <c>null</c>.
  20445. </exception>
  20446. <exception cref="T:System.ArgumentOutOfRangeException">
  20447. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  20448. <para>-or-</para>
  20449. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  20450. at the specified <paramref name="offset"/>.</para>
  20451. </exception>
  20452. <exception cref="T:System.ObjectDisposedException">
  20453. The stream has been disposed.
  20454. </exception>
  20455. <exception cref="T:System.InvalidOperationException">
  20456. The stream is in line mode (see <see cref="F:MailKit.Net.Pop3.Pop3StreamMode.Line"/>).
  20457. </exception>
  20458. <exception cref="T:System.IO.IOException">
  20459. An I/O error occurred.
  20460. </exception>
  20461. </member>
  20462. <member name="M:MailKit.Net.Pop3.Pop3Stream.ReadAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  20463. <summary>
  20464. Reads a sequence of bytes from the stream and advances the position
  20465. within the stream by the number of bytes read.
  20466. </summary>
  20467. <remarks>
  20468. Reads a sequence of bytes from the stream and advances the position
  20469. within the stream by the number of bytes read.
  20470. </remarks>
  20471. <returns>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many
  20472. bytes are not currently available, or zero (0) if the end of the stream has been reached.</returns>
  20473. <param name="buffer">The buffer.</param>
  20474. <param name="offset">The buffer offset.</param>
  20475. <param name="count">The number of bytes to read.</param>
  20476. <param name="cancellationToken">The cancellation token.</param>
  20477. <exception cref="T:System.ArgumentNullException">
  20478. <paramref name="buffer"/> is <c>null</c>.
  20479. </exception>
  20480. <exception cref="T:System.ArgumentOutOfRangeException">
  20481. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  20482. <para>-or-</para>
  20483. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  20484. at the specified <paramref name="offset"/>.</para>
  20485. </exception>
  20486. <exception cref="T:System.ObjectDisposedException">
  20487. The stream has been disposed.
  20488. </exception>
  20489. <exception cref="T:System.InvalidOperationException">
  20490. The stream is in line mode (see <see cref="F:MailKit.Net.Pop3.Pop3StreamMode.Line"/>).
  20491. </exception>
  20492. <exception cref="T:System.OperationCanceledException">
  20493. The operation was canceled via the cancellation token.
  20494. </exception>
  20495. <exception cref="T:System.IO.IOException">
  20496. An I/O error occurred.
  20497. </exception>
  20498. </member>
  20499. <member name="M:MailKit.Net.Pop3.Pop3Stream.ReadLine(System.IO.Stream,System.Threading.CancellationToken)">
  20500. <summary>
  20501. Reads a single line of input from the stream.
  20502. </summary>
  20503. <remarks>
  20504. This method should be called in a loop until it returns <c>true</c>.
  20505. </remarks>
  20506. <returns><c>true</c>, if reading the line is complete, <c>false</c> otherwise.</returns>
  20507. <param name="ostream">The output stream to write the line data into.</param>
  20508. <param name="cancellationToken">The cancellation token.</param>
  20509. <exception cref="T:System.ObjectDisposedException">
  20510. The stream has been disposed.
  20511. </exception>
  20512. <exception cref="T:System.OperationCanceledException">
  20513. The operation was canceled via the cancellation token.
  20514. </exception>
  20515. <exception cref="T:System.IO.IOException">
  20516. An I/O error occurred.
  20517. </exception>
  20518. </member>
  20519. <member name="M:MailKit.Net.Pop3.Pop3Stream.ReadLineAsync(System.IO.Stream,System.Threading.CancellationToken)">
  20520. <summary>
  20521. Asynchronously reads a single line of input from the stream.
  20522. </summary>
  20523. <remarks>
  20524. This method should be called in a loop until it returns <c>true</c>.
  20525. </remarks>
  20526. <returns><c>true</c>, if reading the line is complete, <c>false</c> otherwise.</returns>
  20527. <param name="ostream">The output stream to write the line data into.</param>
  20528. <param name="cancellationToken">The cancellation token.</param>
  20529. <exception cref="T:System.ObjectDisposedException">
  20530. The stream has been disposed.
  20531. </exception>
  20532. <exception cref="T:System.OperationCanceledException">
  20533. The operation was canceled via the cancellation token.
  20534. </exception>
  20535. <exception cref="T:System.IO.IOException">
  20536. An I/O error occurred.
  20537. </exception>
  20538. </member>
  20539. <member name="M:MailKit.Net.Pop3.Pop3Stream.Write(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  20540. <summary>
  20541. Writes a sequence of bytes to the stream and advances the current
  20542. position within this stream by the number of bytes written.
  20543. </summary>
  20544. <remarks>
  20545. Writes a sequence of bytes to the stream and advances the current
  20546. position within this stream by the number of bytes written.
  20547. </remarks>
  20548. <param name='buffer'>The buffer to write.</param>
  20549. <param name='offset'>The offset of the first byte to write.</param>
  20550. <param name='count'>The number of bytes to write.</param>
  20551. <param name="cancellationToken">The cancellation token.</param>
  20552. <exception cref="T:System.ArgumentNullException">
  20553. <paramref name="buffer"/> is <c>null</c>.
  20554. </exception>
  20555. <exception cref="T:System.ArgumentOutOfRangeException">
  20556. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  20557. <para>-or-</para>
  20558. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  20559. at the specified <paramref name="offset"/>.</para>
  20560. </exception>
  20561. <exception cref="T:System.ObjectDisposedException">
  20562. The stream has been disposed.
  20563. </exception>
  20564. <exception cref="T:System.NotSupportedException">
  20565. The stream does not support writing.
  20566. </exception>
  20567. <exception cref="T:System.OperationCanceledException">
  20568. The operation was canceled via the cancellation token.
  20569. </exception>
  20570. <exception cref="T:System.IO.IOException">
  20571. An I/O error occurred.
  20572. </exception>
  20573. </member>
  20574. <member name="M:MailKit.Net.Pop3.Pop3Stream.Write(System.Byte[],System.Int32,System.Int32)">
  20575. <summary>
  20576. Writes a sequence of bytes to the stream and advances the current
  20577. position within this stream by the number of bytes written.
  20578. </summary>
  20579. <remarks>
  20580. Writes a sequence of bytes to the stream and advances the current
  20581. position within this stream by the number of bytes written.
  20582. </remarks>
  20583. <param name='buffer'>The buffer to write.</param>
  20584. <param name='offset'>The offset of the first byte to write.</param>
  20585. <param name='count'>The number of bytes to write.</param>
  20586. <exception cref="T:System.ArgumentNullException">
  20587. <paramref name="buffer"/> is <c>null</c>.
  20588. </exception>
  20589. <exception cref="T:System.ArgumentOutOfRangeException">
  20590. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  20591. <para>-or-</para>
  20592. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  20593. at the specified <paramref name="offset"/>.</para>
  20594. </exception>
  20595. <exception cref="T:System.ObjectDisposedException">
  20596. The stream has been disposed.
  20597. </exception>
  20598. <exception cref="T:System.NotSupportedException">
  20599. The stream does not support writing.
  20600. </exception>
  20601. <exception cref="T:System.IO.IOException">
  20602. An I/O error occurred.
  20603. </exception>
  20604. </member>
  20605. <member name="M:MailKit.Net.Pop3.Pop3Stream.WriteAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  20606. <summary>
  20607. Writes a sequence of bytes to the stream and advances the current
  20608. position within this stream by the number of bytes written.
  20609. </summary>
  20610. <remarks>
  20611. Writes a sequence of bytes to the stream and advances the current
  20612. position within this stream by the number of bytes written.
  20613. </remarks>
  20614. <returns>A task that represents the asynchronous write operation.</returns>
  20615. <param name='buffer'>The buffer to write.</param>
  20616. <param name='offset'>The offset of the first byte to write.</param>
  20617. <param name='count'>The number of bytes to write.</param>
  20618. <param name="cancellationToken">The cancellation token.</param>
  20619. <exception cref="T:System.ArgumentNullException">
  20620. <paramref name="buffer"/> is <c>null</c>.
  20621. </exception>
  20622. <exception cref="T:System.ArgumentOutOfRangeException">
  20623. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  20624. <para>-or-</para>
  20625. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  20626. at the specified <paramref name="offset"/>.</para>
  20627. </exception>
  20628. <exception cref="T:System.ObjectDisposedException">
  20629. The stream has been disposed.
  20630. </exception>
  20631. <exception cref="T:System.NotSupportedException">
  20632. The stream does not support writing.
  20633. </exception>
  20634. <exception cref="T:System.OperationCanceledException">
  20635. The operation was canceled via the cancellation token.
  20636. </exception>
  20637. <exception cref="T:System.IO.IOException">
  20638. An I/O error occurred.
  20639. </exception>
  20640. </member>
  20641. <member name="M:MailKit.Net.Pop3.Pop3Stream.Flush(System.Threading.CancellationToken)">
  20642. <summary>
  20643. Clears all buffers for this stream and causes any buffered data to be written
  20644. to the underlying device.
  20645. </summary>
  20646. <remarks>
  20647. Clears all buffers for this stream and causes any buffered data to be written
  20648. to the underlying device.
  20649. </remarks>
  20650. <param name="cancellationToken">The cancellation token.</param>
  20651. <exception cref="T:System.ObjectDisposedException">
  20652. The stream has been disposed.
  20653. </exception>
  20654. <exception cref="T:System.NotSupportedException">
  20655. The stream does not support writing.
  20656. </exception>
  20657. <exception cref="T:System.OperationCanceledException">
  20658. The operation was canceled via the cancellation token.
  20659. </exception>
  20660. <exception cref="T:System.IO.IOException">
  20661. An I/O error occurred.
  20662. </exception>
  20663. </member>
  20664. <member name="M:MailKit.Net.Pop3.Pop3Stream.Flush">
  20665. <summary>
  20666. Clears all buffers for this stream and causes any buffered data to be written
  20667. to the underlying device.
  20668. </summary>
  20669. <remarks>
  20670. Clears all buffers for this stream and causes any buffered data to be written
  20671. to the underlying device.
  20672. </remarks>
  20673. <exception cref="T:System.ObjectDisposedException">
  20674. The stream has been disposed.
  20675. </exception>
  20676. <exception cref="T:System.NotSupportedException">
  20677. The stream does not support writing.
  20678. </exception>
  20679. <exception cref="T:System.IO.IOException">
  20680. An I/O error occurred.
  20681. </exception>
  20682. </member>
  20683. <member name="M:MailKit.Net.Pop3.Pop3Stream.FlushAsync(System.Threading.CancellationToken)">
  20684. <summary>
  20685. Clears all buffers for this stream and causes any buffered data to be written
  20686. to the underlying device.
  20687. </summary>
  20688. <remarks>
  20689. Clears all buffers for this stream and causes any buffered data to be written
  20690. to the underlying device.
  20691. </remarks>
  20692. <returns>A task that represents the asynchronous flush operation.</returns>
  20693. <param name="cancellationToken">The cancellation token.</param>
  20694. <exception cref="T:System.ObjectDisposedException">
  20695. The stream has been disposed.
  20696. </exception>
  20697. <exception cref="T:System.NotSupportedException">
  20698. The stream does not support writing.
  20699. </exception>
  20700. <exception cref="T:System.OperationCanceledException">
  20701. The operation was canceled via the cancellation token.
  20702. </exception>
  20703. <exception cref="T:System.IO.IOException">
  20704. An I/O error occurred.
  20705. </exception>
  20706. </member>
  20707. <member name="M:MailKit.Net.Pop3.Pop3Stream.Seek(System.Int64,System.IO.SeekOrigin)">
  20708. <summary>
  20709. Sets the position within the current stream.
  20710. </summary>
  20711. <returns>The new position within the stream.</returns>
  20712. <param name="offset">The offset into the stream relative to the <paramref name="origin"/>.</param>
  20713. <param name="origin">The origin to seek from.</param>
  20714. <exception cref="T:System.NotSupportedException">
  20715. The stream does not support seeking.
  20716. </exception>
  20717. </member>
  20718. <member name="M:MailKit.Net.Pop3.Pop3Stream.SetLength(System.Int64)">
  20719. <summary>
  20720. Sets the length of the stream.
  20721. </summary>
  20722. <param name="value">The desired length of the stream in bytes.</param>
  20723. <exception cref="T:System.NotSupportedException">
  20724. The stream does not support setting the length.
  20725. </exception>
  20726. </member>
  20727. <member name="M:MailKit.Net.Pop3.Pop3Stream.Dispose(System.Boolean)">
  20728. <summary>
  20729. Releases the unmanaged resources used by the <see cref="T:MailKit.Net.Pop3.Pop3Stream"/> and
  20730. optionally releases the managed resources.
  20731. </summary>
  20732. <param name="disposing"><c>true</c> to release both managed and unmanaged resources;
  20733. <c>false</c> to release only the unmanaged resources.</param>
  20734. </member>
  20735. <member name="T:MailKit.Net.Proxy.HttpProxyClient">
  20736. <summary>
  20737. An HTTP proxy client.
  20738. </summary>
  20739. <remarkas>
  20740. An HTTP proxy client.
  20741. </remarkas>
  20742. </member>
  20743. <member name="M:MailKit.Net.Proxy.HttpProxyClient.#ctor(System.String,System.Int32)">
  20744. <summary>
  20745. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.HttpProxyClient"/> class.
  20746. </summary>
  20747. <remarks>
  20748. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.HttpProxyClient"/> class.
  20749. </remarks>
  20750. <param name="host">The host name of the proxy server.</param>
  20751. <param name="port">The proxy server port.</param>
  20752. <exception cref="T:System.ArgumentNullException">
  20753. <paramref name="host"/> is <c>null</c>.
  20754. </exception>
  20755. <exception cref="T:System.ArgumentOutOfRangeException">
  20756. <paramref name="port"/> is not between <c>1</c> and <c>65535</c>.
  20757. </exception>
  20758. <exception cref="T:System.ArgumentException">
  20759. <para>The <paramref name="host"/> is a zero-length string.</para>
  20760. <para>-or-</para>
  20761. <para>The length of <paramref name="host"/> is greater than 255 characters.</para>
  20762. </exception>
  20763. </member>
  20764. <member name="M:MailKit.Net.Proxy.HttpProxyClient.#ctor(System.String,System.Int32,System.Net.NetworkCredential)">
  20765. <summary>
  20766. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.HttpProxyClient"/> class.
  20767. </summary>
  20768. <remarks>
  20769. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.HttpProxyClient"/> class.
  20770. </remarks>
  20771. <param name="host">The host name of the proxy server.</param>
  20772. <param name="port">The proxy server port.</param>
  20773. <param name="credentials">The credentials to use to authenticate with the proxy server.</param>
  20774. <exception cref="T:System.ArgumentNullException">
  20775. <para><paramref name="host"/> is <c>null</c>.</para>
  20776. <para>-or-</para>
  20777. <para><paramref name="credentials"/>is <c>null</c>.</para>
  20778. </exception>
  20779. <exception cref="T:System.ArgumentOutOfRangeException">
  20780. <paramref name="port"/> is not between <c>1</c> and <c>65535</c>.
  20781. </exception>
  20782. <exception cref="T:System.ArgumentException">
  20783. <para>The <paramref name="host"/> is a zero-length string.</para>
  20784. <para>-or-</para>
  20785. <para>The length of <paramref name="host"/> is greater than 255 characters.</para>
  20786. </exception>
  20787. </member>
  20788. <member name="M:MailKit.Net.Proxy.HttpProxyClient.Connect(System.String,System.Int32,System.Threading.CancellationToken)">
  20789. <summary>
  20790. Connect to the target host.
  20791. </summary>
  20792. <remarks>
  20793. Connects to the target host and port through the proxy server.
  20794. </remarks>
  20795. <returns>The connected socket.</returns>
  20796. <param name="host">The host name of the proxy server.</param>
  20797. <param name="port">The proxy server port.</param>
  20798. <param name="cancellationToken">The cancellation token.</param>
  20799. <exception cref="T:System.ArgumentNullException">
  20800. <paramref name="host"/> is <c>null</c>.
  20801. </exception>
  20802. <exception cref="T:System.ArgumentOutOfRangeException">
  20803. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  20804. </exception>
  20805. <exception cref="T:System.ArgumentException">
  20806. The <paramref name="host"/> is a zero-length string.
  20807. </exception>
  20808. <exception cref="T:System.OperationCanceledException">
  20809. The operation was canceled via the cancellation token.
  20810. </exception>
  20811. <exception cref="T:System.Net.Sockets.SocketException">
  20812. A socket error occurred trying to connect to the remote host.
  20813. </exception>
  20814. <exception cref="T:System.IO.IOException">
  20815. An I/O error occurred.
  20816. </exception>
  20817. </member>
  20818. <member name="M:MailKit.Net.Proxy.HttpProxyClient.ConnectAsync(System.String,System.Int32,System.Threading.CancellationToken)">
  20819. <summary>
  20820. Asynchronously connect to the target host.
  20821. </summary>
  20822. <remarks>
  20823. Asynchronously connects to the target host and port through the proxy server.
  20824. </remarks>
  20825. <returns>The connected socket.</returns>
  20826. <param name="host">The host name of the proxy server.</param>
  20827. <param name="port">The proxy server port.</param>
  20828. <param name="cancellationToken">The cancellation token.</param>
  20829. <exception cref="T:System.ArgumentNullException">
  20830. <paramref name="host"/> is <c>null</c>.
  20831. </exception>
  20832. <exception cref="T:System.ArgumentOutOfRangeException">
  20833. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  20834. </exception>
  20835. <exception cref="T:System.ArgumentException">
  20836. The <paramref name="host"/> is a zero-length string.
  20837. </exception>
  20838. <exception cref="T:System.OperationCanceledException">
  20839. The operation was canceled via the cancellation token.
  20840. </exception>
  20841. <exception cref="T:System.Net.Sockets.SocketException">
  20842. A socket error occurred trying to connect to the remote host.
  20843. </exception>
  20844. <exception cref="T:System.IO.IOException">
  20845. An I/O error occurred.
  20846. </exception>
  20847. </member>
  20848. <member name="T:MailKit.Net.Proxy.IProxyClient">
  20849. <summary>
  20850. An interface for connecting to services via a proxy.
  20851. </summary>
  20852. <remarks>
  20853. Implemented by <see cref="T:MailKit.Net.Smtp.SmtpClient"/>
  20854. and <see cref="T:MailKit.Net.Pop3.Pop3Client"/>.
  20855. </remarks>
  20856. </member>
  20857. <member name="P:MailKit.Net.Proxy.IProxyClient.ProxyCredentials">
  20858. <summary>
  20859. Gets the proxy credentials.
  20860. </summary>
  20861. <remarks>
  20862. Gets the credentials to use when authenticating with the proxy server.
  20863. </remarks>
  20864. <value>The proxy credentials.</value>
  20865. </member>
  20866. <member name="P:MailKit.Net.Proxy.IProxyClient.ProxyHost">
  20867. <summary>
  20868. Get the proxy host.
  20869. </summary>
  20870. <remarks>
  20871. Gets the host name of the proxy server.
  20872. </remarks>
  20873. <value>The host name of the proxy server.</value>
  20874. </member>
  20875. <member name="P:MailKit.Net.Proxy.IProxyClient.ProxyPort">
  20876. <summary>
  20877. Get the proxy port.
  20878. </summary>
  20879. <remarks>
  20880. Gets the port to use when connecting to the proxy server.
  20881. </remarks>
  20882. <value>The proxy port.</value>
  20883. </member>
  20884. <member name="P:MailKit.Net.Proxy.IProxyClient.LocalEndPoint">
  20885. <summary>
  20886. Get or set the local IP end point to use when connecting to a remote host.
  20887. </summary>
  20888. <remarks>
  20889. Gets or sets the local IP end point to use when connecting to a remote host.
  20890. </remarks>
  20891. <value>The local IP end point or <c>null</c> to use the default end point.</value>
  20892. </member>
  20893. <member name="M:MailKit.Net.Proxy.IProxyClient.Connect(System.String,System.Int32,System.Threading.CancellationToken)">
  20894. <summary>
  20895. Connect to the target host.
  20896. </summary>
  20897. <remarks>
  20898. Connects to the target host and port through the proxy server.
  20899. </remarks>
  20900. <returns>The connected socket.</returns>
  20901. <param name="host">The host name of the proxy server.</param>
  20902. <param name="port">The proxy server port.</param>
  20903. <param name="cancellationToken">The cancellation token.</param>
  20904. <exception cref="T:System.ArgumentNullException">
  20905. <paramref name="host"/> is <c>null</c>.
  20906. </exception>
  20907. <exception cref="T:System.ArgumentOutOfRangeException">
  20908. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  20909. </exception>
  20910. <exception cref="T:System.ArgumentException">
  20911. The <paramref name="host"/> is a zero-length string.
  20912. </exception>
  20913. <exception cref="T:System.OperationCanceledException">
  20914. The operation was canceled via the cancellation token.
  20915. </exception>
  20916. <exception cref="T:System.Net.Sockets.SocketException">
  20917. A socket error occurred trying to connect to the remote host.
  20918. </exception>
  20919. <exception cref="T:System.IO.IOException">
  20920. An I/O error occurred.
  20921. </exception>
  20922. </member>
  20923. <member name="M:MailKit.Net.Proxy.IProxyClient.ConnectAsync(System.String,System.Int32,System.Threading.CancellationToken)">
  20924. <summary>
  20925. Asynchronously connect to the target host.
  20926. </summary>
  20927. <remarks>
  20928. Asynchronously connects to the target host and port through the proxy server.
  20929. </remarks>
  20930. <returns>The connected socket.</returns>
  20931. <param name="host">The host name of the proxy server.</param>
  20932. <param name="port">The proxy server port.</param>
  20933. <param name="cancellationToken">The cancellation token.</param>
  20934. <exception cref="T:System.ArgumentNullException">
  20935. <paramref name="host"/> is <c>null</c>.
  20936. </exception>
  20937. <exception cref="T:System.ArgumentOutOfRangeException">
  20938. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  20939. </exception>
  20940. <exception cref="T:System.ArgumentException">
  20941. The <paramref name="host"/> is a zero-length string.
  20942. </exception>
  20943. <exception cref="T:System.OperationCanceledException">
  20944. The operation was canceled via the cancellation token.
  20945. </exception>
  20946. <exception cref="T:System.Net.Sockets.SocketException">
  20947. A socket error occurred trying to connect to the remote host.
  20948. </exception>
  20949. <exception cref="T:System.IO.IOException">
  20950. An I/O error occurred.
  20951. </exception>
  20952. </member>
  20953. <member name="M:MailKit.Net.Proxy.IProxyClient.Connect(System.String,System.Int32,System.Int32,System.Threading.CancellationToken)">
  20954. <summary>
  20955. Connect to the target host.
  20956. </summary>
  20957. <remarks>
  20958. Connects to the target host and port through the proxy server.
  20959. </remarks>
  20960. <returns>The connected socket.</returns>
  20961. <param name="host">The host name of the proxy server.</param>
  20962. <param name="port">The proxy server port.</param>
  20963. <param name="timeout">The timeout, in milliseconds.</param>
  20964. <param name="cancellationToken">The cancellation token.</param>
  20965. <exception cref="T:System.ArgumentNullException">
  20966. <paramref name="host"/> is <c>null</c>.
  20967. </exception>
  20968. <exception cref="T:System.ArgumentOutOfRangeException">
  20969. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  20970. </exception>
  20971. <exception cref="T:System.ArgumentException">
  20972. The <paramref name="host"/> is a zero-length string.
  20973. </exception>
  20974. <exception cref="T:System.OperationCanceledException">
  20975. The operation was canceled via the cancellation token.
  20976. </exception>
  20977. <exception cref="T:System.TimeoutException">
  20978. The operation timed out.
  20979. </exception>
  20980. <exception cref="T:System.Net.Sockets.SocketException">
  20981. A socket error occurred trying to connect to the remote host.
  20982. </exception>
  20983. <exception cref="T:System.IO.IOException">
  20984. An I/O error occurred.
  20985. </exception>
  20986. </member>
  20987. <member name="M:MailKit.Net.Proxy.IProxyClient.ConnectAsync(System.String,System.Int32,System.Int32,System.Threading.CancellationToken)">
  20988. <summary>
  20989. Asynchronously connect to the target host.
  20990. </summary>
  20991. <remarks>
  20992. Asynchronously connects to the target host and port through the proxy server.
  20993. </remarks>
  20994. <returns>The connected socket.</returns>
  20995. <param name="host">The host name of the proxy server.</param>
  20996. <param name="port">The proxy server port.</param>
  20997. <param name="timeout">The timeout, in milliseconds.</param>
  20998. <param name="cancellationToken">The cancellation token.</param>
  20999. <exception cref="T:System.ArgumentNullException">
  21000. <paramref name="host"/> is <c>null</c>.
  21001. </exception>
  21002. <exception cref="T:System.ArgumentOutOfRangeException">
  21003. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  21004. </exception>
  21005. <exception cref="T:System.ArgumentException">
  21006. The <paramref name="host"/> is a zero-length string.
  21007. </exception>
  21008. <exception cref="T:System.OperationCanceledException">
  21009. The operation was canceled via the cancellation token.
  21010. </exception>
  21011. <exception cref="T:System.TimeoutException">
  21012. The operation timed out.
  21013. </exception>
  21014. <exception cref="T:System.Net.Sockets.SocketException">
  21015. A socket error occurred trying to connect to the remote host.
  21016. </exception>
  21017. <exception cref="T:System.IO.IOException">
  21018. An I/O error occurred.
  21019. </exception>
  21020. </member>
  21021. <member name="T:MailKit.Net.Proxy.ProxyClient">
  21022. <summary>
  21023. An abstract proxy client base class.
  21024. </summary>
  21025. <remarks>
  21026. A proxy client can be used to connect to a service through a firewall that
  21027. would otherwise be blocked.
  21028. </remarks>
  21029. </member>
  21030. <member name="M:MailKit.Net.Proxy.ProxyClient.#ctor(System.String,System.Int32)">
  21031. <summary>
  21032. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.ProxyClient"/> class.
  21033. </summary>
  21034. <remarks>
  21035. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.ProxyClient"/> class.
  21036. </remarks>
  21037. <param name="host">The host name of the proxy server.</param>
  21038. <param name="port">The proxy server port.</param>
  21039. <exception cref="T:System.ArgumentNullException">
  21040. <paramref name="host"/> is <c>null</c>.
  21041. </exception>
  21042. <exception cref="T:System.ArgumentOutOfRangeException">
  21043. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  21044. </exception>
  21045. <exception cref="T:System.ArgumentException">
  21046. <para>The <paramref name="host"/> is a zero-length string.</para>
  21047. <para>-or-</para>
  21048. <para>The length of <paramref name="host"/> is greater than 255 characters.</para>
  21049. </exception>
  21050. </member>
  21051. <member name="M:MailKit.Net.Proxy.ProxyClient.#ctor(System.String,System.Int32,System.Net.NetworkCredential)">
  21052. <summary>
  21053. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.ProxyClient"/> class.
  21054. </summary>
  21055. <remarks>
  21056. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.ProxyClient"/> class.
  21057. </remarks>
  21058. <param name="host">The host name of the proxy server.</param>
  21059. <param name="port">The proxy server port.</param>
  21060. <param name="credentials">The credentials to use to authenticate with the proxy server.</param>
  21061. <exception cref="T:System.ArgumentNullException">
  21062. <para><paramref name="host"/> is <c>null</c>.</para>
  21063. <para>-or-</para>
  21064. <para><paramref name="credentials"/>is <c>null</c>.</para>
  21065. </exception>
  21066. <exception cref="T:System.ArgumentOutOfRangeException">
  21067. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  21068. </exception>
  21069. <exception cref="T:System.ArgumentException">
  21070. <para>The <paramref name="host"/> is a zero-length string.</para>
  21071. <para>-or-</para>
  21072. <para>The length of <paramref name="host"/> is greater than 255 characters.</para>
  21073. </exception>
  21074. </member>
  21075. <member name="P:MailKit.Net.Proxy.ProxyClient.ProxyCredentials">
  21076. <summary>
  21077. Gets the proxy credentials.
  21078. </summary>
  21079. <remarks>
  21080. Gets the credentials to use when authenticating with the proxy server.
  21081. </remarks>
  21082. <value>The proxy credentials.</value>
  21083. </member>
  21084. <member name="P:MailKit.Net.Proxy.ProxyClient.ProxyHost">
  21085. <summary>
  21086. Get the proxy host.
  21087. </summary>
  21088. <remarks>
  21089. Gets the host name of the proxy server.
  21090. </remarks>
  21091. <value>The host name of the proxy server.</value>
  21092. </member>
  21093. <member name="P:MailKit.Net.Proxy.ProxyClient.ProxyPort">
  21094. <summary>
  21095. Get the proxy port.
  21096. </summary>
  21097. <remarks>
  21098. Gets the port to use when connecting to the proxy server.
  21099. </remarks>
  21100. <value>The proxy port.</value>
  21101. </member>
  21102. <member name="P:MailKit.Net.Proxy.ProxyClient.LocalEndPoint">
  21103. <summary>
  21104. Get or set the local IP end point to use when connecting to a remote host.
  21105. </summary>
  21106. <remarks>
  21107. Gets or sets the local IP end point to use when connecting to a remote host.
  21108. </remarks>
  21109. <value>The local IP end point or <c>null</c> to use the default end point.</value>
  21110. </member>
  21111. <member name="M:MailKit.Net.Proxy.ProxyClient.Connect(System.String,System.Int32,System.Threading.CancellationToken)">
  21112. <summary>
  21113. Connect to the target host.
  21114. </summary>
  21115. <remarks>
  21116. Connects to the target host and port through the proxy server.
  21117. </remarks>
  21118. <returns>The connected socket.</returns>
  21119. <param name="host">The host name of the proxy server.</param>
  21120. <param name="port">The proxy server port.</param>
  21121. <param name="cancellationToken">The cancellation token.</param>
  21122. <exception cref="T:System.ArgumentNullException">
  21123. <paramref name="host"/> is <c>null</c>.
  21124. </exception>
  21125. <exception cref="T:System.ArgumentOutOfRangeException">
  21126. <paramref name="port"/> is not between <c>1</c> and <c>65535</c>.
  21127. </exception>
  21128. <exception cref="T:System.ArgumentException">
  21129. The <paramref name="host"/> is a zero-length string.
  21130. </exception>
  21131. <exception cref="T:System.OperationCanceledException">
  21132. The operation was canceled via the cancellation token.
  21133. </exception>
  21134. <exception cref="T:System.Net.Sockets.SocketException">
  21135. A socket error occurred trying to connect to the remote host.
  21136. </exception>
  21137. <exception cref="T:System.IO.IOException">
  21138. An I/O error occurred.
  21139. </exception>
  21140. </member>
  21141. <member name="M:MailKit.Net.Proxy.ProxyClient.ConnectAsync(System.String,System.Int32,System.Threading.CancellationToken)">
  21142. <summary>
  21143. Asynchronously connect to the target host.
  21144. </summary>
  21145. <remarks>
  21146. Asynchronously connects to the target host and port through the proxy server.
  21147. </remarks>
  21148. <returns>The connected socket.</returns>
  21149. <param name="host">The host name of the proxy server.</param>
  21150. <param name="port">The proxy server port.</param>
  21151. <param name="cancellationToken">The cancellation token.</param>
  21152. <exception cref="T:System.ArgumentNullException">
  21153. <paramref name="host"/> is <c>null</c>.
  21154. </exception>
  21155. <exception cref="T:System.ArgumentOutOfRangeException">
  21156. <paramref name="port"/> is not between <c>1</c> and <c>65535</c>.
  21157. </exception>
  21158. <exception cref="T:System.ArgumentException">
  21159. The <paramref name="host"/> is a zero-length string.
  21160. </exception>
  21161. <exception cref="T:System.OperationCanceledException">
  21162. The operation was canceled via the cancellation token.
  21163. </exception>
  21164. <exception cref="T:System.Net.Sockets.SocketException">
  21165. A socket error occurred trying to connect to the remote host.
  21166. </exception>
  21167. <exception cref="T:System.IO.IOException">
  21168. An I/O error occurred.
  21169. </exception>
  21170. </member>
  21171. <member name="M:MailKit.Net.Proxy.ProxyClient.Connect(System.String,System.Int32,System.Int32,System.Threading.CancellationToken)">
  21172. <summary>
  21173. Connect to the target host.
  21174. </summary>
  21175. <remarks>
  21176. Connects to the target host and port through the proxy server.
  21177. </remarks>
  21178. <returns>The connected socket.</returns>
  21179. <param name="host">The host name of the proxy server.</param>
  21180. <param name="port">The proxy server port.</param>
  21181. <param name="timeout">The timeout, in milliseconds.</param>
  21182. <param name="cancellationToken">The cancellation token.</param>
  21183. <exception cref="T:System.ArgumentNullException">
  21184. <paramref name="host"/> is <c>null</c>.
  21185. </exception>
  21186. <exception cref="T:System.ArgumentOutOfRangeException">
  21187. <para><paramref name="port"/> is not between <c>1</c> and <c>65535</c>.</para>
  21188. <para>-or-</para>
  21189. <para><paramref name="timeout"/> is less than <c>-1</c>.</para>
  21190. </exception>
  21191. <exception cref="T:System.ArgumentException">
  21192. The <paramref name="host"/> is a zero-length string.
  21193. </exception>
  21194. <exception cref="T:System.OperationCanceledException">
  21195. The operation was canceled via the cancellation token.
  21196. </exception>
  21197. <exception cref="T:System.TimeoutException">
  21198. The operation timed out.
  21199. </exception>
  21200. <exception cref="T:System.Net.Sockets.SocketException">
  21201. A socket error occurred trying to connect to the remote host.
  21202. </exception>
  21203. <exception cref="T:System.IO.IOException">
  21204. An I/O error occurred.
  21205. </exception>
  21206. </member>
  21207. <member name="M:MailKit.Net.Proxy.ProxyClient.ConnectAsync(System.String,System.Int32,System.Int32,System.Threading.CancellationToken)">
  21208. <summary>
  21209. Asynchronously connect to the target host.
  21210. </summary>
  21211. <remarks>
  21212. Asynchronously connects to the target host and port through the proxy server.
  21213. </remarks>
  21214. <returns>The connected socket.</returns>
  21215. <param name="host">The host name of the proxy server.</param>
  21216. <param name="port">The proxy server port.</param>
  21217. <param name="timeout">The timeout, in milliseconds.</param>
  21218. <param name="cancellationToken">The cancellation token.</param>
  21219. <exception cref="T:System.ArgumentNullException">
  21220. <paramref name="host"/> is <c>null</c>.
  21221. </exception>
  21222. <exception cref="T:System.ArgumentOutOfRangeException">
  21223. <para><paramref name="port"/> is not between <c>1</c> and <c>65535</c>.</para>
  21224. <para>-or-</para>
  21225. <para><paramref name="timeout"/> is less than <c>-1</c>.</para>
  21226. </exception>
  21227. <exception cref="T:System.ArgumentException">
  21228. The <paramref name="host"/> is a zero-length string.
  21229. </exception>
  21230. <exception cref="T:System.OperationCanceledException">
  21231. The operation was canceled via the cancellation token.
  21232. </exception>
  21233. <exception cref="T:System.TimeoutException">
  21234. The operation timed out.
  21235. </exception>
  21236. <exception cref="T:System.Net.Sockets.SocketException">
  21237. A socket error occurred trying to connect to the remote host.
  21238. </exception>
  21239. <exception cref="T:System.IO.IOException">
  21240. An I/O error occurred.
  21241. </exception>
  21242. </member>
  21243. <member name="T:MailKit.Net.Proxy.ProxyProtocolException">
  21244. <summary>
  21245. A proxy protocol exception.
  21246. </summary>
  21247. <remarks>
  21248. The exception that is thrown when there is an error communicating with a proxy server.
  21249. </remarks>
  21250. </member>
  21251. <member name="M:MailKit.Net.Proxy.ProxyProtocolException.#ctor(System.String,System.Exception)">
  21252. <summary>
  21253. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.ProxyProtocolException"/> class.
  21254. </summary>
  21255. <remarks>
  21256. Creates a new <see cref="T:MailKit.Net.Proxy.ProxyProtocolException"/>.
  21257. </remarks>
  21258. <param name="message">The error message.</param>
  21259. <param name="innerException">An inner exception.</param>
  21260. </member>
  21261. <member name="M:MailKit.Net.Proxy.ProxyProtocolException.#ctor(System.String)">
  21262. <summary>
  21263. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.ProxyProtocolException"/> class.
  21264. </summary>
  21265. <remarks>
  21266. Creates a new <see cref="T:MailKit.Net.Proxy.ProxyProtocolException"/>.
  21267. </remarks>
  21268. <param name="message">The error message.</param>
  21269. </member>
  21270. <member name="M:MailKit.Net.Proxy.ProxyProtocolException.#ctor">
  21271. <summary>
  21272. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.ProxyProtocolException"/> class.
  21273. </summary>
  21274. <remarks>
  21275. Creates a new <see cref="T:MailKit.Net.Proxy.ProxyProtocolException"/>.
  21276. </remarks>
  21277. </member>
  21278. <member name="T:MailKit.Net.Proxy.Socks4aClient">
  21279. <summary>
  21280. A SOCKS4a proxy client.
  21281. </summary>
  21282. <remarkas>
  21283. A SOCKS4a proxy client.
  21284. </remarkas>
  21285. </member>
  21286. <member name="M:MailKit.Net.Proxy.Socks4aClient.#ctor(System.String,System.Int32)">
  21287. <summary>
  21288. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.Socks4aClient"/> class.
  21289. </summary>
  21290. <remarks>
  21291. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.Socks4aClient"/> class.
  21292. </remarks>
  21293. <param name="host">The host name of the proxy server.</param>
  21294. <param name="port">The proxy server port.</param>
  21295. <exception cref="T:System.ArgumentNullException">
  21296. <paramref name="host"/> is <c>null</c>.
  21297. </exception>
  21298. <exception cref="T:System.ArgumentOutOfRangeException">
  21299. <paramref name="port"/> is not between <c>1</c> and <c>65535</c>.
  21300. </exception>
  21301. <exception cref="T:System.ArgumentException">
  21302. <para>The <paramref name="host"/> is a zero-length string.</para>
  21303. <para>-or-</para>
  21304. <para>The length of <paramref name="host"/> is greater than 255 characters.</para>
  21305. </exception>
  21306. </member>
  21307. <member name="M:MailKit.Net.Proxy.Socks4aClient.#ctor(System.String,System.Int32,System.Net.NetworkCredential)">
  21308. <summary>
  21309. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.Socks4Client"/> class.
  21310. </summary>
  21311. <remarks>
  21312. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.Socks4Client"/> class.
  21313. </remarks>
  21314. <param name="host">The host name of the proxy server.</param>
  21315. <param name="port">The proxy server port.</param>
  21316. <param name="credentials">The credentials to use to authenticate with the proxy server.</param>
  21317. <exception cref="T:System.ArgumentNullException">
  21318. <para><paramref name="host"/> is <c>null</c>.</para>
  21319. <para>-or-</para>
  21320. <para><paramref name="credentials"/>is <c>null</c>.</para>
  21321. </exception>
  21322. <exception cref="T:System.ArgumentOutOfRangeException">
  21323. <paramref name="port"/> is not between <c>1</c> and <c>65535</c>.
  21324. </exception>
  21325. <exception cref="T:System.ArgumentException">
  21326. The <paramref name="host"/> is a zero-length string.
  21327. </exception>
  21328. </member>
  21329. <member name="T:MailKit.Net.Proxy.Socks4Client">
  21330. <summary>
  21331. A SOCKS4 proxy client.
  21332. </summary>
  21333. <remarkas>
  21334. A SOCKS4 proxy client.
  21335. </remarkas>
  21336. </member>
  21337. <member name="M:MailKit.Net.Proxy.Socks4Client.#ctor(System.String,System.Int32)">
  21338. <summary>
  21339. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.Socks4Client"/> class.
  21340. </summary>
  21341. <remarks>
  21342. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.Socks4Client"/> class.
  21343. </remarks>
  21344. <param name="host">The host name of the proxy server.</param>
  21345. <param name="port">The proxy server port.</param>
  21346. <exception cref="T:System.ArgumentNullException">
  21347. <paramref name="host"/> is <c>null</c>.
  21348. </exception>
  21349. <exception cref="T:System.ArgumentOutOfRangeException">
  21350. <paramref name="port"/> is not between <c>1</c> and <c>65535</c>.
  21351. </exception>
  21352. <exception cref="T:System.ArgumentException">
  21353. <para>The <paramref name="host"/> is a zero-length string.</para>
  21354. <para>-or-</para>
  21355. <para>The length of <paramref name="host"/> is greater than 255 characters.</para>
  21356. </exception>
  21357. </member>
  21358. <member name="M:MailKit.Net.Proxy.Socks4Client.#ctor(System.String,System.Int32,System.Net.NetworkCredential)">
  21359. <summary>
  21360. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.Socks4Client"/> class.
  21361. </summary>
  21362. <remarks>
  21363. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.Socks4Client"/> class.
  21364. </remarks>
  21365. <param name="host">The host name of the proxy server.</param>
  21366. <param name="port">The proxy server port.</param>
  21367. <param name="credentials">The credentials to use to authenticate with the proxy server.</param>
  21368. <exception cref="T:System.ArgumentNullException">
  21369. <para><paramref name="host"/> is <c>null</c>.</para>
  21370. <para>-or-</para>
  21371. <para><paramref name="credentials"/>is <c>null</c>.</para>
  21372. </exception>
  21373. <exception cref="T:System.ArgumentOutOfRangeException">
  21374. <paramref name="port"/> is not between <c>1</c> and <c>65535</c>.
  21375. </exception>
  21376. <exception cref="T:System.ArgumentException">
  21377. The <paramref name="host"/> is a zero-length string.
  21378. </exception>
  21379. </member>
  21380. <member name="P:MailKit.Net.Proxy.Socks4Client.IsSocks4a">
  21381. <summary>
  21382. Get or set whether this <see cref="T:MailKit.Net.Proxy.Socks4Client"/> is a Socks4a client.
  21383. </summary>
  21384. <remarks>
  21385. Gets or sets whether this <see cref="T:MailKit.Net.Proxy.Socks4Client"/> is a Socks4a client.
  21386. </remarks>
  21387. <value><c>true</c> if is is a Socks4a client; otherwise, <c>false</c>.</value>
  21388. </member>
  21389. <member name="M:MailKit.Net.Proxy.Socks4Client.Connect(System.String,System.Int32,System.Threading.CancellationToken)">
  21390. <summary>
  21391. Connect to the target host.
  21392. </summary>
  21393. <remarks>
  21394. Connects to the target host and port through the proxy server.
  21395. </remarks>
  21396. <returns>The connected socket.</returns>
  21397. <param name="host">The host name of the proxy server.</param>
  21398. <param name="port">The proxy server port.</param>
  21399. <param name="cancellationToken">The cancellation token.</param>
  21400. <exception cref="T:System.ArgumentNullException">
  21401. <paramref name="host"/> is <c>null</c>.
  21402. </exception>
  21403. <exception cref="T:System.ArgumentOutOfRangeException">
  21404. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  21405. </exception>
  21406. <exception cref="T:System.ArgumentException">
  21407. The <paramref name="host"/> is a zero-length string.
  21408. </exception>
  21409. <exception cref="T:System.OperationCanceledException">
  21410. The operation was canceled via the cancellation token.
  21411. </exception>
  21412. <exception cref="T:System.Net.Sockets.SocketException">
  21413. A socket error occurred trying to connect to the remote host.
  21414. </exception>
  21415. <exception cref="T:System.IO.IOException">
  21416. An I/O error occurred.
  21417. </exception>
  21418. </member>
  21419. <member name="M:MailKit.Net.Proxy.Socks4Client.ConnectAsync(System.String,System.Int32,System.Threading.CancellationToken)">
  21420. <summary>
  21421. Asynchronously connect to the target host.
  21422. </summary>
  21423. <remarks>
  21424. Asynchronously connects to the target host and port through the proxy server.
  21425. </remarks>
  21426. <returns>The connected socket.</returns>
  21427. <param name="host">The host name of the proxy server.</param>
  21428. <param name="port">The proxy server port.</param>
  21429. <param name="cancellationToken">The cancellation token.</param>
  21430. <exception cref="T:System.ArgumentNullException">
  21431. <paramref name="host"/> is <c>null</c>.
  21432. </exception>
  21433. <exception cref="T:System.ArgumentOutOfRangeException">
  21434. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  21435. </exception>
  21436. <exception cref="T:System.ArgumentException">
  21437. The <paramref name="host"/> is a zero-length string.
  21438. </exception>
  21439. <exception cref="T:System.OperationCanceledException">
  21440. The operation was canceled via the cancellation token.
  21441. </exception>
  21442. <exception cref="T:System.Net.Sockets.SocketException">
  21443. A socket error occurred trying to connect to the remote host.
  21444. </exception>
  21445. <exception cref="T:System.IO.IOException">
  21446. An I/O error occurred.
  21447. </exception>
  21448. </member>
  21449. <member name="T:MailKit.Net.Proxy.Socks5Client">
  21450. <summary>
  21451. A SOCKS5 proxy client.
  21452. </summary>
  21453. <remarkas>
  21454. A SOCKS5 proxy client.
  21455. </remarkas>
  21456. </member>
  21457. <member name="M:MailKit.Net.Proxy.Socks5Client.#ctor(System.String,System.Int32)">
  21458. <summary>
  21459. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.Socks5Client"/> class.
  21460. </summary>
  21461. <remarks>
  21462. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.Socks5Client"/> class.
  21463. </remarks>
  21464. <param name="host">The host name of the proxy server.</param>
  21465. <param name="port">The proxy server port.</param>
  21466. <exception cref="T:System.ArgumentNullException">
  21467. <paramref name="host"/> is <c>null</c>.
  21468. </exception>
  21469. <exception cref="T:System.ArgumentOutOfRangeException">
  21470. <paramref name="port"/> is not between <c>1</c> and <c>65535</c>.
  21471. </exception>
  21472. <exception cref="T:System.ArgumentException">
  21473. <para>The <paramref name="host"/> is a zero-length string.</para>
  21474. <para>-or-</para>
  21475. <para>The length of <paramref name="host"/> is greater than 255 characters.</para>
  21476. </exception>
  21477. </member>
  21478. <member name="M:MailKit.Net.Proxy.Socks5Client.#ctor(System.String,System.Int32,System.Net.NetworkCredential)">
  21479. <summary>
  21480. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.Socks5Client"/> class.
  21481. </summary>
  21482. <remarks>
  21483. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.Socks5Client"/> class.
  21484. </remarks>
  21485. <param name="host">The host name of the proxy server.</param>
  21486. <param name="port">The proxy server port.</param>
  21487. <param name="credentials">The credentials to use to authenticate with the proxy server.</param>
  21488. <exception cref="T:System.ArgumentNullException">
  21489. <para><paramref name="host"/> is <c>null</c>.</para>
  21490. <para>-or-</para>
  21491. <para><paramref name="credentials"/>is <c>null</c>.</para>
  21492. </exception>
  21493. <exception cref="T:System.ArgumentOutOfRangeException">
  21494. <paramref name="port"/> is not between <c>1</c> and <c>65535</c>.
  21495. </exception>
  21496. <exception cref="T:System.ArgumentException">
  21497. <para>The <paramref name="host"/> is a zero-length string.</para>
  21498. <para>-or-</para>
  21499. <para>The length of <paramref name="host"/> is greater than 255 characters.</para>
  21500. </exception>
  21501. </member>
  21502. <member name="M:MailKit.Net.Proxy.Socks5Client.Connect(System.String,System.Int32,System.Threading.CancellationToken)">
  21503. <summary>
  21504. Connect to the target host.
  21505. </summary>
  21506. <remarks>
  21507. Connects to the target host and port through the proxy server.
  21508. </remarks>
  21509. <returns>The connected socket.</returns>
  21510. <param name="host">The host name of the proxy server.</param>
  21511. <param name="port">The proxy server port.</param>
  21512. <param name="cancellationToken">The cancellation token.</param>
  21513. <exception cref="T:System.ArgumentNullException">
  21514. <paramref name="host"/> is <c>null</c>.
  21515. </exception>
  21516. <exception cref="T:System.ArgumentOutOfRangeException">
  21517. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  21518. </exception>
  21519. <exception cref="T:System.ArgumentException">
  21520. The <paramref name="host"/> is a zero-length string.
  21521. </exception>
  21522. <exception cref="T:System.OperationCanceledException">
  21523. The operation was canceled via the cancellation token.
  21524. </exception>
  21525. <exception cref="T:System.Net.Sockets.SocketException">
  21526. A socket error occurred trying to connect to the remote host.
  21527. </exception>
  21528. <exception cref="T:System.IO.IOException">
  21529. An I/O error occurred.
  21530. </exception>
  21531. </member>
  21532. <member name="M:MailKit.Net.Proxy.Socks5Client.ConnectAsync(System.String,System.Int32,System.Threading.CancellationToken)">
  21533. <summary>
  21534. Asynchronously connect to the target host.
  21535. </summary>
  21536. <remarks>
  21537. Asynchronously connects to the target host and port through the proxy server.
  21538. </remarks>
  21539. <returns>The connected socket.</returns>
  21540. <param name="host">The host name of the proxy server.</param>
  21541. <param name="port">The proxy server port.</param>
  21542. <param name="cancellationToken">The cancellation token.</param>
  21543. <exception cref="T:System.ArgumentNullException">
  21544. <paramref name="host"/> is <c>null</c>.
  21545. </exception>
  21546. <exception cref="T:System.ArgumentOutOfRangeException">
  21547. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  21548. </exception>
  21549. <exception cref="T:System.ArgumentException">
  21550. The <paramref name="host"/> is a zero-length string.
  21551. </exception>
  21552. <exception cref="T:System.OperationCanceledException">
  21553. The operation was canceled via the cancellation token.
  21554. </exception>
  21555. <exception cref="T:System.Net.Sockets.SocketException">
  21556. A socket error occurred trying to connect to the remote host.
  21557. </exception>
  21558. <exception cref="T:System.IO.IOException">
  21559. An I/O error occurred.
  21560. </exception>
  21561. </member>
  21562. <member name="T:MailKit.Net.Proxy.SocksClient">
  21563. <summary>
  21564. An abstract SOCKS proxy client.
  21565. </summary>
  21566. <remarks>
  21567. An abstract SOCKS proxy client.
  21568. </remarks>
  21569. </member>
  21570. <member name="M:MailKit.Net.Proxy.SocksClient.#ctor(System.Int32,System.String,System.Int32)">
  21571. <summary>
  21572. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.SocksClient"/> class.
  21573. </summary>
  21574. <remarks>
  21575. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.SocksClient"/> class.
  21576. </remarks>
  21577. <param name="version">The SOCKS protocol version.</param>
  21578. <param name="host">The host name of the proxy server.</param>
  21579. <param name="port">The proxy server port.</param>
  21580. <exception cref="T:System.ArgumentNullException">
  21581. <paramref name="host"/> is <c>null</c>.
  21582. </exception>
  21583. <exception cref="T:System.ArgumentOutOfRangeException">
  21584. <paramref name="port"/> is not between <c>1</c> and <c>65535</c>.
  21585. </exception>
  21586. <exception cref="T:System.ArgumentException">
  21587. The <paramref name="host"/> is a zero-length string.
  21588. </exception>
  21589. </member>
  21590. <member name="M:MailKit.Net.Proxy.SocksClient.#ctor(System.Int32,System.String,System.Int32,System.Net.NetworkCredential)">
  21591. <summary>
  21592. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.SocksClient"/> class.
  21593. </summary>
  21594. <remarks>
  21595. Initializes a new instance of the <see cref="T:MailKit.Net.Proxy.SocksClient"/> class.
  21596. </remarks>
  21597. <param name="version">The SOCKS protocol version.</param>
  21598. <param name="host">The host name of the proxy server.</param>
  21599. <param name="port">The proxy server port.</param>
  21600. <param name="credentials">The credentials to use to authenticate with the proxy server.</param>
  21601. <exception cref="T:System.ArgumentNullException">
  21602. <para><paramref name="host"/> is <c>null</c>.</para>
  21603. <para>-or-</para>
  21604. <para><paramref name="credentials"/>is <c>null</c>.</para>
  21605. </exception>
  21606. <exception cref="T:System.ArgumentOutOfRangeException">
  21607. <paramref name="port"/> is not between <c>1</c> and <c>65535</c>.
  21608. </exception>
  21609. <exception cref="T:System.ArgumentException">
  21610. The <paramref name="host"/> is a zero-length string.
  21611. </exception>
  21612. </member>
  21613. <member name="P:MailKit.Net.Proxy.SocksClient.SocksVersion">
  21614. <summary>
  21615. Get the SOCKS protocol version.
  21616. </summary>
  21617. <remarks>
  21618. Gets the SOCKS protocol version.
  21619. </remarks>
  21620. <value>The SOCKS protocol version.</value>
  21621. </member>
  21622. <member name="T:MailKit.Net.Smtp.SmtpClient">
  21623. <summary>
  21624. An SMTP client that can be used to send email messages.
  21625. </summary>
  21626. <remarks>
  21627. <para>The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> class supports both the "smtp" and "smtps" protocols. The "smtp"
  21628. protocol makes a clear-text connection to the SMTP server and does not use SSL or TLS unless the SMTP
  21629. server supports the <a href="https://tools.ietf.org/html/rfc3207">STARTTLS</a> extension. The "smtps"
  21630. protocol, however, connects to the SMTP server using an SSL-wrapped connection.</para>
  21631. <para>The connection established by any of the
  21632. <a href="Overload_MailKit_Net_Smtp_SmtpClient_Connect.htm">Connect</a> methods may be re-used if an
  21633. application wishes to send multiple messages to the same SMTP server. Since connecting and authenticating
  21634. can be expensive operations, re-using a connection can significantly improve performance when sending a
  21635. large number of messages to the same SMTP server over a short period of time.</para>
  21636. </remarks>
  21637. <example>
  21638. <code language="c#" source="Examples\SmtpExamples.cs" region="SendMessages" />
  21639. </example>
  21640. </member>
  21641. <member name="M:MailKit.Net.Smtp.SmtpClient.SendCommandAsync(System.String,System.Threading.CancellationToken)">
  21642. <summary>
  21643. Asynchronously send a custom command to the SMTP server.
  21644. </summary>
  21645. <remarks>
  21646. <para>Asynchronously sends a custom command to the SMTP server.</para>
  21647. <note type="note">The command string should not include the terminating <c>\r\n</c> sequence.</note>
  21648. </remarks>
  21649. <returns>The command response.</returns>
  21650. <param name="command">The command.</param>
  21651. <param name="cancellationToken">The cancellation token.</param>
  21652. <exception cref="T:System.ArgumentNullException">
  21653. <paramref name="command"/> is <c>null</c>.
  21654. </exception>
  21655. <exception cref="T:System.ObjectDisposedException">
  21656. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  21657. </exception>
  21658. <exception cref="T:MailKit.ServiceNotConnectedException">
  21659. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  21660. </exception>
  21661. <exception cref="T:System.OperationCanceledException">
  21662. The operation has been canceled.
  21663. </exception>
  21664. <exception cref="T:System.IO.IOException">
  21665. An I/O error occurred.
  21666. </exception>
  21667. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  21668. The SMTP command failed.
  21669. </exception>
  21670. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  21671. An SMTP protocol exception occurred.
  21672. </exception>
  21673. </member>
  21674. <member name="M:MailKit.Net.Smtp.SmtpClient.AuthenticateAsync(MailKit.Security.SaslMechanism,System.Threading.CancellationToken)">
  21675. <summary>
  21676. Asynchronously authenticate using the specified SASL mechanism.
  21677. </summary>
  21678. <remarks>
  21679. <para>Authenticates using the specified SASL mechanism.</para>
  21680. <para>For a list of available SASL authentication mechanisms supported by the server,
  21681. check the <see cref="P:MailKit.Net.Smtp.SmtpClient.AuthenticationMechanisms"/> property after the service has been
  21682. connected.</para>
  21683. </remarks>
  21684. <returns>An asynchronous task context.</returns>
  21685. <param name="mechanism">The SASL mechanism.</param>
  21686. <param name="cancellationToken">The cancellation token.</param>
  21687. <exception cref="T:System.ArgumentNullException">
  21688. <paramref name="mechanism"/> is <c>null</c>.
  21689. </exception>
  21690. <exception cref="T:MailKit.ServiceNotConnectedException">
  21691. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  21692. </exception>
  21693. <exception cref="T:System.InvalidOperationException">
  21694. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is already authenticated.
  21695. </exception>
  21696. <exception cref="T:System.NotSupportedException">
  21697. The SMTP server does not support authentication.
  21698. </exception>
  21699. <exception cref="T:System.OperationCanceledException">
  21700. The operation was canceled via the cancellation token.
  21701. </exception>
  21702. <exception cref="T:MailKit.Security.AuthenticationException">
  21703. Authentication using the supplied credentials has failed.
  21704. </exception>
  21705. <exception cref="T:MailKit.Security.SaslException">
  21706. A SASL authentication error occurred.
  21707. </exception>
  21708. <exception cref="T:System.IO.IOException">
  21709. An I/O error occurred.
  21710. </exception>
  21711. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  21712. The SMTP command failed.
  21713. </exception>
  21714. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  21715. An SMTP protocol error occurred.
  21716. </exception>
  21717. </member>
  21718. <member name="M:MailKit.Net.Smtp.SmtpClient.AuthenticateAsync(System.Text.Encoding,System.Net.ICredentials,System.Threading.CancellationToken)">
  21719. <summary>
  21720. Asynchronously authenticate using the supplied credentials.
  21721. </summary>
  21722. <remarks>
  21723. <para>If the SMTP server supports authentication, then the SASL mechanisms
  21724. that both the client and server support are tried in order of greatest
  21725. security to weakest security. Once a SASL authentication mechanism is
  21726. found that both client and server support, the credentials are used to
  21727. authenticate.</para>
  21728. <para>If, on the other hand, authentication is not supported by the SMTP
  21729. server, then this method will throw <see cref="T:System.NotSupportedException"/>.
  21730. The <see cref="P:MailKit.Net.Smtp.SmtpClient.Capabilities"/> property can be checked for the
  21731. <see cref="F:MailKit.Net.Smtp.SmtpCapabilities.Authentication"/> flag to make sure the
  21732. SMTP server supports authentication before calling this method.</para>
  21733. <note type="tip"> To prevent the usage of certain authentication mechanisms,
  21734. simply remove them from the <see cref="P:MailKit.Net.Smtp.SmtpClient.AuthenticationMechanisms"/> hash set
  21735. before calling this method.</note>
  21736. </remarks>
  21737. <returns>An asynchronous task context.</returns>
  21738. <param name="encoding">The text encoding to use for the user's credentials.</param>
  21739. <param name="credentials">The user's credentials.</param>
  21740. <param name="cancellationToken">The cancellation token.</param>
  21741. <exception cref="T:System.ArgumentNullException">
  21742. <para><paramref name="encoding"/> is <c>null</c>.</para>
  21743. <para>-or-</para>
  21744. <para><paramref name="credentials"/> is <c>null</c>.</para>
  21745. </exception>
  21746. <exception cref="T:MailKit.ServiceNotConnectedException">
  21747. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  21748. </exception>
  21749. <exception cref="T:System.InvalidOperationException">
  21750. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is already authenticated.
  21751. </exception>
  21752. <exception cref="T:System.NotSupportedException">
  21753. The SMTP server does not support authentication.
  21754. </exception>
  21755. <exception cref="T:System.OperationCanceledException">
  21756. The operation was canceled via the cancellation token.
  21757. </exception>
  21758. <exception cref="T:MailKit.Security.AuthenticationException">
  21759. Authentication using the supplied credentials has failed.
  21760. </exception>
  21761. <exception cref="T:MailKit.Security.SaslException">
  21762. A SASL authentication error occurred.
  21763. </exception>
  21764. <exception cref="T:System.IO.IOException">
  21765. An I/O error occurred.
  21766. </exception>
  21767. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  21768. The SMTP command failed.
  21769. </exception>
  21770. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  21771. An SMTP protocol error occurred.
  21772. </exception>
  21773. </member>
  21774. <member name="M:MailKit.Net.Smtp.SmtpClient.ConnectAsync(System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  21775. <summary>
  21776. Asynchronously establish a connection to the specified SMTP or SMTP/S server.
  21777. </summary>
  21778. <remarks>
  21779. <para>Establishes a connection to the specified SMTP or SMTP/S server.</para>
  21780. <para>If the <paramref name="port"/> has a value of <c>0</c>, then the
  21781. <paramref name="options"/> parameter is used to determine the default port to
  21782. connect to. The default port used with <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>
  21783. is <c>465</c>. All other values will use a default port of <c>25</c>.</para>
  21784. <para>If the <paramref name="options"/> has a value of
  21785. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  21786. to determine the default security options. If the <paramref name="port"/> has a value
  21787. of <c>465</c>, then the default options used will be
  21788. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  21789. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  21790. <para>Once a connection is established, properties such as
  21791. <see cref="P:MailKit.Net.Smtp.SmtpClient.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Smtp.SmtpClient.Capabilities"/> will be
  21792. populated.</para>
  21793. <note type="note">The connection established by any of the
  21794. <a href="Overload_MailKit_Net_Smtp_SmtpClient_ConnectAsync.htm">Connect</a>
  21795. methods may be re-used if an application wishes to send multiple messages
  21796. to the same SMTP server. Since connecting and authenticating can be expensive
  21797. operations, re-using a connection can significantly improve performance when
  21798. sending a large number of messages to the same SMTP server over a short
  21799. period of time.</note>
  21800. </remarks>
  21801. <example>
  21802. <code language="c#" source="Examples\SmtpExamples.cs" region="SendMessage"/>
  21803. </example>
  21804. <returns>An asynchronous task context.</returns>
  21805. <param name="host">The host name to connect to.</param>
  21806. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  21807. <param name="options">The secure socket options to when connecting.</param>
  21808. <param name="cancellationToken">The cancellation token.</param>
  21809. <exception cref="T:System.ArgumentNullException">
  21810. <paramref name="host"/> is <c>null</c>.
  21811. </exception>
  21812. <exception cref="T:System.ArgumentOutOfRangeException">
  21813. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  21814. </exception>
  21815. <exception cref="T:System.ArgumentException">
  21816. The <paramref name="host"/> is a zero-length string.
  21817. </exception>
  21818. <exception cref="T:System.ObjectDisposedException">
  21819. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  21820. </exception>
  21821. <exception cref="T:System.InvalidOperationException">
  21822. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is already connected.
  21823. </exception>
  21824. <exception cref="T:System.NotSupportedException">
  21825. <paramref name="options"/> was set to
  21826. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  21827. and the SMTP server does not support the STARTTLS extension.
  21828. </exception>
  21829. <exception cref="T:System.OperationCanceledException">
  21830. The operation was canceled.
  21831. </exception>
  21832. <exception cref="T:System.Net.Sockets.SocketException">
  21833. A socket error occurred trying to connect to the remote host.
  21834. </exception>
  21835. <exception cref="T:MailKit.Security.SslHandshakeException">
  21836. An error occurred during the SSL/TLS negotiations.
  21837. </exception>
  21838. <exception cref="T:System.IO.IOException">
  21839. An I/O error occurred.
  21840. </exception>
  21841. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  21842. An SMTP command failed.
  21843. </exception>
  21844. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  21845. An SMTP protocol error occurred.
  21846. </exception>
  21847. </member>
  21848. <member name="M:MailKit.Net.Smtp.SmtpClient.ConnectAsync(System.Net.Sockets.Socket,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  21849. <summary>
  21850. Asynchronously establish a connection to the specified SMTP or SMTP/S server using the provided socket.
  21851. </summary>
  21852. <remarks>
  21853. <para>Establishes a connection to the specified SMTP or SMTP/S server using the provided socket.</para>
  21854. <para>If the <paramref name="options"/> has a value of
  21855. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  21856. to determine the default security options. If the <paramref name="port"/> has a value
  21857. of <c>465</c>, then the default options used will be
  21858. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  21859. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  21860. <para>Once a connection is established, properties such as
  21861. <see cref="P:MailKit.Net.Smtp.SmtpClient.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Smtp.SmtpClient.Capabilities"/> will be
  21862. populated.</para>
  21863. <note type="info">With the exception of using the <paramref name="port"/> to determine the
  21864. default <see cref="T:MailKit.Security.SecureSocketOptions"/> to use when the <paramref name="options"/> value
  21865. is <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, the <paramref name="host"/> and
  21866. <paramref name="port"/> parameters are only used for logging purposes.</note>
  21867. </remarks>
  21868. <returns>An asynchronous task context.</returns>
  21869. <param name="socket">The socket to use for the connection.</param>
  21870. <param name="host">The host name to connect to.</param>
  21871. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  21872. <param name="options">The secure socket options to when connecting.</param>
  21873. <param name="cancellationToken">The cancellation token.</param>
  21874. <exception cref="T:System.ArgumentNullException">
  21875. <para><paramref name="socket"/> is <c>null</c>.</para>
  21876. <para>-or-</para>
  21877. <para><paramref name="host"/> is <c>null</c>.</para>
  21878. </exception>
  21879. <exception cref="T:System.ArgumentOutOfRangeException">
  21880. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  21881. </exception>
  21882. <exception cref="T:System.ArgumentException">
  21883. <para><paramref name="socket"/> is not connected.</para>
  21884. <para>-or-</para>
  21885. <para>The <paramref name="host"/> is a zero-length string.</para>
  21886. </exception>
  21887. <exception cref="T:System.ObjectDisposedException">
  21888. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  21889. </exception>
  21890. <exception cref="T:System.InvalidOperationException">
  21891. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is already connected.
  21892. </exception>
  21893. <exception cref="T:System.NotSupportedException">
  21894. <paramref name="options"/> was set to
  21895. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  21896. and the SMTP server does not support the STARTTLS extension.
  21897. </exception>
  21898. <exception cref="T:System.OperationCanceledException">
  21899. The operation was canceled.
  21900. </exception>
  21901. <exception cref="T:MailKit.Security.SslHandshakeException">
  21902. An error occurred during the SSL/TLS negotiations.
  21903. </exception>
  21904. <exception cref="T:System.IO.IOException">
  21905. An I/O error occurred.
  21906. </exception>
  21907. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  21908. An SMTP command failed.
  21909. </exception>
  21910. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  21911. An SMTP protocol error occurred.
  21912. </exception>
  21913. </member>
  21914. <member name="M:MailKit.Net.Smtp.SmtpClient.ConnectAsync(System.IO.Stream,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  21915. <summary>
  21916. Asynchronously establish a connection to the specified SMTP or SMTP/S server using the provided socket.
  21917. </summary>
  21918. <remarks>
  21919. <para>Establishes a connection to the specified SMTP or SMTP/S server using the provided socket.</para>
  21920. <para>If the <paramref name="options"/> has a value of
  21921. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  21922. to determine the default security options. If the <paramref name="port"/> has a value
  21923. of <c>465</c>, then the default options used will be
  21924. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  21925. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  21926. <para>Once a connection is established, properties such as
  21927. <see cref="P:MailKit.Net.Smtp.SmtpClient.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Smtp.SmtpClient.Capabilities"/> will be
  21928. populated.</para>
  21929. <note type="info">With the exception of using the <paramref name="port"/> to determine the
  21930. default <see cref="T:MailKit.Security.SecureSocketOptions"/> to use when the <paramref name="options"/> value
  21931. is <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, the <paramref name="host"/> and
  21932. <paramref name="port"/> parameters are only used for logging purposes.</note>
  21933. </remarks>
  21934. <returns>An asynchronous task context.</returns>
  21935. <param name="stream">The stream to use for the connection.</param>
  21936. <param name="host">The host name to connect to.</param>
  21937. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  21938. <param name="options">The secure socket options to when connecting.</param>
  21939. <param name="cancellationToken">The cancellation token.</param>
  21940. <exception cref="T:System.ArgumentNullException">
  21941. <para><paramref name="stream"/> is <c>null</c>.</para>
  21942. <para>-or-</para>
  21943. <para><paramref name="host"/> is <c>null</c>.</para>
  21944. </exception>
  21945. <exception cref="T:System.ArgumentOutOfRangeException">
  21946. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  21947. </exception>
  21948. <exception cref="T:System.ArgumentException">
  21949. The <paramref name="host"/> is a zero-length string.
  21950. </exception>
  21951. <exception cref="T:System.ObjectDisposedException">
  21952. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  21953. </exception>
  21954. <exception cref="T:System.InvalidOperationException">
  21955. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is already connected.
  21956. </exception>
  21957. <exception cref="T:System.NotSupportedException">
  21958. <paramref name="options"/> was set to
  21959. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  21960. and the SMTP server does not support the STARTTLS extension.
  21961. </exception>
  21962. <exception cref="T:System.OperationCanceledException">
  21963. The operation was canceled.
  21964. </exception>
  21965. <exception cref="T:MailKit.Security.SslHandshakeException">
  21966. An error occurred during the SSL/TLS negotiations.
  21967. </exception>
  21968. <exception cref="T:System.IO.IOException">
  21969. An I/O error occurred.
  21970. </exception>
  21971. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  21972. An SMTP command failed.
  21973. </exception>
  21974. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  21975. An SMTP protocol error occurred.
  21976. </exception>
  21977. </member>
  21978. <member name="M:MailKit.Net.Smtp.SmtpClient.DisconnectAsync(System.Boolean,System.Threading.CancellationToken)">
  21979. <summary>
  21980. Asynchronously disconnect the service.
  21981. </summary>
  21982. <remarks>
  21983. If <paramref name="quit"/> is <c>true</c>, a <c>QUIT</c> command will be issued in order to disconnect cleanly.
  21984. </remarks>
  21985. <example>
  21986. <code language="c#" source="Examples\SmtpExamples.cs" region="SendMessage"/>
  21987. </example>
  21988. <returns>An asynchronous task context.</returns>
  21989. <param name="quit">If set to <c>true</c>, a <c>QUIT</c> command will be issued in order to disconnect cleanly.</param>
  21990. <param name="cancellationToken">The cancellation token.</param>
  21991. <exception cref="T:System.ObjectDisposedException">
  21992. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  21993. </exception>
  21994. </member>
  21995. <member name="M:MailKit.Net.Smtp.SmtpClient.NoOpAsync(System.Threading.CancellationToken)">
  21996. <summary>
  21997. Asynchronously ping the SMTP server to keep the connection alive.
  21998. </summary>
  21999. <remarks>Mail servers, if left idle for too long, will automatically drop the connection.</remarks>
  22000. <returns>An asynchronous task context.</returns>
  22001. <param name="cancellationToken">The cancellation token.</param>
  22002. <exception cref="T:System.ObjectDisposedException">
  22003. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  22004. </exception>
  22005. <exception cref="T:MailKit.ServiceNotConnectedException">
  22006. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  22007. </exception>
  22008. <exception cref="T:System.OperationCanceledException">
  22009. The operation was canceled.
  22010. </exception>
  22011. <exception cref="T:System.IO.IOException">
  22012. An I/O error occurred.
  22013. </exception>
  22014. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  22015. The SMTP command failed.
  22016. </exception>
  22017. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  22018. An SMTP protocol error occurred.
  22019. </exception>
  22020. </member>
  22021. <member name="M:MailKit.Net.Smtp.SmtpClient.SendAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  22022. <summary>
  22023. Asynchronously send the specified message.
  22024. </summary>
  22025. <remarks>
  22026. <para>Sends the specified message.</para>
  22027. <para>The sender address is determined by checking the following
  22028. message headers (in order of precedence): Resent-Sender,
  22029. Resent-From, Sender, and From.</para>
  22030. <para>If either the Resent-Sender or Resent-From addresses are present,
  22031. the recipients are collected from the Resent-To, Resent-Cc, and
  22032. Resent-Bcc headers, otherwise the To, Cc, and Bcc headers are used.</para>
  22033. </remarks>
  22034. <example>
  22035. <code language="c#" source="Examples\SmtpExamples.cs" region="SendMessageWithOptions"/>
  22036. </example>
  22037. <returns>An asynchronous task context.</returns>
  22038. <param name="options">The formatting options.</param>
  22039. <param name="message">The message.</param>
  22040. <param name="cancellationToken">The cancellation token.</param>
  22041. <param name="progress">The progress reporting mechanism.</param>
  22042. <exception cref="T:System.ArgumentNullException">
  22043. <para><paramref name="options"/> is <c>null</c>.</para>
  22044. <para>-or-</para>
  22045. <para><paramref name="message"/> is <c>null</c>.</para>
  22046. </exception>
  22047. <exception cref="T:System.ObjectDisposedException">
  22048. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  22049. </exception>
  22050. <exception cref="T:MailKit.ServiceNotConnectedException">
  22051. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  22052. </exception>
  22053. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  22054. Authentication is required before sending a message.
  22055. </exception>
  22056. <exception cref="T:System.InvalidOperationException">
  22057. <para>A sender has not been specified.</para>
  22058. <para>-or-</para>
  22059. <para>No recipients have been specified.</para>
  22060. </exception>
  22061. <exception cref="T:System.NotSupportedException">
  22062. Internationalized formatting was requested but is not supported by the server.
  22063. </exception>
  22064. <exception cref="T:System.OperationCanceledException">
  22065. The operation has been canceled.
  22066. </exception>
  22067. <exception cref="T:System.IO.IOException">
  22068. An I/O error occurred.
  22069. </exception>
  22070. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  22071. The SMTP command failed.
  22072. </exception>
  22073. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  22074. An SMTP protocol exception occurred.
  22075. </exception>
  22076. </member>
  22077. <member name="M:MailKit.Net.Smtp.SmtpClient.SendAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,MimeKit.MailboxAddress,System.Collections.Generic.IEnumerable{MimeKit.MailboxAddress},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  22078. <summary>
  22079. Asynchronously send the specified message using the supplied sender and recipients.
  22080. </summary>
  22081. <remarks>
  22082. Sends the message by uploading it to an SMTP server using the supplied sender and recipients.
  22083. </remarks>
  22084. <returns>An asynchronous task context.</returns>
  22085. <param name="options">The formatting options.</param>
  22086. <param name="message">The message.</param>
  22087. <param name="sender">The mailbox address to use for sending the message.</param>
  22088. <param name="recipients">The mailbox addresses that should receive the message.</param>
  22089. <param name="cancellationToken">The cancellation token.</param>
  22090. <param name="progress">The progress reporting mechanism.</param>
  22091. <exception cref="T:System.ArgumentNullException">
  22092. <para><paramref name="options"/> is <c>null</c>.</para>
  22093. <para>-or-</para>
  22094. <para><paramref name="message"/> is <c>null</c>.</para>
  22095. <para>-or-</para>
  22096. <para><paramref name="sender"/> is <c>null</c>.</para>
  22097. <para>-or-</para>
  22098. <para><paramref name="recipients"/> is <c>null</c>.</para>
  22099. </exception>
  22100. <exception cref="T:System.ObjectDisposedException">
  22101. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  22102. </exception>
  22103. <exception cref="T:MailKit.ServiceNotConnectedException">
  22104. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  22105. </exception>
  22106. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  22107. Authentication is required before sending a message.
  22108. </exception>
  22109. <exception cref="T:System.InvalidOperationException">
  22110. <para>A sender has not been specified.</para>
  22111. <para>-or-</para>
  22112. <para>No recipients have been specified.</para>
  22113. </exception>
  22114. <exception cref="T:System.NotSupportedException">
  22115. Internationalized formatting was requested but is not supported by the server.
  22116. </exception>
  22117. <exception cref="T:System.OperationCanceledException">
  22118. The operation has been canceled.
  22119. </exception>
  22120. <exception cref="T:System.IO.IOException">
  22121. An I/O error occurred.
  22122. </exception>
  22123. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  22124. The SMTP command failed.
  22125. </exception>
  22126. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  22127. An SMTP protocol exception occurred.
  22128. </exception>
  22129. </member>
  22130. <member name="M:MailKit.Net.Smtp.SmtpClient.ExpandAsync(System.String,System.Threading.CancellationToken)">
  22131. <summary>
  22132. Asynchronously expand a mailing address alias.
  22133. </summary>
  22134. <remarks>
  22135. Expands a mailing address alias.
  22136. </remarks>
  22137. <returns>The expanded list of mailbox addresses.</returns>
  22138. <param name="alias">The mailing address alias.</param>
  22139. <param name="cancellationToken">The cancellation token.</param>
  22140. <exception cref="T:System.ArgumentNullException">
  22141. <paramref name="alias"/> is <c>null</c>.
  22142. </exception>
  22143. <exception cref="T:System.ArgumentException">
  22144. <paramref name="alias"/> is an empty string.
  22145. </exception>
  22146. <exception cref="T:System.ObjectDisposedException">
  22147. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  22148. </exception>
  22149. <exception cref="T:MailKit.ServiceNotConnectedException">
  22150. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  22151. </exception>
  22152. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  22153. Authentication is required before verifying the existence of an address.
  22154. </exception>
  22155. <exception cref="T:System.OperationCanceledException">
  22156. The operation has been canceled.
  22157. </exception>
  22158. <exception cref="T:System.IO.IOException">
  22159. An I/O error occurred.
  22160. </exception>
  22161. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  22162. The SMTP command failed.
  22163. </exception>
  22164. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  22165. An SMTP protocol exception occurred.
  22166. </exception>
  22167. </member>
  22168. <member name="M:MailKit.Net.Smtp.SmtpClient.VerifyAsync(System.String,System.Threading.CancellationToken)">
  22169. <summary>
  22170. Asynchronously verify the existence of a mailbox address.
  22171. </summary>
  22172. <remarks>
  22173. Verifies the existence a mailbox address with the SMTP server, returning the expanded
  22174. mailbox address if it exists.
  22175. </remarks>
  22176. <returns>The expanded mailbox address.</returns>
  22177. <param name="address">The mailbox address.</param>
  22178. <param name="cancellationToken">The cancellation token.</param>
  22179. <exception cref="T:System.ArgumentNullException">
  22180. <paramref name="address"/> is <c>null</c>.
  22181. </exception>
  22182. <exception cref="T:System.ArgumentException">
  22183. <paramref name="address"/> is an empty string.
  22184. </exception>
  22185. <exception cref="T:System.ObjectDisposedException">
  22186. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  22187. </exception>
  22188. <exception cref="T:MailKit.ServiceNotConnectedException">
  22189. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  22190. </exception>
  22191. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  22192. Authentication is required before verifying the existence of an address.
  22193. </exception>
  22194. <exception cref="T:System.OperationCanceledException">
  22195. The operation has been canceled.
  22196. </exception>
  22197. <exception cref="T:System.IO.IOException">
  22198. An I/O error occurred.
  22199. </exception>
  22200. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  22201. The SMTP command failed.
  22202. </exception>
  22203. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  22204. An SMTP protocol exception occurred.
  22205. </exception>
  22206. </member>
  22207. <member name="M:MailKit.Net.Smtp.SmtpClient.#ctor">
  22208. <summary>
  22209. Initializes a new instance of the <see cref="T:MailKit.Net.Smtp.SmtpClient"/> class.
  22210. </summary>
  22211. <remarks>
  22212. Before you can send messages with the <see cref="T:MailKit.Net.Smtp.SmtpClient"/>, you must first call one of
  22213. the <a href="Overload_MailKit_Net_Smtp_SmtpClient_Connect.htm">Connect</a> methods.
  22214. Depending on whether the SMTP server requires authenticating or not, you may also need to
  22215. authenticate using one of the
  22216. <a href="Overload_MailKit_Net_Smtp_SmtpClient_Authenticate.htm">Authenticate</a> methods.
  22217. </remarks>
  22218. <example>
  22219. <code language="c#" source="Examples\SmtpExamples.cs" region="SendMessages" />
  22220. </example>
  22221. </member>
  22222. <member name="M:MailKit.Net.Smtp.SmtpClient.#ctor(MailKit.IProtocolLogger)">
  22223. <summary>
  22224. Initializes a new instance of the <see cref="T:MailKit.Net.Smtp.SmtpClient"/> class.
  22225. </summary>
  22226. <remarks>
  22227. Before you can send messages with the <see cref="T:MailKit.Net.Smtp.SmtpClient"/>, you must first call one of
  22228. the <a href="Overload_MailKit_Net_Smtp_SmtpClient_Connect.htm">Connect</a> methods.
  22229. Depending on whether the SMTP server requires authenticating or not, you may also need to
  22230. authenticate using one of the
  22231. <a href="Overload_MailKit_Net_Smtp_SmtpClient_Authenticate.htm">Authenticate</a> methods.
  22232. </remarks>
  22233. <param name="protocolLogger">The protocol logger.</param>
  22234. <exception cref="T:System.ArgumentNullException">
  22235. <paramref name="protocolLogger"/> is <c>null</c>.
  22236. </exception>
  22237. <example>
  22238. <code language="c#" source="Examples\SmtpExamples.cs" region="ProtocolLogger"/>
  22239. </example>
  22240. </member>
  22241. <member name="P:MailKit.Net.Smtp.SmtpClient.Stream">
  22242. <summary>
  22243. Get the underlying SMTP stream.
  22244. </summary>
  22245. <remarks>
  22246. Gets the underlying SMTP stream.
  22247. </remarks>
  22248. <value>The SMTP stream.</value>
  22249. </member>
  22250. <member name="P:MailKit.Net.Smtp.SmtpClient.SyncRoot">
  22251. <summary>
  22252. Gets an object that can be used to synchronize access to the SMTP server.
  22253. </summary>
  22254. <remarks>
  22255. <para>Gets an object that can be used to synchronize access to the SMTP server between multiple threads.</para>
  22256. <para>When using <see cref="T:MailKit.Net.Smtp.SmtpClient"/> methods from multiple threads, it is important to lock the
  22257. <see cref="P:MailKit.Net.Smtp.SmtpClient.SyncRoot"/> object for thread safety.</para>
  22258. </remarks>
  22259. <value>The lock object.</value>
  22260. </member>
  22261. <member name="P:MailKit.Net.Smtp.SmtpClient.Protocol">
  22262. <summary>
  22263. Get the protocol supported by the message service.
  22264. </summary>
  22265. <remarks>
  22266. Gets the protocol supported by the message service.
  22267. </remarks>
  22268. <value>The protocol.</value>
  22269. </member>
  22270. <member name="P:MailKit.Net.Smtp.SmtpClient.Capabilities">
  22271. <summary>
  22272. Get the capabilities supported by the SMTP server.
  22273. </summary>
  22274. <remarks>
  22275. The capabilities will not be known until a successful connection has been made
  22276. and may change once the client is authenticated.
  22277. </remarks>
  22278. <example>
  22279. <code language="c#" source="Examples\SmtpExamples.cs" region="Capabilities"/>
  22280. </example>
  22281. <value>The capabilities.</value>
  22282. <exception cref="T:System.ArgumentException">
  22283. Capabilities cannot be enabled, they may only be disabled.
  22284. </exception>
  22285. </member>
  22286. <member name="P:MailKit.Net.Smtp.SmtpClient.LocalDomain">
  22287. <summary>
  22288. Get or set the local domain.
  22289. </summary>
  22290. <remarks>
  22291. The local domain is used in the HELO or EHLO commands sent to
  22292. the SMTP server. If left unset, the local IP address will be
  22293. used instead.
  22294. </remarks>
  22295. <value>The local domain.</value>
  22296. </member>
  22297. <member name="P:MailKit.Net.Smtp.SmtpClient.PreferSendAsBinaryData">
  22298. <summary>
  22299. Get whether or not the BDAT command is preferred over the DATA command.
  22300. </summary>
  22301. <remarks>
  22302. <para>Gets whether or not the <c>BDAT</c> command is preferred over the standard <c>DATA</c>
  22303. command.</para>
  22304. <para>The <c>BDAT</c> command is normally only used when the message being sent contains binary data
  22305. (e.g. one mor more MIME parts contains a <c>Content-Transfer-Encoding: binary</c> header). This
  22306. option provides a way to override this behavior, forcing the <see cref="T:MailKit.Net.Smtp.SmtpClient"/> to send
  22307. messages using the <c>BDAT</c> command instead of the <c>DATA</c> command even when it is not
  22308. necessary to do so.</para>
  22309. </remarks>
  22310. <value><c>true</c> if the <c>BDAT</c> command is preferred over the <c>DATA</c> command; otherwise, <c>false</c>.</value>
  22311. </member>
  22312. <member name="P:MailKit.Net.Smtp.SmtpClient.MaxSize">
  22313. <summary>
  22314. Get the maximum message size supported by the server.
  22315. </summary>
  22316. <remarks>
  22317. <para>The maximum message size will not be known until a successful connection has
  22318. been made and may change once the client is authenticated.</para>
  22319. <note type="note">This value is only relevant if the <see cref="P:MailKit.Net.Smtp.SmtpClient.Capabilities"/> includes
  22320. the <see cref="F:MailKit.Net.Smtp.SmtpCapabilities.Size"/> flag.</note>
  22321. </remarks>
  22322. <example>
  22323. <code language="c#" source="Examples\SmtpExamples.cs" region="Capabilities"/>
  22324. </example>
  22325. <value>The maximum message size supported by the server.</value>
  22326. </member>
  22327. <member name="P:MailKit.Net.Smtp.SmtpClient.AuthenticationMechanisms">
  22328. <summary>
  22329. Get the authentication mechanisms supported by the SMTP server.
  22330. </summary>
  22331. <remarks>
  22332. <para>The authentication mechanisms are queried as part of the connection
  22333. process.</para>
  22334. <note type="tip">To prevent the usage of certain authentication mechanisms,
  22335. simply remove them from the <see cref="P:MailKit.Net.Smtp.SmtpClient.AuthenticationMechanisms"/> hash set
  22336. before authenticating.</note>
  22337. </remarks>
  22338. <example>
  22339. <code language="c#" source="Examples\SmtpExamples.cs" region="Capabilities"/>
  22340. </example>
  22341. <value>The authentication mechanisms.</value>
  22342. </member>
  22343. <member name="P:MailKit.Net.Smtp.SmtpClient.Timeout">
  22344. <summary>
  22345. Get or set the timeout for network streaming operations, in milliseconds.
  22346. </summary>
  22347. <remarks>
  22348. Gets or sets the underlying socket stream's <see cref="P:System.IO.Stream.ReadTimeout"/>
  22349. and <see cref="P:System.IO.Stream.WriteTimeout"/> values.
  22350. </remarks>
  22351. <value>The timeout in milliseconds.</value>
  22352. </member>
  22353. <member name="P:MailKit.Net.Smtp.SmtpClient.IsConnected">
  22354. <summary>
  22355. Get whether or not the client is currently connected to an SMTP server.
  22356. </summary>
  22357. <remarks>
  22358. <para>The <see cref="P:MailKit.Net.Smtp.SmtpClient.IsConnected"/> state is set to <c>true</c> immediately after
  22359. one of the <a href="Overload_MailKit_Net_Smtp_SmtpClient_Connect.htm">Connect</a>
  22360. methods succeeds and is not set back to <c>false</c> until either the client
  22361. is disconnected via <see cref="M:MailKit.Net.Smtp.SmtpClient.Disconnect(System.Boolean,System.Threading.CancellationToken)"/> or until an
  22362. <see cref="T:MailKit.Net.Smtp.SmtpProtocolException"/> is thrown while attempting to read or write to
  22363. the underlying network socket.</para>
  22364. <para>When an <see cref="T:MailKit.Net.Smtp.SmtpProtocolException"/> is caught, the connection state of the
  22365. <see cref="T:MailKit.Net.Smtp.SmtpClient"/> should be checked before continuing.</para>
  22366. </remarks>
  22367. <example>
  22368. <code language="c#" source="Examples\SmtpExamples.cs" region="ExceptionHandling"/>
  22369. </example>
  22370. <value><c>true</c> if the client is connected; otherwise, <c>false</c>.</value>
  22371. </member>
  22372. <member name="P:MailKit.Net.Smtp.SmtpClient.IsSecure">
  22373. <summary>
  22374. Get whether or not the connection is secure (typically via SSL or TLS).
  22375. </summary>
  22376. <remarks>
  22377. Gets whether or not the connection is secure (typically via SSL or TLS).
  22378. </remarks>
  22379. <value><c>true</c> if the connection is secure; otherwise, <c>false</c>.</value>
  22380. </member>
  22381. <member name="P:MailKit.Net.Smtp.SmtpClient.IsAuthenticated">
  22382. <summary>
  22383. Get whether or not the client is currently authenticated with the SMTP server.
  22384. </summary>
  22385. <remarks>
  22386. <para>Gets whether or not the client is currently authenticated with the SMTP server.</para>
  22387. <para>To authenticate with the SMTP server, use one of the
  22388. <a href="Overload_MailKit_Net_Smtp_SmtpClient_Authenticate.htm">Authenticate</a>
  22389. methods.</para>
  22390. </remarks>
  22391. <value><c>true</c> if the client is connected; otherwise, <c>false</c>.</value>
  22392. </member>
  22393. <member name="M:MailKit.Net.Smtp.SmtpClient.OnNoRecipientsAccepted(MimeKit.MimeMessage)">
  22394. <summary>
  22395. Invoked only when no recipients were accepted by the SMTP server.
  22396. </summary>
  22397. <remarks>
  22398. If <see cref="M:MailKit.Net.Smtp.SmtpClient.OnRecipientNotAccepted(MimeKit.MimeMessage,MimeKit.MailboxAddress,MailKit.Net.Smtp.SmtpResponse)"/> is overridden to not throw
  22399. an exception, this method should be overridden to throw an appropriate
  22400. exception instead.
  22401. </remarks>
  22402. <param name="message">The message being sent.</param>
  22403. </member>
  22404. <member name="M:MailKit.Net.Smtp.SmtpClient.SendCommand(System.String,System.Threading.CancellationToken)">
  22405. <summary>
  22406. Send a custom command to the SMTP server.
  22407. </summary>
  22408. <remarks>
  22409. <para>Sends a custom command to the SMTP server.</para>
  22410. <note type="note">The command string should not include the terminating <c>\r\n</c> sequence.</note>
  22411. </remarks>
  22412. <returns>The command response.</returns>
  22413. <param name="command">The command.</param>
  22414. <param name="cancellationToken">The cancellation token.</param>
  22415. <exception cref="T:System.ArgumentNullException">
  22416. <paramref name="command"/> is <c>null</c>.
  22417. </exception>
  22418. <exception cref="T:System.ObjectDisposedException">
  22419. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  22420. </exception>
  22421. <exception cref="T:MailKit.ServiceNotConnectedException">
  22422. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  22423. </exception>
  22424. <exception cref="T:System.OperationCanceledException">
  22425. The operation has been canceled.
  22426. </exception>
  22427. <exception cref="T:System.IO.IOException">
  22428. An I/O error occurred.
  22429. </exception>
  22430. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  22431. The SMTP command failed.
  22432. </exception>
  22433. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  22434. An SMTP protocol exception occurred.
  22435. </exception>
  22436. </member>
  22437. <member name="M:MailKit.Net.Smtp.SmtpClient.Authenticate(MailKit.Security.SaslMechanism,System.Threading.CancellationToken)">
  22438. <summary>
  22439. Authenticate using the specified SASL mechanism.
  22440. </summary>
  22441. <remarks>
  22442. <para>Authenticates using the specified SASL mechanism.</para>
  22443. <para>For a list of available SASL authentication mechanisms supported by the server,
  22444. check the <see cref="P:MailKit.Net.Smtp.SmtpClient.AuthenticationMechanisms"/> property after the service has been
  22445. connected.</para>
  22446. </remarks>
  22447. <param name="mechanism">The SASL mechanism.</param>
  22448. <param name="cancellationToken">The cancellation token.</param>
  22449. <exception cref="T:System.ArgumentNullException">
  22450. <paramref name="mechanism"/> is <c>null</c>.
  22451. </exception>
  22452. <exception cref="T:MailKit.ServiceNotConnectedException">
  22453. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  22454. </exception>
  22455. <exception cref="T:System.InvalidOperationException">
  22456. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is already authenticated.
  22457. </exception>
  22458. <exception cref="T:System.NotSupportedException">
  22459. The SMTP server does not support authentication.
  22460. </exception>
  22461. <exception cref="T:System.OperationCanceledException">
  22462. The operation was canceled via the cancellation token.
  22463. </exception>
  22464. <exception cref="T:MailKit.Security.AuthenticationException">
  22465. Authentication using the supplied credentials has failed.
  22466. </exception>
  22467. <exception cref="T:MailKit.Security.SaslException">
  22468. A SASL authentication error occurred.
  22469. </exception>
  22470. <exception cref="T:System.IO.IOException">
  22471. An I/O error occurred.
  22472. </exception>
  22473. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  22474. The SMTP command failed.
  22475. </exception>
  22476. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  22477. An SMTP protocol error occurred.
  22478. </exception>
  22479. </member>
  22480. <member name="M:MailKit.Net.Smtp.SmtpClient.Authenticate(System.Text.Encoding,System.Net.ICredentials,System.Threading.CancellationToken)">
  22481. <summary>
  22482. Authenticate using the supplied credentials.
  22483. </summary>
  22484. <remarks>
  22485. <para>If the SMTP server supports authentication, then the SASL mechanisms
  22486. that both the client and server support are tried in order of greatest
  22487. security to weakest security. Once a SASL authentication mechanism is
  22488. found that both client and server support, the credentials are used to
  22489. authenticate.</para>
  22490. <para>If, on the other hand, authentication is not supported by the SMTP
  22491. server, then this method will throw <see cref="T:System.NotSupportedException"/>.
  22492. The <see cref="P:MailKit.Net.Smtp.SmtpClient.Capabilities"/> property can be checked for the
  22493. <see cref="F:MailKit.Net.Smtp.SmtpCapabilities.Authentication"/> flag to make sure the
  22494. SMTP server supports authentication before calling this method.</para>
  22495. <note type="tip"> To prevent the usage of certain authentication mechanisms,
  22496. simply remove them from the <see cref="P:MailKit.Net.Smtp.SmtpClient.AuthenticationMechanisms"/> hash set
  22497. before calling this method.</note>
  22498. </remarks>
  22499. <param name="encoding">The text encoding to use for the user's credentials.</param>
  22500. <param name="credentials">The user's credentials.</param>
  22501. <param name="cancellationToken">The cancellation token.</param>
  22502. <exception cref="T:System.ArgumentNullException">
  22503. <para><paramref name="encoding"/> is <c>null</c>.</para>
  22504. <para>-or-</para>
  22505. <para><paramref name="credentials"/> is <c>null</c>.</para>
  22506. </exception>
  22507. <exception cref="T:MailKit.ServiceNotConnectedException">
  22508. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  22509. </exception>
  22510. <exception cref="T:System.InvalidOperationException">
  22511. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is already authenticated.
  22512. </exception>
  22513. <exception cref="T:System.NotSupportedException">
  22514. The SMTP server does not support authentication.
  22515. </exception>
  22516. <exception cref="T:System.OperationCanceledException">
  22517. The operation was canceled via the cancellation token.
  22518. </exception>
  22519. <exception cref="T:MailKit.Security.AuthenticationException">
  22520. Authentication using the supplied credentials has failed.
  22521. </exception>
  22522. <exception cref="T:MailKit.Security.SaslException">
  22523. A SASL authentication error occurred.
  22524. </exception>
  22525. <exception cref="T:System.IO.IOException">
  22526. An I/O error occurred.
  22527. </exception>
  22528. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  22529. The SMTP command failed.
  22530. </exception>
  22531. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  22532. An SMTP protocol error occurred.
  22533. </exception>
  22534. </member>
  22535. <member name="M:MailKit.Net.Smtp.SmtpClient.Connect(System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  22536. <summary>
  22537. Establish a connection to the specified SMTP or SMTP/S server.
  22538. </summary>
  22539. <remarks>
  22540. <para>Establishes a connection to the specified SMTP or SMTP/S server.</para>
  22541. <para>If the <paramref name="port"/> has a value of <c>0</c>, then the
  22542. <paramref name="options"/> parameter is used to determine the default port to
  22543. connect to. The default port used with <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>
  22544. is <c>465</c>. All other values will use a default port of <c>25</c>.</para>
  22545. <para>If the <paramref name="options"/> has a value of
  22546. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  22547. to determine the default security options. If the <paramref name="port"/> has a value
  22548. of <c>465</c>, then the default options used will be
  22549. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  22550. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  22551. <para>Once a connection is established, properties such as
  22552. <see cref="P:MailKit.Net.Smtp.SmtpClient.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Smtp.SmtpClient.Capabilities"/> will be
  22553. populated.</para>
  22554. <note type="note">The connection established by any of the
  22555. <a href="Overload_MailKit_Net_Smtp_SmtpClient_Connect.htm">Connect</a>
  22556. methods may be re-used if an application wishes to send multiple messages
  22557. to the same SMTP server. Since connecting and authenticating can be expensive
  22558. operations, re-using a connection can significantly improve performance when
  22559. sending a large number of messages to the same SMTP server over a short
  22560. period of time.</note>
  22561. </remarks>
  22562. <example>
  22563. <code language="c#" source="Examples\SmtpExamples.cs" region="SendMessage"/>
  22564. </example>
  22565. <param name="host">The host name to connect to.</param>
  22566. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  22567. <param name="options">The secure socket options to when connecting.</param>
  22568. <param name="cancellationToken">The cancellation token.</param>
  22569. <exception cref="T:System.ArgumentNullException">
  22570. <paramref name="host"/> is <c>null</c>.
  22571. </exception>
  22572. <exception cref="T:System.ArgumentOutOfRangeException">
  22573. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  22574. </exception>
  22575. <exception cref="T:System.ArgumentException">
  22576. The <paramref name="host"/> is a zero-length string.
  22577. </exception>
  22578. <exception cref="T:System.ObjectDisposedException">
  22579. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  22580. </exception>
  22581. <exception cref="T:System.InvalidOperationException">
  22582. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is already connected.
  22583. </exception>
  22584. <exception cref="T:System.NotSupportedException">
  22585. <paramref name="options"/> was set to
  22586. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  22587. and the SMTP server does not support the STARTTLS extension.
  22588. </exception>
  22589. <exception cref="T:System.OperationCanceledException">
  22590. The operation was canceled.
  22591. </exception>
  22592. <exception cref="T:System.Net.Sockets.SocketException">
  22593. A socket error occurred trying to connect to the remote host.
  22594. </exception>
  22595. <exception cref="T:MailKit.Security.SslHandshakeException">
  22596. An error occurred during the SSL/TLS negotiations.
  22597. </exception>
  22598. <exception cref="T:System.IO.IOException">
  22599. An I/O error occurred.
  22600. </exception>
  22601. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  22602. An SMTP command failed.
  22603. </exception>
  22604. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  22605. An SMTP protocol error occurred.
  22606. </exception>
  22607. </member>
  22608. <member name="M:MailKit.Net.Smtp.SmtpClient.Connect(System.Net.Sockets.Socket,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  22609. <summary>
  22610. Establish a connection to the specified SMTP or SMTP/S server using the provided socket.
  22611. </summary>
  22612. <remarks>
  22613. <para>Establishes a connection to the specified SMTP or SMTP/S server using the provided socket.</para>
  22614. <para>If the <paramref name="options"/> has a value of
  22615. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  22616. to determine the default security options. If the <paramref name="port"/> has a value
  22617. of <c>465</c>, then the default options used will be
  22618. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  22619. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  22620. <para>Once a connection is established, properties such as
  22621. <see cref="P:MailKit.Net.Smtp.SmtpClient.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Smtp.SmtpClient.Capabilities"/> will be
  22622. populated.</para>
  22623. <note type="info">With the exception of using the <paramref name="port"/> to determine the
  22624. default <see cref="T:MailKit.Security.SecureSocketOptions"/> to use when the <paramref name="options"/> value
  22625. is <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, the <paramref name="host"/> and
  22626. <paramref name="port"/> parameters are only used for logging purposes.</note>
  22627. </remarks>
  22628. <param name="socket">The socket to use for the connection.</param>
  22629. <param name="host">The host name to connect to.</param>
  22630. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  22631. <param name="options">The secure socket options to when connecting.</param>
  22632. <param name="cancellationToken">The cancellation token.</param>
  22633. <exception cref="T:System.ArgumentNullException">
  22634. <para><paramref name="socket"/> is <c>null</c>.</para>
  22635. <para>-or-</para>
  22636. <para><paramref name="host"/> is <c>null</c>.</para>
  22637. </exception>
  22638. <exception cref="T:System.ArgumentOutOfRangeException">
  22639. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  22640. </exception>
  22641. <exception cref="T:System.ArgumentException">
  22642. <para><paramref name="socket"/> is not connected.</para>
  22643. <para>-or-</para>
  22644. <para>The <paramref name="host"/> is a zero-length string.</para>
  22645. </exception>
  22646. <exception cref="T:System.ObjectDisposedException">
  22647. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  22648. </exception>
  22649. <exception cref="T:System.InvalidOperationException">
  22650. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is already connected.
  22651. </exception>
  22652. <exception cref="T:System.NotSupportedException">
  22653. <paramref name="options"/> was set to
  22654. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  22655. and the SMTP server does not support the STARTTLS extension.
  22656. </exception>
  22657. <exception cref="T:System.OperationCanceledException">
  22658. The operation was canceled.
  22659. </exception>
  22660. <exception cref="T:MailKit.Security.SslHandshakeException">
  22661. An error occurred during the SSL/TLS negotiations.
  22662. </exception>
  22663. <exception cref="T:System.IO.IOException">
  22664. An I/O error occurred.
  22665. </exception>
  22666. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  22667. An SMTP command failed.
  22668. </exception>
  22669. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  22670. An SMTP protocol error occurred.
  22671. </exception>
  22672. </member>
  22673. <member name="M:MailKit.Net.Smtp.SmtpClient.Connect(System.IO.Stream,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  22674. <summary>
  22675. Establish a connection to the specified SMTP or SMTP/S server using the provided stream.
  22676. </summary>
  22677. <remarks>
  22678. <para>Establishes a connection to the specified SMTP or SMTP/S server using the provided stream.</para>
  22679. <para>If the <paramref name="options"/> has a value of
  22680. <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, then the <paramref name="port"/> is used
  22681. to determine the default security options. If the <paramref name="port"/> has a value
  22682. of <c>465</c>, then the default options used will be
  22683. <see cref="F:MailKit.Security.SecureSocketOptions.SslOnConnect"/>. All other values will use
  22684. <see cref="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable"/>.</para>
  22685. <para>Once a connection is established, properties such as
  22686. <see cref="P:MailKit.Net.Smtp.SmtpClient.AuthenticationMechanisms"/> and <see cref="P:MailKit.Net.Smtp.SmtpClient.Capabilities"/> will be
  22687. populated.</para>
  22688. <note type="info">With the exception of using the <paramref name="port"/> to determine the
  22689. default <see cref="T:MailKit.Security.SecureSocketOptions"/> to use when the <paramref name="options"/> value
  22690. is <see cref="F:MailKit.Security.SecureSocketOptions.Auto"/>, the <paramref name="host"/> and
  22691. <paramref name="port"/> parameters are only used for logging purposes.</note>
  22692. </remarks>
  22693. <param name="stream">The stream to use for the connection.</param>
  22694. <param name="host">The host name to connect to.</param>
  22695. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  22696. <param name="options">The secure socket options to when connecting.</param>
  22697. <param name="cancellationToken">The cancellation token.</param>
  22698. <exception cref="T:System.ArgumentNullException">
  22699. <para><paramref name="stream"/> is <c>null</c>.</para>
  22700. <para>-or-</para>
  22701. <para><paramref name="host"/> is <c>null</c>.</para>
  22702. </exception>
  22703. <exception cref="T:System.ArgumentOutOfRangeException">
  22704. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  22705. </exception>
  22706. <exception cref="T:System.ArgumentException">
  22707. The <paramref name="host"/> is a zero-length string.
  22708. </exception>
  22709. <exception cref="T:System.ObjectDisposedException">
  22710. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  22711. </exception>
  22712. <exception cref="T:System.InvalidOperationException">
  22713. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is already connected.
  22714. </exception>
  22715. <exception cref="T:System.NotSupportedException">
  22716. <paramref name="options"/> was set to
  22717. <see cref="F:MailKit.Security.SecureSocketOptions.StartTls"/>
  22718. and the SMTP server does not support the STARTTLS extension.
  22719. </exception>
  22720. <exception cref="T:System.OperationCanceledException">
  22721. The operation was canceled.
  22722. </exception>
  22723. <exception cref="T:MailKit.Security.SslHandshakeException">
  22724. An error occurred during the SSL/TLS negotiations.
  22725. </exception>
  22726. <exception cref="T:System.IO.IOException">
  22727. An I/O error occurred.
  22728. </exception>
  22729. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  22730. An SMTP command failed.
  22731. </exception>
  22732. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  22733. An SMTP protocol error occurred.
  22734. </exception>
  22735. </member>
  22736. <member name="M:MailKit.Net.Smtp.SmtpClient.Disconnect(System.Boolean,System.Threading.CancellationToken)">
  22737. <summary>
  22738. Disconnect the service.
  22739. </summary>
  22740. <remarks>
  22741. If <paramref name="quit"/> is <c>true</c>, a <c>QUIT</c> command will be issued in order to disconnect cleanly.
  22742. </remarks>
  22743. <example>
  22744. <code language="c#" source="Examples\SmtpExamples.cs" region="SendMessage"/>
  22745. </example>
  22746. <param name="quit">If set to <c>true</c>, a <c>QUIT</c> command will be issued in order to disconnect cleanly.</param>
  22747. <param name="cancellationToken">The cancellation token.</param>
  22748. <exception cref="T:System.ObjectDisposedException">
  22749. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  22750. </exception>
  22751. </member>
  22752. <member name="M:MailKit.Net.Smtp.SmtpClient.NoOp(System.Threading.CancellationToken)">
  22753. <summary>
  22754. Ping the SMTP server to keep the connection alive.
  22755. </summary>
  22756. <remarks>Mail servers, if left idle for too long, will automatically drop the connection.</remarks>
  22757. <param name="cancellationToken">The cancellation token.</param>
  22758. <exception cref="T:System.ObjectDisposedException">
  22759. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  22760. </exception>
  22761. <exception cref="T:MailKit.ServiceNotConnectedException">
  22762. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  22763. </exception>
  22764. <exception cref="T:System.OperationCanceledException">
  22765. The operation was canceled.
  22766. </exception>
  22767. <exception cref="T:System.IO.IOException">
  22768. An I/O error occurred.
  22769. </exception>
  22770. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  22771. The SMTP command failed.
  22772. </exception>
  22773. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  22774. An SMTP protocol error occurred.
  22775. </exception>
  22776. </member>
  22777. <member name="M:MailKit.Net.Smtp.SmtpClient.OnSenderAccepted(MimeKit.MimeMessage,MimeKit.MailboxAddress,MailKit.Net.Smtp.SmtpResponse)">
  22778. <summary>
  22779. Invoked when the sender is accepted by the SMTP server.
  22780. </summary>
  22781. <remarks>
  22782. The default implementation does nothing.
  22783. </remarks>
  22784. <param name="message">The message being sent.</param>
  22785. <param name="mailbox">The mailbox used in the <c>MAIL FROM</c> command.</param>
  22786. <param name="response">The response to the <c>MAIL FROM</c> command.</param>
  22787. </member>
  22788. <member name="M:MailKit.Net.Smtp.SmtpClient.OnSenderNotAccepted(MimeKit.MimeMessage,MimeKit.MailboxAddress,MailKit.Net.Smtp.SmtpResponse)">
  22789. <summary>
  22790. Invoked when a recipient is not accepted by the SMTP server.
  22791. </summary>
  22792. <remarks>
  22793. The default implementation throws an appropriate <see cref="T:MailKit.Net.Smtp.SmtpCommandException"/>.
  22794. </remarks>
  22795. <param name="message">The message being sent.</param>
  22796. <param name="mailbox">The mailbox used in the <c>MAIL FROM</c> command.</param>
  22797. <param name="response">The response to the <c>MAIL FROM</c> command.</param>
  22798. </member>
  22799. <member name="M:MailKit.Net.Smtp.SmtpClient.GetEnvelopeId(MimeKit.MimeMessage)">
  22800. <summary>
  22801. Get the envelope identifier to be used with delivery status notifications.
  22802. </summary>
  22803. <remarks>
  22804. <para>The envelope identifier, if non-empty, is useful in determining which message a delivery
  22805. status notification was issued for.</para>
  22806. <para>The envelope identifier should be unique and may be up to 100 characters in length, but
  22807. must consist only of printable ASCII characters and no white space.</para>
  22808. <para>For more information, see
  22809. <a href="https://tools.ietf.org/html/rfc3461#section-4.4">rfc3461, section 4.4</a>.</para>
  22810. </remarks>
  22811. <example>
  22812. <code language="c#" source="Examples\SmtpExamples.cs" region="DeliveryStatusNotification"/>
  22813. </example>
  22814. <returns>The envelope identifier.</returns>
  22815. <param name="message">The message.</param>
  22816. </member>
  22817. <member name="P:MailKit.Net.Smtp.SmtpClient.DeliveryStatusNotificationType">
  22818. <summary>
  22819. Get or set how much of the message to include in any failed delivery status notifications.
  22820. </summary>
  22821. <remarks>
  22822. Gets or sets how much of the message to include in any failed delivery status notifications.
  22823. </remarks>
  22824. <value>A value indicating how much of the message to include in a failure delivery status notification.</value>
  22825. </member>
  22826. <member name="M:MailKit.Net.Smtp.SmtpClient.OnRecipientAccepted(MimeKit.MimeMessage,MimeKit.MailboxAddress,MailKit.Net.Smtp.SmtpResponse)">
  22827. <summary>
  22828. Invoked when a recipient is accepted by the SMTP server.
  22829. </summary>
  22830. <remarks>
  22831. The default implementation does nothing.
  22832. </remarks>
  22833. <param name="message">The message being sent.</param>
  22834. <param name="mailbox">The mailbox used in the <c>RCPT TO</c> command.</param>
  22835. <param name="response">The response to the <c>RCPT TO</c> command.</param>
  22836. </member>
  22837. <member name="M:MailKit.Net.Smtp.SmtpClient.OnRecipientNotAccepted(MimeKit.MimeMessage,MimeKit.MailboxAddress,MailKit.Net.Smtp.SmtpResponse)">
  22838. <summary>
  22839. Invoked when a recipient is not accepted by the SMTP server.
  22840. </summary>
  22841. <remarks>
  22842. The default implementation throws an appropriate <see cref="T:MailKit.Net.Smtp.SmtpCommandException"/>.
  22843. </remarks>
  22844. <param name="message">The message being sent.</param>
  22845. <param name="mailbox">The mailbox used in the <c>RCPT TO</c> command.</param>
  22846. <param name="response">The response to the <c>RCPT TO</c> command.</param>
  22847. </member>
  22848. <member name="M:MailKit.Net.Smtp.SmtpClient.GetDeliveryStatusNotifications(MimeKit.MimeMessage,MimeKit.MailboxAddress)">
  22849. <summary>
  22850. Get the types of delivery status notification desired for the specified recipient mailbox.
  22851. </summary>
  22852. <remarks>
  22853. Gets the types of delivery status notification desired for the specified recipient mailbox.
  22854. </remarks>
  22855. <example>
  22856. <code language="c#" source="Examples\SmtpExamples.cs" region="DeliveryStatusNotification"/>
  22857. </example>
  22858. <returns>The desired delivery status notification type.</returns>
  22859. <param name="message">The message being sent.</param>
  22860. <param name="mailbox">The mailbox.</param>
  22861. </member>
  22862. <member name="M:MailKit.Net.Smtp.SmtpClient.Prepare(MimeKit.FormatOptions,MimeKit.MimeMessage,MimeKit.EncodingConstraint,System.Int32)">
  22863. <summary>
  22864. Prepare the message for transport with the specified constraints.
  22865. </summary>
  22866. <remarks>
  22867. <para>Prepares the message for transport with the specified constraints.</para>
  22868. <para>Typically, this involves calling <see cref="M:MimeKit.MimeMessage.Prepare(MimeKit.EncodingConstraint,System.Int32)"/> on
  22869. the message with the provided constraints.</para>
  22870. </remarks>
  22871. <param name="options">The format options.</param>
  22872. <param name="message">The message.</param>
  22873. <param name="constraint">The encoding constraint.</param>
  22874. <param name="maxLineLength">The max line length supported by the server.</param>
  22875. </member>
  22876. <member name="M:MailKit.Net.Smtp.SmtpClient.GetSize(MimeKit.FormatOptions,MimeKit.MimeMessage,System.Threading.CancellationToken)">
  22877. <summary>
  22878. Get the size of the message.
  22879. </summary>
  22880. <remarks>
  22881. <para>Calculates the size of the message in bytes.</para>
  22882. <para>This method is called by <a href="Overload_MailKit_MailTransport_Send.htm">Send</a>
  22883. methods in the following conditions:</para>
  22884. <list type="bullet">
  22885. <item>The SMTP server supports the <c>SIZE=</c> parameter in the <c>MAIL FROM</c> command.</item>
  22886. <item>The <see cref="T:MailKit.ITransferProgress"/> parameter is non-null.</item>
  22887. <item>The SMTP server supports the <c>CHUNKING</c> extension.</item>
  22888. </list>
  22889. </remarks>
  22890. <returns>The size of the message, in bytes.</returns>
  22891. <param name="options">The formatting options.</param>
  22892. <param name="message">The message.</param>
  22893. <param name="cancellationToken">The cancellation token.</param>
  22894. </member>
  22895. <member name="M:MailKit.Net.Smtp.SmtpClient.GetSizeAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,System.Threading.CancellationToken)">
  22896. <summary>
  22897. Asynchronously get the size of the message.
  22898. </summary>
  22899. <remarks>
  22900. <para>Asynchronously calculates the size of the message in bytes.</para>
  22901. <para>This method is called by <a href="Overload_MailKit_MailTransport_SendAsync.htm">SendAsync</a>
  22902. methods in the following conditions:</para>
  22903. <list type="bullet">
  22904. <item>The SMTP server supports the <c>SIZE=</c> parameter in the <c>MAIL FROM</c> command.</item>
  22905. <item>The <see cref="T:MailKit.ITransferProgress"/> parameter is non-null.</item>
  22906. <item>The SMTP server supports the <c>CHUNKING</c> extension.</item>
  22907. </list>
  22908. </remarks>
  22909. <returns>The size of the message, in bytes.</returns>
  22910. <param name="options">The formatting options.</param>
  22911. <param name="message">The message.</param>
  22912. <param name="cancellationToken">The cancellation token.</param>
  22913. </member>
  22914. <member name="M:MailKit.Net.Smtp.SmtpClient.Send(MimeKit.FormatOptions,MimeKit.MimeMessage,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  22915. <summary>
  22916. Send the specified message.
  22917. </summary>
  22918. <remarks>
  22919. <para>Sends the specified message.</para>
  22920. <para>The sender address is determined by checking the following
  22921. message headers (in order of precedence): Resent-Sender,
  22922. Resent-From, Sender, and From.</para>
  22923. <para>If either the Resent-Sender or Resent-From addresses are present,
  22924. the recipients are collected from the Resent-To, Resent-Cc, and
  22925. Resent-Bcc headers, otherwise the To, Cc, and Bcc headers are used.</para>
  22926. </remarks>
  22927. <example>
  22928. <code language="c#" source="Examples\SmtpExamples.cs" region="SendMessageWithOptions"/>
  22929. </example>
  22930. <param name="options">The formatting options.</param>
  22931. <param name="message">The message.</param>
  22932. <param name="cancellationToken">The cancellation token.</param>
  22933. <param name="progress">The progress reporting mechanism.</param>
  22934. <exception cref="T:System.ArgumentNullException">
  22935. <para><paramref name="options"/> is <c>null</c>.</para>
  22936. <para>-or-</para>
  22937. <para><paramref name="message"/> is <c>null</c>.</para>
  22938. </exception>
  22939. <exception cref="T:System.ObjectDisposedException">
  22940. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  22941. </exception>
  22942. <exception cref="T:MailKit.ServiceNotConnectedException">
  22943. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  22944. </exception>
  22945. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  22946. Authentication is required before sending a message.
  22947. </exception>
  22948. <exception cref="T:System.InvalidOperationException">
  22949. <para>A sender has not been specified.</para>
  22950. <para>-or-</para>
  22951. <para>No recipients have been specified.</para>
  22952. </exception>
  22953. <exception cref="T:System.NotSupportedException">
  22954. Internationalized formatting was requested but is not supported by the server.
  22955. </exception>
  22956. <exception cref="T:System.OperationCanceledException">
  22957. The operation has been canceled.
  22958. </exception>
  22959. <exception cref="T:System.IO.IOException">
  22960. An I/O error occurred.
  22961. </exception>
  22962. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  22963. The SMTP command failed.
  22964. </exception>
  22965. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  22966. An SMTP protocol exception occurred.
  22967. </exception>
  22968. </member>
  22969. <member name="M:MailKit.Net.Smtp.SmtpClient.Send(MimeKit.FormatOptions,MimeKit.MimeMessage,MimeKit.MailboxAddress,System.Collections.Generic.IEnumerable{MimeKit.MailboxAddress},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  22970. <summary>
  22971. Send the specified message using the supplied sender and recipients.
  22972. </summary>
  22973. <remarks>
  22974. Sends the message by uploading it to an SMTP server using the supplied sender and recipients.
  22975. </remarks>
  22976. <param name="options">The formatting options.</param>
  22977. <param name="message">The message.</param>
  22978. <param name="sender">The mailbox address to use for sending the message.</param>
  22979. <param name="recipients">The mailbox addresses that should receive the message.</param>
  22980. <param name="cancellationToken">The cancellation token.</param>
  22981. <param name="progress">The progress reporting mechanism.</param>
  22982. <exception cref="T:System.ArgumentNullException">
  22983. <para><paramref name="options"/> is <c>null</c>.</para>
  22984. <para>-or-</para>
  22985. <para><paramref name="message"/> is <c>null</c>.</para>
  22986. <para>-or-</para>
  22987. <para><paramref name="sender"/> is <c>null</c>.</para>
  22988. <para>-or-</para>
  22989. <para><paramref name="recipients"/> is <c>null</c>.</para>
  22990. </exception>
  22991. <exception cref="T:System.ObjectDisposedException">
  22992. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  22993. </exception>
  22994. <exception cref="T:MailKit.ServiceNotConnectedException">
  22995. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  22996. </exception>
  22997. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  22998. Authentication is required before sending a message.
  22999. </exception>
  23000. <exception cref="T:System.InvalidOperationException">
  23001. <para>A sender has not been specified.</para>
  23002. <para>-or-</para>
  23003. <para>No recipients have been specified.</para>
  23004. </exception>
  23005. <exception cref="T:System.NotSupportedException">
  23006. Internationalized formatting was requested but is not supported by the server.
  23007. </exception>
  23008. <exception cref="T:System.OperationCanceledException">
  23009. The operation has been canceled.
  23010. </exception>
  23011. <exception cref="T:System.IO.IOException">
  23012. An I/O error occurred.
  23013. </exception>
  23014. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  23015. The SMTP command failed.
  23016. </exception>
  23017. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  23018. An SMTP protocol exception occurred.
  23019. </exception>
  23020. </member>
  23021. <member name="M:MailKit.Net.Smtp.SmtpClient.Expand(System.String,System.Threading.CancellationToken)">
  23022. <summary>
  23023. Expand a mailing address alias.
  23024. </summary>
  23025. <remarks>
  23026. Expands a mailing address alias.
  23027. </remarks>
  23028. <returns>The expanded list of mailbox addresses.</returns>
  23029. <param name="alias">The mailing address alias.</param>
  23030. <param name="cancellationToken">The cancellation token.</param>
  23031. <exception cref="T:System.ArgumentNullException">
  23032. <paramref name="alias"/> is <c>null</c>.
  23033. </exception>
  23034. <exception cref="T:System.ArgumentException">
  23035. <paramref name="alias"/> is an empty string.
  23036. </exception>
  23037. <exception cref="T:System.ObjectDisposedException">
  23038. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  23039. </exception>
  23040. <exception cref="T:MailKit.ServiceNotConnectedException">
  23041. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  23042. </exception>
  23043. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  23044. Authentication is required before verifying the existence of an address.
  23045. </exception>
  23046. <exception cref="T:System.OperationCanceledException">
  23047. The operation has been canceled.
  23048. </exception>
  23049. <exception cref="T:System.IO.IOException">
  23050. An I/O error occurred.
  23051. </exception>
  23052. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  23053. The SMTP command failed.
  23054. </exception>
  23055. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  23056. An SMTP protocol exception occurred.
  23057. </exception>
  23058. </member>
  23059. <member name="M:MailKit.Net.Smtp.SmtpClient.Verify(System.String,System.Threading.CancellationToken)">
  23060. <summary>
  23061. Verify the existence of a mailbox address.
  23062. </summary>
  23063. <remarks>
  23064. Verifies the existence a mailbox address with the SMTP server, returning the expanded
  23065. mailbox address if it exists.
  23066. </remarks>
  23067. <returns>The expanded mailbox address.</returns>
  23068. <param name="address">The mailbox address.</param>
  23069. <param name="cancellationToken">The cancellation token.</param>
  23070. <exception cref="T:System.ArgumentNullException">
  23071. <paramref name="address"/> is <c>null</c>.
  23072. </exception>
  23073. <exception cref="T:System.ArgumentException">
  23074. <paramref name="address"/> is an empty string.
  23075. </exception>
  23076. <exception cref="T:System.ObjectDisposedException">
  23077. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  23078. </exception>
  23079. <exception cref="T:MailKit.ServiceNotConnectedException">
  23080. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  23081. </exception>
  23082. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  23083. Authentication is required before verifying the existence of an address.
  23084. </exception>
  23085. <exception cref="T:System.OperationCanceledException">
  23086. The operation has been canceled.
  23087. </exception>
  23088. <exception cref="T:System.IO.IOException">
  23089. An I/O error occurred.
  23090. </exception>
  23091. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  23092. The SMTP command failed.
  23093. </exception>
  23094. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  23095. An SMTP protocol exception occurred.
  23096. </exception>
  23097. </member>
  23098. <member name="M:MailKit.Net.Smtp.SmtpClient.Dispose(System.Boolean)">
  23099. <summary>
  23100. Releases the unmanaged resources used by the <see cref="T:MailKit.Net.Smtp.SmtpClient"/> and
  23101. optionally releases the managed resources.
  23102. </summary>
  23103. <remarks>
  23104. Releases the unmanaged resources used by the <see cref="T:MailKit.Net.Smtp.SmtpClient"/> and
  23105. optionally releases the managed resources.
  23106. </remarks>
  23107. <param name="disposing"><c>true</c> to release both managed and unmanaged resources;
  23108. <c>false</c> to release only the unmanaged resources.</param>
  23109. </member>
  23110. <member name="T:MailKit.Net.Smtp.ISmtpClient">
  23111. <summary>
  23112. An interface for an SMTP client.
  23113. </summary>
  23114. <remarks>
  23115. Implemented by <see cref="T:MailKit.Net.Smtp.SmtpClient"/>.
  23116. </remarks>
  23117. </member>
  23118. <member name="P:MailKit.Net.Smtp.ISmtpClient.Capabilities">
  23119. <summary>
  23120. Get the capabilities supported by the SMTP server.
  23121. </summary>
  23122. <remarks>
  23123. The capabilities will not be known until a successful connection has been made
  23124. and may change once the client is authenticated.
  23125. </remarks>
  23126. <example>
  23127. <code language="c#" source="Examples\SmtpExamples.cs" region="Capabilities"/>
  23128. </example>
  23129. <value>The capabilities.</value>
  23130. <exception cref="T:System.ArgumentException">
  23131. Capabilities cannot be enabled, they may only be disabled.
  23132. </exception>
  23133. </member>
  23134. <member name="P:MailKit.Net.Smtp.ISmtpClient.LocalDomain">
  23135. <summary>
  23136. Get or set the local domain.
  23137. </summary>
  23138. <remarks>
  23139. The local domain is used in the HELO or EHLO commands sent to
  23140. the SMTP server. If left unset, the local IP address will be
  23141. used instead.
  23142. </remarks>
  23143. <value>The local domain.</value>
  23144. </member>
  23145. <member name="P:MailKit.Net.Smtp.ISmtpClient.MaxSize">
  23146. <summary>
  23147. Get the maximum message size supported by the server.
  23148. </summary>
  23149. <remarks>
  23150. <para>The maximum message size will not be known until a successful connection has
  23151. been made and may change once the client is authenticated.</para>
  23152. <note type="note">This value is only relevant if the <see cref="P:MailKit.Net.Smtp.ISmtpClient.Capabilities"/> includes
  23153. the <see cref="F:MailKit.Net.Smtp.SmtpCapabilities.Size"/> flag.</note>
  23154. </remarks>
  23155. <example>
  23156. <code language="c#" source="Examples\SmtpExamples.cs" region="Capabilities"/>
  23157. </example>
  23158. <value>The maximum message size supported by the server.</value>
  23159. </member>
  23160. <member name="P:MailKit.Net.Smtp.ISmtpClient.DeliveryStatusNotificationType">
  23161. <summary>
  23162. Get or set how much of the message to include in any failed delivery status notifications.
  23163. </summary>
  23164. <remarks>
  23165. Gets or sets how much of the message to include in any failed delivery status notifications.
  23166. </remarks>
  23167. <value>A value indicating how much of the message to include in a failure delivery status notification.</value>
  23168. </member>
  23169. <member name="M:MailKit.Net.Smtp.ISmtpClient.Expand(System.String,System.Threading.CancellationToken)">
  23170. <summary>
  23171. Expand a mailing address alias.
  23172. </summary>
  23173. <remarks>
  23174. Expands a mailing address alias.
  23175. </remarks>
  23176. <returns>The expanded list of mailbox addresses.</returns>
  23177. <param name="alias">The mailing address alias.</param>
  23178. <param name="cancellationToken">The cancellation token.</param>
  23179. <exception cref="T:System.ArgumentNullException">
  23180. <paramref name="alias"/> is <c>null</c>.
  23181. </exception>
  23182. <exception cref="T:System.ArgumentException">
  23183. <paramref name="alias"/> is an empty string.
  23184. </exception>
  23185. <exception cref="T:System.ObjectDisposedException">
  23186. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  23187. </exception>
  23188. <exception cref="T:MailKit.ServiceNotConnectedException">
  23189. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  23190. </exception>
  23191. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  23192. Authentication is required before verifying the existence of an address.
  23193. </exception>
  23194. <exception cref="T:System.OperationCanceledException">
  23195. The operation has been canceled.
  23196. </exception>
  23197. <exception cref="T:System.IO.IOException">
  23198. An I/O error occurred.
  23199. </exception>
  23200. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  23201. The SMTP command failed.
  23202. </exception>
  23203. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  23204. An SMTP protocol exception occurred.
  23205. </exception>
  23206. </member>
  23207. <member name="M:MailKit.Net.Smtp.ISmtpClient.ExpandAsync(System.String,System.Threading.CancellationToken)">
  23208. <summary>
  23209. Asynchronously expand a mailing address alias.
  23210. </summary>
  23211. <remarks>
  23212. Expands a mailing address alias.
  23213. </remarks>
  23214. <returns>The expanded list of mailbox addresses.</returns>
  23215. <param name="alias">The mailing address alias.</param>
  23216. <param name="cancellationToken">The cancellation token.</param>
  23217. <exception cref="T:System.ArgumentNullException">
  23218. <paramref name="alias"/> is <c>null</c>.
  23219. </exception>
  23220. <exception cref="T:System.ArgumentException">
  23221. <paramref name="alias"/> is an empty string.
  23222. </exception>
  23223. <exception cref="T:System.ObjectDisposedException">
  23224. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  23225. </exception>
  23226. <exception cref="T:MailKit.ServiceNotConnectedException">
  23227. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  23228. </exception>
  23229. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  23230. Authentication is required before verifying the existence of an address.
  23231. </exception>
  23232. <exception cref="T:System.OperationCanceledException">
  23233. The operation has been canceled.
  23234. </exception>
  23235. <exception cref="T:System.IO.IOException">
  23236. An I/O error occurred.
  23237. </exception>
  23238. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  23239. The SMTP command failed.
  23240. </exception>
  23241. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  23242. An SMTP protocol exception occurred.
  23243. </exception>
  23244. </member>
  23245. <member name="M:MailKit.Net.Smtp.ISmtpClient.Verify(System.String,System.Threading.CancellationToken)">
  23246. <summary>
  23247. Verify the existence of a mailbox address.
  23248. </summary>
  23249. <remarks>
  23250. Verifies the existence a mailbox address with the SMTP server, returning the expanded
  23251. mailbox address if it exists.
  23252. </remarks>
  23253. <returns>The expanded mailbox address.</returns>
  23254. <param name="address">The mailbox address.</param>
  23255. <param name="cancellationToken">The cancellation token.</param>
  23256. <exception cref="T:System.ArgumentNullException">
  23257. <paramref name="address"/> is <c>null</c>.
  23258. </exception>
  23259. <exception cref="T:System.ArgumentException">
  23260. <paramref name="address"/> is an empty string.
  23261. </exception>
  23262. <exception cref="T:System.ObjectDisposedException">
  23263. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  23264. </exception>
  23265. <exception cref="T:MailKit.ServiceNotConnectedException">
  23266. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  23267. </exception>
  23268. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  23269. Authentication is required before verifying the existence of an address.
  23270. </exception>
  23271. <exception cref="T:System.OperationCanceledException">
  23272. The operation has been canceled.
  23273. </exception>
  23274. <exception cref="T:System.IO.IOException">
  23275. An I/O error occurred.
  23276. </exception>
  23277. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  23278. The SMTP command failed.
  23279. </exception>
  23280. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  23281. An SMTP protocol exception occurred.
  23282. </exception>
  23283. </member>
  23284. <member name="M:MailKit.Net.Smtp.ISmtpClient.VerifyAsync(System.String,System.Threading.CancellationToken)">
  23285. <summary>
  23286. Asynchronously verify the existence of a mailbox address.
  23287. </summary>
  23288. <remarks>
  23289. Verifies the existence a mailbox address with the SMTP server, returning the expanded
  23290. mailbox address if it exists.
  23291. </remarks>
  23292. <returns>The expanded mailbox address.</returns>
  23293. <param name="address">The mailbox address.</param>
  23294. <param name="cancellationToken">The cancellation token.</param>
  23295. <exception cref="T:System.ArgumentNullException">
  23296. <paramref name="address"/> is <c>null</c>.
  23297. </exception>
  23298. <exception cref="T:System.ArgumentException">
  23299. <paramref name="address"/> is an empty string.
  23300. </exception>
  23301. <exception cref="T:System.ObjectDisposedException">
  23302. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> has been disposed.
  23303. </exception>
  23304. <exception cref="T:MailKit.ServiceNotConnectedException">
  23305. The <see cref="T:MailKit.Net.Smtp.SmtpClient"/> is not connected.
  23306. </exception>
  23307. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  23308. Authentication is required before verifying the existence of an address.
  23309. </exception>
  23310. <exception cref="T:System.OperationCanceledException">
  23311. The operation has been canceled.
  23312. </exception>
  23313. <exception cref="T:System.IO.IOException">
  23314. An I/O error occurred.
  23315. </exception>
  23316. <exception cref="T:MailKit.Net.Smtp.SmtpCommandException">
  23317. The SMTP command failed.
  23318. </exception>
  23319. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  23320. An SMTP protocol exception occurred.
  23321. </exception>
  23322. </member>
  23323. <member name="T:MailKit.Net.Smtp.SmtpCapabilities">
  23324. <summary>
  23325. Capabilities supported by an SMTP server.
  23326. </summary>
  23327. <remarks>
  23328. Capabilities are read as part of the response to the EHLO command that
  23329. is issued during the connection phase of the <see cref="T:MailKit.Net.Smtp.SmtpClient"/>.
  23330. </remarks>
  23331. <example>
  23332. <code language="c#" source="Examples\SmtpExamples.cs" region="Capabilities"/>
  23333. </example>
  23334. </member>
  23335. <member name="F:MailKit.Net.Smtp.SmtpCapabilities.None">
  23336. <summary>
  23337. The server does not support any additional extensions.
  23338. </summary>
  23339. </member>
  23340. <member name="F:MailKit.Net.Smtp.SmtpCapabilities.Size">
  23341. <summary>
  23342. The server supports the <a href="https://tools.ietf.org/html/rfc1870">SIZE</a> extension
  23343. and may have a maximum message size limitation (see <see cref="P:MailKit.Net.Smtp.SmtpClient.MaxSize"/>).
  23344. </summary>
  23345. </member>
  23346. <member name="F:MailKit.Net.Smtp.SmtpCapabilities.Dsn">
  23347. <summary>
  23348. The server supports the <a href="https://tools.ietf.org/html/rfc1891">DSN</a> extension,
  23349. allowing clients to specify which (if any) recipients they would like to receive delivery
  23350. notifications for.
  23351. </summary>
  23352. </member>
  23353. <member name="F:MailKit.Net.Smtp.SmtpCapabilities.EnhancedStatusCodes">
  23354. <summary>
  23355. The server supports the <a href="https://tools.ietf.org/html/rfc2034">ENHANCEDSTATUSCODES</a>
  23356. extension.
  23357. </summary>
  23358. </member>
  23359. <member name="F:MailKit.Net.Smtp.SmtpCapabilities.Authentication">
  23360. <summary>
  23361. The server supports the <a href="https://tools.ietf.org/html/rfc2554">AUTH</a> extension,
  23362. allowing clients to authenticate via supported SASL mechanisms.
  23363. </summary>
  23364. </member>
  23365. <member name="F:MailKit.Net.Smtp.SmtpCapabilities.EightBitMime">
  23366. <summary>
  23367. The server supports the <a href="https://tools.ietf.org/html/rfc2821">8BITMIME</a> extension,
  23368. allowing clients to send messages using the "8bit" Content-Transfer-Encoding.
  23369. </summary>
  23370. </member>
  23371. <member name="F:MailKit.Net.Smtp.SmtpCapabilities.Pipelining">
  23372. <summary>
  23373. The server supports the <a href="https://tools.ietf.org/html/rfc2920">PIPELINING</a> extension,
  23374. allowing clients to send multiple commands at once in order to reduce round-trip latency.
  23375. </summary>
  23376. </member>
  23377. <member name="F:MailKit.Net.Smtp.SmtpCapabilities.BinaryMime">
  23378. <summary>
  23379. The server supports the <a href="https://tools.ietf.org/html/rfc3030">BINARYMIME</a> extension.
  23380. </summary>
  23381. </member>
  23382. <member name="F:MailKit.Net.Smtp.SmtpCapabilities.Chunking">
  23383. <summary>
  23384. The server supports the <a href="https://tools.ietf.org/html/rfc3030">CHUNKING</a> extension,
  23385. allowing clients to upload messages in chunks.
  23386. </summary>
  23387. </member>
  23388. <member name="F:MailKit.Net.Smtp.SmtpCapabilities.StartTLS">
  23389. <summary>
  23390. The server supports the <a href="https://tools.ietf.org/html/rfc3207">STARTTLS</a> extension,
  23391. allowing clients to switch to an encrypted SSL/TLS connection after connecting.
  23392. </summary>
  23393. </member>
  23394. <member name="F:MailKit.Net.Smtp.SmtpCapabilities.UTF8">
  23395. <summary>
  23396. The server supports the <a href="https://tools.ietf.org/html/rfc6531">SMTPUTF8</a> extension.
  23397. </summary>
  23398. </member>
  23399. <member name="T:MailKit.Net.Smtp.SmtpErrorCode">
  23400. <summary>
  23401. An enumeration of the possible error codes that may be reported by a <see cref="T:MailKit.Net.Smtp.SmtpCommandException"/>.
  23402. </summary>
  23403. <remarks>
  23404. An enumeration of the possible error codes that may be reported by a <see cref="T:MailKit.Net.Smtp.SmtpCommandException"/>.
  23405. </remarks>
  23406. <example>
  23407. <code language="c#" source="Examples\SmtpExamples.cs" region="ExceptionHandling"/>
  23408. </example>
  23409. </member>
  23410. <member name="F:MailKit.Net.Smtp.SmtpErrorCode.MessageNotAccepted">
  23411. <summary>
  23412. The message was not accepted for delivery. This may happen if
  23413. the server runs out of available disk space.
  23414. </summary>
  23415. </member>
  23416. <member name="F:MailKit.Net.Smtp.SmtpErrorCode.SenderNotAccepted">
  23417. <summary>
  23418. The sender's mailbox address was not accepted. Check the
  23419. <see cref="P:MailKit.Net.Smtp.SmtpCommandException.Mailbox"/> property for the
  23420. mailbox used as the sender's mailbox address.
  23421. </summary>
  23422. </member>
  23423. <member name="F:MailKit.Net.Smtp.SmtpErrorCode.RecipientNotAccepted">
  23424. <summary>
  23425. A recipient's mailbox address was not accepted. Check the
  23426. <see cref="P:MailKit.Net.Smtp.SmtpCommandException.Mailbox"/> property for the
  23427. particular recipient mailbox that was not acccepted.
  23428. </summary>
  23429. </member>
  23430. <member name="F:MailKit.Net.Smtp.SmtpErrorCode.UnexpectedStatusCode">
  23431. <summary>
  23432. An unexpected status code was returned by the server.
  23433. For more details, the <see cref="P:System.Exception.Message"/>
  23434. property may provide some additional hints.
  23435. </summary>
  23436. </member>
  23437. <member name="T:MailKit.Net.Smtp.SmtpCommandException">
  23438. <summary>
  23439. An SMTP protocol exception.
  23440. </summary>
  23441. <remarks>
  23442. The exception that is thrown when an SMTP command fails. Unlike a <see cref="T:MailKit.Net.Smtp.SmtpProtocolException"/>,
  23443. a <see cref="T:MailKit.Net.Smtp.SmtpCommandException"/> does not require the <see cref="T:MailKit.Net.Smtp.SmtpClient"/> to be reconnected.
  23444. </remarks>
  23445. <example>
  23446. <code language="c#" source="Examples\SmtpExamples.cs" region="ExceptionHandling"/>
  23447. </example>
  23448. </member>
  23449. <member name="M:MailKit.Net.Smtp.SmtpCommandException.#ctor(MailKit.Net.Smtp.SmtpErrorCode,MailKit.Net.Smtp.SmtpStatusCode,MimeKit.MailboxAddress,System.String,System.Exception)">
  23450. <summary>
  23451. Initializes a new instance of the <see cref="T:MailKit.Net.Smtp.SmtpCommandException"/> class.
  23452. </summary>
  23453. <remarks>
  23454. Creates a new <see cref="T:MailKit.Net.Smtp.SmtpCommandException"/>.
  23455. </remarks>
  23456. <param name="code">The error code.</param>
  23457. <param name="status">The status code.</param>
  23458. <param name="mailbox">The rejected mailbox.</param>
  23459. <param name="message">The error message.</param>
  23460. <param name="innerException">The inner exception.</param>
  23461. </member>
  23462. <member name="M:MailKit.Net.Smtp.SmtpCommandException.#ctor(MailKit.Net.Smtp.SmtpErrorCode,MailKit.Net.Smtp.SmtpStatusCode,MimeKit.MailboxAddress,System.String)">
  23463. <summary>
  23464. Initializes a new instance of the <see cref="T:MailKit.Net.Smtp.SmtpCommandException"/> class.
  23465. </summary>
  23466. <remarks>
  23467. Creates a new <see cref="T:MailKit.Net.Smtp.SmtpCommandException"/>.
  23468. </remarks>
  23469. <param name="code">The error code.</param>
  23470. <param name="status">The status code.</param>
  23471. <param name="mailbox">The rejected mailbox.</param>
  23472. <param name="message">The error message.</param>
  23473. </member>
  23474. <member name="M:MailKit.Net.Smtp.SmtpCommandException.#ctor(MailKit.Net.Smtp.SmtpErrorCode,MailKit.Net.Smtp.SmtpStatusCode,System.String,System.Exception)">
  23475. <summary>
  23476. Initializes a new instance of the <see cref="T:MailKit.Net.Smtp.SmtpCommandException"/> class.
  23477. </summary>
  23478. <remarks>
  23479. Creates a new <see cref="T:MailKit.Net.Smtp.SmtpCommandException"/>.
  23480. </remarks>
  23481. <param name="code">The error code.</param>
  23482. <param name="status">The status code.</param>>
  23483. <param name="message">The error message.</param>
  23484. <param name="innerException">The inner exception.</param>
  23485. </member>
  23486. <member name="M:MailKit.Net.Smtp.SmtpCommandException.#ctor(MailKit.Net.Smtp.SmtpErrorCode,MailKit.Net.Smtp.SmtpStatusCode,System.String)">
  23487. <summary>
  23488. Initializes a new instance of the <see cref="T:MailKit.Net.Smtp.SmtpCommandException"/> class.
  23489. </summary>
  23490. <remarks>
  23491. Creates a new <see cref="T:MailKit.Net.Smtp.SmtpCommandException"/>.
  23492. </remarks>
  23493. <param name="code">The error code.</param>
  23494. <param name="status">The status code.</param>>
  23495. <param name="message">The error message.</param>
  23496. </member>
  23497. <member name="P:MailKit.Net.Smtp.SmtpCommandException.ErrorCode">
  23498. <summary>
  23499. Gets the error code which may provide additional information.
  23500. </summary>
  23501. <remarks>
  23502. The error code can be used to programatically deal with the
  23503. exception without necessarily needing to display the raw
  23504. exception message to the user.
  23505. </remarks>
  23506. <example>
  23507. <code language="c#" source="Examples\SmtpExamples.cs" region="ExceptionHandling"/>
  23508. </example>
  23509. <value>The status code.</value>
  23510. </member>
  23511. <member name="P:MailKit.Net.Smtp.SmtpCommandException.Mailbox">
  23512. <summary>
  23513. Gets the mailbox that the error occurred on.
  23514. </summary>
  23515. <remarks>
  23516. This property will only be available when the <see cref="P:MailKit.Net.Smtp.SmtpCommandException.ErrorCode"/>
  23517. value is either <see cref="F:MailKit.Net.Smtp.SmtpErrorCode.SenderNotAccepted"/> or
  23518. <see cref="F:MailKit.Net.Smtp.SmtpErrorCode.RecipientNotAccepted"/> and may be used
  23519. to help the user decide how to proceed.
  23520. </remarks>
  23521. <example>
  23522. <code language="c#" source="Examples\SmtpExamples.cs" region="ExceptionHandling"/>
  23523. </example>
  23524. <value>The mailbox.</value>
  23525. </member>
  23526. <member name="P:MailKit.Net.Smtp.SmtpCommandException.StatusCode">
  23527. <summary>
  23528. Gets the status code returned by the SMTP server.
  23529. </summary>
  23530. <remarks>
  23531. The raw SMTP status code that resulted in the <see cref="T:MailKit.Net.Smtp.SmtpCommandException"/>
  23532. being thrown.
  23533. </remarks>
  23534. <example>
  23535. <code language="c#" source="Examples\SmtpExamples.cs" region="ExceptionHandling"/>
  23536. </example>
  23537. <value>The status code.</value>
  23538. </member>
  23539. <member name="T:MailKit.Net.Smtp.SmtpDataFilter">
  23540. <summary>
  23541. An SMTP filter designed to format a message stream for the DATA command.
  23542. </summary>
  23543. <remarks>
  23544. A special stream filter that escapes lines beginning with a '.' as needed when
  23545. sending a message via the SMTP protocol or when saving a message to an IIS
  23546. message pickup directory.
  23547. </remarks>
  23548. <example>
  23549. <code language="c#" source="Examples\SmtpExamples.cs" region="SaveToPickupDirectory" />
  23550. </example>
  23551. </member>
  23552. <member name="M:MailKit.Net.Smtp.SmtpDataFilter.#ctor">
  23553. <summary>
  23554. Initializes a new instance of the <see cref="T:MailKit.Net.Smtp.SmtpDataFilter"/> class.
  23555. </summary>
  23556. <remarks>
  23557. Creates a new <see cref="T:MailKit.Net.Smtp.SmtpDataFilter"/>.
  23558. </remarks>
  23559. <example>
  23560. <code language="c#" source="Examples\SmtpExamples.cs" region="SaveToPickupDirectory" />
  23561. </example>
  23562. </member>
  23563. <member name="M:MailKit.Net.Smtp.SmtpDataFilter.Filter(System.Byte[],System.Int32,System.Int32,System.Int32@,System.Int32@,System.Boolean)">
  23564. <summary>
  23565. Filter the specified input.
  23566. </summary>
  23567. <remarks>
  23568. Filters the specified input buffer starting at the given index,
  23569. spanning across the specified number of bytes.
  23570. </remarks>
  23571. <returns>The filtered output.</returns>
  23572. <param name="input">The input buffer.</param>
  23573. <param name="startIndex">The starting index of the input buffer.</param>
  23574. <param name="length">The length of the input buffer, starting at <paramref name="startIndex"/>.</param>
  23575. <param name="outputIndex">The output index.</param>
  23576. <param name="outputLength">The output length.</param>
  23577. <param name="flush">If set to <c>true</c>, all internally buffered data should be flushed to the output buffer.</param>
  23578. </member>
  23579. <member name="M:MailKit.Net.Smtp.SmtpDataFilter.Reset">
  23580. <summary>
  23581. Reset the filter.
  23582. </summary>
  23583. <remarks>
  23584. Resets the filter.
  23585. </remarks>
  23586. </member>
  23587. <member name="T:MailKit.Net.Smtp.SmtpProtocolException">
  23588. <summary>
  23589. An SMTP protocol exception.
  23590. </summary>
  23591. <remarks>
  23592. The exception that is thrown when there is an error communicating with an SMTP server. An
  23593. <see cref="T:MailKit.Net.Smtp.SmtpProtocolException"/> is typically fatal and requires the <see cref="T:MailKit.Net.Smtp.SmtpClient"/>
  23594. to be reconnected.
  23595. </remarks>
  23596. <example>
  23597. <code language="c#" source="Examples\SmtpExamples.cs" region="ExceptionHandling"/>
  23598. </example>
  23599. </member>
  23600. <member name="M:MailKit.Net.Smtp.SmtpProtocolException.#ctor(System.String,System.Exception)">
  23601. <summary>
  23602. Initializes a new instance of the <see cref="T:MailKit.Net.Smtp.SmtpProtocolException"/> class.
  23603. </summary>
  23604. <remarks>
  23605. Creates a new <see cref="T:MailKit.Net.Smtp.SmtpProtocolException"/>.
  23606. </remarks>
  23607. <param name="message">The error message.</param>
  23608. <param name="innerException">The inner exception.</param>
  23609. </member>
  23610. <member name="M:MailKit.Net.Smtp.SmtpProtocolException.#ctor(System.String)">
  23611. <summary>
  23612. Initializes a new instance of the <see cref="T:MailKit.Net.Smtp.SmtpProtocolException"/> class.
  23613. </summary>
  23614. <remarks>
  23615. Creates a new <see cref="T:MailKit.Net.Smtp.SmtpProtocolException"/>.
  23616. </remarks>
  23617. <param name="message">The error message.</param>
  23618. </member>
  23619. <member name="M:MailKit.Net.Smtp.SmtpProtocolException.#ctor">
  23620. <summary>
  23621. Initializes a new instance of the <see cref="T:MailKit.Net.Smtp.SmtpProtocolException"/> class.
  23622. </summary>
  23623. <remarks>
  23624. Creates a new <see cref="T:MailKit.Net.Smtp.SmtpProtocolException"/>.
  23625. </remarks>
  23626. </member>
  23627. <member name="T:MailKit.Net.Smtp.SmtpResponse">
  23628. <summary>
  23629. An SMTP command response.
  23630. </summary>
  23631. <remarks>
  23632. An SMTP command response.
  23633. </remarks>
  23634. </member>
  23635. <member name="P:MailKit.Net.Smtp.SmtpResponse.StatusCode">
  23636. <summary>
  23637. Get the status code.
  23638. </summary>
  23639. <remarks>
  23640. Gets the status code.
  23641. </remarks>
  23642. <value>The status code.</value>
  23643. </member>
  23644. <member name="P:MailKit.Net.Smtp.SmtpResponse.Response">
  23645. <summary>
  23646. Get the response text.
  23647. </summary>
  23648. <remarks>
  23649. Gets the response text.
  23650. </remarks>
  23651. <value>The response text.</value>
  23652. </member>
  23653. <member name="M:MailKit.Net.Smtp.SmtpResponse.#ctor(MailKit.Net.Smtp.SmtpStatusCode,System.String)">
  23654. <summary>
  23655. Initializes a new instance of the <see cref="T:MailKit.Net.Smtp.SmtpResponse"/> class.
  23656. </summary>
  23657. <remarks>
  23658. Creates a new <see cref="T:MailKit.Net.Smtp.SmtpResponse"/>.
  23659. </remarks>
  23660. <param name="code">The status code.</param>
  23661. <param name="response">The response text.</param>
  23662. </member>
  23663. <member name="T:MailKit.Net.Smtp.SmtpStatusCode">
  23664. <summary>
  23665. An enumeration of possible SMTP status codes.
  23666. </summary>
  23667. <remarks>
  23668. An enumeration of possible SMTP status codes.
  23669. </remarks>
  23670. </member>
  23671. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.SystemStatus">
  23672. <summary>
  23673. The "system status" status code.
  23674. </summary>
  23675. </member>
  23676. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.HelpMessage">
  23677. <summary>
  23678. The "help" status code.
  23679. </summary>
  23680. </member>
  23681. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.ServiceReady">
  23682. <summary>
  23683. The "service ready" status code.
  23684. </summary>
  23685. </member>
  23686. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.ServiceClosingTransmissionChannel">
  23687. <summary>
  23688. The "service closing transmission channel" status code.
  23689. </summary>
  23690. </member>
  23691. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.AuthenticationSuccessful">
  23692. <summary>
  23693. The "authentication successful" status code.
  23694. </summary>
  23695. </member>
  23696. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.Ok">
  23697. <summary>
  23698. The general purpose "OK" status code.
  23699. </summary>
  23700. </member>
  23701. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.UserNotLocalWillForward">
  23702. <summary>
  23703. The "User not local; will forward" status code.
  23704. </summary>
  23705. </member>
  23706. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.CannotVerifyUserWillAttemptDelivery">
  23707. <summary>
  23708. The "cannot verify user; will attempt delivery" status code.
  23709. </summary>
  23710. </member>
  23711. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.AuthenticationChallenge">
  23712. <summary>
  23713. The "authentication challenge" status code.
  23714. </summary>
  23715. </member>
  23716. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.StartMailInput">
  23717. <summary>
  23718. The "start mail input" status code.
  23719. </summary>
  23720. </member>
  23721. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.ServiceNotAvailable">
  23722. <summary>
  23723. The "service not available" status code.
  23724. </summary>
  23725. </member>
  23726. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.PasswordTransitionNeeded">
  23727. <summary>
  23728. The "password transition needed" status code.
  23729. </summary>
  23730. </member>
  23731. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.MailboxBusy">
  23732. <summary>
  23733. The "mailbox busy" status code.
  23734. </summary>
  23735. </member>
  23736. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.ErrorInProcessing">
  23737. <summary>
  23738. The "error in processing" status code.
  23739. </summary>
  23740. </member>
  23741. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.InsufficientStorage">
  23742. <summary>
  23743. The "insufficient storage" status code.
  23744. </summary>
  23745. </member>
  23746. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.TemporaryAuthenticationFailure">
  23747. <summary>
  23748. The "temporary authentication failure" status code.
  23749. </summary>
  23750. </member>
  23751. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.CommandUnrecognized">
  23752. <summary>
  23753. The "command unrecognized" status code.
  23754. </summary>
  23755. </member>
  23756. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.SyntaxError">
  23757. <summary>
  23758. The "syntax error" status code.
  23759. </summary>
  23760. </member>
  23761. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.CommandNotImplemented">
  23762. <summary>
  23763. The "command not implemented" status code.
  23764. </summary>
  23765. </member>
  23766. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.BadCommandSequence">
  23767. <summary>
  23768. The "bad command sequence" status code.
  23769. </summary>
  23770. </member>
  23771. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.CommandParameterNotImplemented">
  23772. <summary>
  23773. The "command parameter not implemented" status code.
  23774. </summary>
  23775. </member>
  23776. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.AuthenticationRequired">
  23777. <summary>
  23778. The "authentication required" status code.
  23779. </summary>
  23780. </member>
  23781. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.AuthenticationMechanismTooWeak">
  23782. <summary>
  23783. The "authentication mechanism too weak" status code.
  23784. </summary>
  23785. </member>
  23786. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.AuthenticationInvalidCredentials">
  23787. <summary>
  23788. The "authentication invalid credentials" status code.
  23789. </summary>
  23790. </member>
  23791. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.EncryptionRequiredForAuthenticationMechanism">
  23792. <summary>
  23793. The "encryption required for authentication mechanism" status code.
  23794. </summary>
  23795. </member>
  23796. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.MailboxUnavailable">
  23797. <summary>
  23798. The "mailbox unavailable" status code.
  23799. </summary>
  23800. </member>
  23801. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.UserNotLocalTryAlternatePath">
  23802. <summary>
  23803. The "user not local try alternate path" status code.
  23804. </summary>
  23805. </member>
  23806. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.ExceededStorageAllocation">
  23807. <summary>
  23808. The "exceeded storage allocation" status code.
  23809. </summary>
  23810. </member>
  23811. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.MailboxNameNotAllowed">
  23812. <summary>
  23813. The "mailbox name not allowed" status code.
  23814. </summary>
  23815. </member>
  23816. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.TransactionFailed">
  23817. <summary>
  23818. The "transaction failed" status code.
  23819. </summary>
  23820. </member>
  23821. <member name="F:MailKit.Net.Smtp.SmtpStatusCode.MailFromOrRcptToParametersNotRecognizedOrNotImplemented">
  23822. <summary>
  23823. The "mail from/rcpt to parameters not recognized or not implemented" status code.
  23824. </summary>
  23825. </member>
  23826. <member name="T:MailKit.Net.Smtp.SmtpStream">
  23827. <summary>
  23828. A stream for communicating with an SMTP server.
  23829. </summary>
  23830. <remarks>
  23831. A stream capable of reading SMTP server responses.
  23832. </remarks>
  23833. </member>
  23834. <member name="M:MailKit.Net.Smtp.SmtpStream.#ctor(System.IO.Stream,MailKit.IProtocolLogger)">
  23835. <summary>
  23836. Initializes a new instance of the <see cref="T:MailKit.Net.Smtp.SmtpStream"/> class.
  23837. </summary>
  23838. <remarks>
  23839. Creates a new <see cref="T:MailKit.Net.Smtp.SmtpStream"/>.
  23840. </remarks>
  23841. <param name="source">The underlying network stream.</param>
  23842. <param name="protocolLogger">The protocol logger.</param>
  23843. </member>
  23844. <member name="P:MailKit.Net.Smtp.SmtpStream.Stream">
  23845. <summary>
  23846. Get or sets the underlying network stream.
  23847. </summary>
  23848. <remarks>
  23849. Gets or sets the underlying network stream.
  23850. </remarks>
  23851. <value>The underlying network stream.</value>
  23852. </member>
  23853. <member name="P:MailKit.Net.Smtp.SmtpStream.IsConnected">
  23854. <summary>
  23855. Get whether or not the stream is connected.
  23856. </summary>
  23857. <remarks>
  23858. Gets whether or not the stream is connected.
  23859. </remarks>
  23860. <value><c>true</c> if the stream is connected; otherwise, <c>false</c>.</value>
  23861. </member>
  23862. <member name="P:MailKit.Net.Smtp.SmtpStream.CanRead">
  23863. <summary>
  23864. Get whether the stream supports reading.
  23865. </summary>
  23866. <remarks>
  23867. Gets whether the stream supports reading.
  23868. </remarks>
  23869. <value><c>true</c> if the stream supports reading; otherwise, <c>false</c>.</value>
  23870. </member>
  23871. <member name="P:MailKit.Net.Smtp.SmtpStream.CanWrite">
  23872. <summary>
  23873. Get whether the stream supports writing.
  23874. </summary>
  23875. <remarks>
  23876. Gets whether the stream supports writing.
  23877. </remarks>
  23878. <value><c>true</c> if the stream supports writing; otherwise, <c>false</c>.</value>
  23879. </member>
  23880. <member name="P:MailKit.Net.Smtp.SmtpStream.CanSeek">
  23881. <summary>
  23882. Get whether the stream supports seeking.
  23883. </summary>
  23884. <remarks>
  23885. Gets whether the stream supports seeking.
  23886. </remarks>
  23887. <value><c>true</c> if the stream supports seeking; otherwise, <c>false</c>.</value>
  23888. </member>
  23889. <member name="P:MailKit.Net.Smtp.SmtpStream.CanTimeout">
  23890. <summary>
  23891. Get whether the stream supports I/O timeouts.
  23892. </summary>
  23893. <remarks>
  23894. Gets whether the stream supports I/O timeouts.
  23895. </remarks>
  23896. <value><c>true</c> if the stream supports I/O timeouts; otherwise, <c>false</c>.</value>
  23897. </member>
  23898. <member name="P:MailKit.Net.Smtp.SmtpStream.ReadTimeout">
  23899. <summary>
  23900. Get or set a value, in milliseconds, that determines how long the stream will attempt to read before timing out.
  23901. </summary>
  23902. <remarks>
  23903. Gets or sets a value, in milliseconds, that determines how long the stream will attempt to read before timing out.
  23904. </remarks>
  23905. <returns>A value, in milliseconds, that determines how long the stream will attempt to read before timing out.</returns>
  23906. <value>The read timeout.</value>
  23907. </member>
  23908. <member name="P:MailKit.Net.Smtp.SmtpStream.WriteTimeout">
  23909. <summary>
  23910. Get or set a value, in milliseconds, that determines how long the stream will attempt to write before timing out.
  23911. </summary>
  23912. <remarks>
  23913. Gets or sets a value, in milliseconds, that determines how long the stream will attempt to write before timing out.
  23914. </remarks>
  23915. <returns>A value, in milliseconds, that determines how long the stream will attempt to write before timing out.</returns>
  23916. <value>The write timeout.</value>
  23917. </member>
  23918. <member name="P:MailKit.Net.Smtp.SmtpStream.Position">
  23919. <summary>
  23920. Get or set the position within the current stream.
  23921. </summary>
  23922. <remarks>
  23923. Gets or sets the position within the current stream.
  23924. </remarks>
  23925. <returns>The current position within the stream.</returns>
  23926. <value>The position of the stream.</value>
  23927. <exception cref="T:System.IO.IOException">
  23928. An I/O error occurred.
  23929. </exception>
  23930. <exception cref="T:System.NotSupportedException">
  23931. The stream does not support seeking.
  23932. </exception>
  23933. <exception cref="T:System.ObjectDisposedException">
  23934. The stream has been disposed.
  23935. </exception>
  23936. </member>
  23937. <member name="P:MailKit.Net.Smtp.SmtpStream.Length">
  23938. <summary>
  23939. Get the length of the stream, in bytes.
  23940. </summary>
  23941. <remarks>
  23942. Gets the length of the stream, in bytes.
  23943. </remarks>
  23944. <returns>A long value representing the length of the stream in bytes.</returns>
  23945. <value>The length of the stream.</value>
  23946. <exception cref="T:System.NotSupportedException">
  23947. The stream does not support seeking.
  23948. </exception>
  23949. <exception cref="T:System.ObjectDisposedException">
  23950. The stream has been disposed.
  23951. </exception>
  23952. </member>
  23953. <member name="M:MailKit.Net.Smtp.SmtpStream.Read(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  23954. <summary>
  23955. Reads a sequence of bytes from the stream and advances the position
  23956. within the stream by the number of bytes read.
  23957. </summary>
  23958. <remarks>
  23959. Reads a sequence of bytes from the stream and advances the position
  23960. within the stream by the number of bytes read.
  23961. </remarks>
  23962. <returns>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many
  23963. bytes are not currently available, or zero (0) if the end of the stream has been reached.</returns>
  23964. <param name="buffer">The buffer.</param>
  23965. <param name="offset">The buffer offset.</param>
  23966. <param name="count">The number of bytes to read.</param>
  23967. <param name="cancellationToken">The cancellation token.</param>
  23968. <exception cref="T:System.ArgumentNullException">
  23969. <paramref name="buffer"/> is <c>null</c>.
  23970. </exception>
  23971. <exception cref="T:System.ArgumentOutOfRangeException">
  23972. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  23973. <para>-or-</para>
  23974. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  23975. at the specified <paramref name="offset"/>.</para>
  23976. </exception>
  23977. <exception cref="T:System.ObjectDisposedException">
  23978. The stream has been disposed.
  23979. </exception>
  23980. <exception cref="T:System.OperationCanceledException">
  23981. The operation was canceled via the cancellation token.
  23982. </exception>
  23983. <exception cref="T:System.IO.IOException">
  23984. An I/O error occurred.
  23985. </exception>
  23986. </member>
  23987. <member name="M:MailKit.Net.Smtp.SmtpStream.Read(System.Byte[],System.Int32,System.Int32)">
  23988. <summary>
  23989. Reads a sequence of bytes from the stream and advances the position
  23990. within the stream by the number of bytes read.
  23991. </summary>
  23992. <remarks>
  23993. Reads a sequence of bytes from the stream and advances the position
  23994. within the stream by the number of bytes read.
  23995. </remarks>
  23996. <returns>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many
  23997. bytes are not currently available, or zero (0) if the end of the stream has been reached.</returns>
  23998. <param name="buffer">The buffer.</param>
  23999. <param name="offset">The buffer offset.</param>
  24000. <param name="count">The number of bytes to read.</param>
  24001. <exception cref="T:System.ArgumentNullException">
  24002. <paramref name="buffer"/> is <c>null</c>.
  24003. </exception>
  24004. <exception cref="T:System.ArgumentOutOfRangeException">
  24005. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  24006. <para>-or-</para>
  24007. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  24008. at the specified <paramref name="offset"/>.</para>
  24009. </exception>
  24010. <exception cref="T:System.ObjectDisposedException">
  24011. The stream has been disposed.
  24012. </exception>
  24013. <exception cref="T:System.IO.IOException">
  24014. An I/O error occurred.
  24015. </exception>
  24016. </member>
  24017. <member name="M:MailKit.Net.Smtp.SmtpStream.ReadAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  24018. <summary>
  24019. Asynchronously reads a sequence of bytes from the stream and advances the position
  24020. within the stream by the number of bytes read.
  24021. </summary>
  24022. <remarks>
  24023. Reads a sequence of bytes from the stream and advances the position
  24024. within the stream by the number of bytes read.
  24025. </remarks>
  24026. <returns>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many
  24027. bytes are not currently available, or zero (0) if the end of the stream has been reached.</returns>
  24028. <param name="buffer">The buffer.</param>
  24029. <param name="offset">The buffer offset.</param>
  24030. <param name="count">The number of bytes to read.</param>
  24031. <param name="cancellationToken">The cancellation token.</param>
  24032. <exception cref="T:System.ArgumentNullException">
  24033. <paramref name="buffer"/> is <c>null</c>.
  24034. </exception>
  24035. <exception cref="T:System.ArgumentOutOfRangeException">
  24036. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  24037. <para>-or-</para>
  24038. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  24039. at the specified <paramref name="offset"/>.</para>
  24040. </exception>
  24041. <exception cref="T:System.ObjectDisposedException">
  24042. The stream has been disposed.
  24043. </exception>
  24044. <exception cref="T:System.OperationCanceledException">
  24045. The operation was canceled via the cancellation token.
  24046. </exception>
  24047. <exception cref="T:System.IO.IOException">
  24048. An I/O error occurred.
  24049. </exception>
  24050. </member>
  24051. <member name="M:MailKit.Net.Smtp.SmtpStream.ReadResponse(System.Threading.CancellationToken)">
  24052. <summary>
  24053. Read an SMTP server response.
  24054. </summary>
  24055. <remarks>
  24056. Reads a full command response from the SMTP server.
  24057. </remarks>
  24058. <returns>The response.</returns>
  24059. <param name="cancellationToken">The cancellation token.</param>
  24060. <exception cref="T:System.ObjectDisposedException">
  24061. The stream has been disposed.
  24062. </exception>
  24063. <exception cref="T:System.OperationCanceledException">
  24064. The operation was canceled via the cancellation token.
  24065. </exception>
  24066. <exception cref="T:System.IO.IOException">
  24067. An I/O error occurred.
  24068. </exception>
  24069. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  24070. An SMTP protocol error occurred.
  24071. </exception>
  24072. </member>
  24073. <member name="M:MailKit.Net.Smtp.SmtpStream.ReadResponseAsync(System.Threading.CancellationToken)">
  24074. <summary>
  24075. Asynchronously read an SMTP server response.
  24076. </summary>
  24077. <remarks>
  24078. Reads a full command response from the SMTP server.
  24079. </remarks>
  24080. <returns>The response.</returns>
  24081. <param name="cancellationToken">The cancellation token.</param>
  24082. <exception cref="T:System.ObjectDisposedException">
  24083. The stream has been disposed.
  24084. </exception>
  24085. <exception cref="T:System.OperationCanceledException">
  24086. The operation was canceled via the cancellation token.
  24087. </exception>
  24088. <exception cref="T:System.IO.IOException">
  24089. An I/O error occurred.
  24090. </exception>
  24091. <exception cref="T:MailKit.Net.Smtp.SmtpProtocolException">
  24092. An SMTP protocol error occurred.
  24093. </exception>
  24094. </member>
  24095. <member name="M:MailKit.Net.Smtp.SmtpStream.Write(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  24096. <summary>
  24097. Writes a sequence of bytes to the stream and advances the current
  24098. position within this stream by the number of bytes written.
  24099. </summary>
  24100. <remarks>
  24101. Writes a sequence of bytes to the stream and advances the current
  24102. position within this stream by the number of bytes written.
  24103. </remarks>
  24104. <param name='buffer'>The buffer to write.</param>
  24105. <param name='offset'>The offset of the first byte to write.</param>
  24106. <param name='count'>The number of bytes to write.</param>
  24107. <param name="cancellationToken">The cancellation token.</param>
  24108. <exception cref="T:System.ArgumentNullException">
  24109. <paramref name="buffer"/> is <c>null</c>.
  24110. </exception>
  24111. <exception cref="T:System.ArgumentOutOfRangeException">
  24112. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  24113. <para>-or-</para>
  24114. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  24115. at the specified <paramref name="offset"/>.</para>
  24116. </exception>
  24117. <exception cref="T:System.ObjectDisposedException">
  24118. The stream has been disposed.
  24119. </exception>
  24120. <exception cref="T:System.NotSupportedException">
  24121. The stream does not support writing.
  24122. </exception>
  24123. <exception cref="T:System.OperationCanceledException">
  24124. The operation was canceled via the cancellation token.
  24125. </exception>
  24126. <exception cref="T:System.IO.IOException">
  24127. An I/O error occurred.
  24128. </exception>
  24129. </member>
  24130. <member name="M:MailKit.Net.Smtp.SmtpStream.Write(System.Byte[],System.Int32,System.Int32)">
  24131. <summary>
  24132. Writes a sequence of bytes to the stream and advances the current
  24133. position within this stream by the number of bytes written.
  24134. </summary>
  24135. <remarks>
  24136. Writes a sequence of bytes to the stream and advances the current
  24137. position within this stream by the number of bytes written.
  24138. </remarks>
  24139. <param name='buffer'>The buffer to write.</param>
  24140. <param name='offset'>The offset of the first byte to write.</param>
  24141. <param name='count'>The number of bytes to write.</param>
  24142. <exception cref="T:System.ArgumentNullException">
  24143. <paramref name="buffer"/> is <c>null</c>.
  24144. </exception>
  24145. <exception cref="T:System.ArgumentOutOfRangeException">
  24146. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  24147. <para>-or-</para>
  24148. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  24149. at the specified <paramref name="offset"/>.</para>
  24150. </exception>
  24151. <exception cref="T:System.ObjectDisposedException">
  24152. The stream has been disposed.
  24153. </exception>
  24154. <exception cref="T:System.NotSupportedException">
  24155. The stream does not support writing.
  24156. </exception>
  24157. <exception cref="T:System.IO.IOException">
  24158. An I/O error occurred.
  24159. </exception>
  24160. </member>
  24161. <member name="M:MailKit.Net.Smtp.SmtpStream.WriteAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  24162. <summary>
  24163. Asynchronously writes a sequence of bytes to the stream and advances the current
  24164. position within this stream by the number of bytes written.
  24165. </summary>
  24166. <remarks>
  24167. Writes a sequence of bytes to the stream and advances the current
  24168. position within this stream by the number of bytes written.
  24169. </remarks>
  24170. <returns>A task that represents the asynchronous write operation.</returns>
  24171. <param name='buffer'>The buffer to write.</param>
  24172. <param name='offset'>The offset of the first byte to write.</param>
  24173. <param name='count'>The number of bytes to write.</param>
  24174. <param name="cancellationToken">The cancellation token.</param>
  24175. <exception cref="T:System.ArgumentNullException">
  24176. <paramref name="buffer"/> is <c>null</c>.
  24177. </exception>
  24178. <exception cref="T:System.ArgumentOutOfRangeException">
  24179. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  24180. <para>-or-</para>
  24181. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  24182. at the specified <paramref name="offset"/>.</para>
  24183. </exception>
  24184. <exception cref="T:System.ObjectDisposedException">
  24185. The stream has been disposed.
  24186. </exception>
  24187. <exception cref="T:System.NotSupportedException">
  24188. The stream does not support writing.
  24189. </exception>
  24190. <exception cref="T:System.OperationCanceledException">
  24191. The operation was canceled via the cancellation token.
  24192. </exception>
  24193. <exception cref="T:System.IO.IOException">
  24194. An I/O error occurred.
  24195. </exception>
  24196. </member>
  24197. <member name="M:MailKit.Net.Smtp.SmtpStream.Flush(System.Threading.CancellationToken)">
  24198. <summary>
  24199. Clears all buffers for this stream and causes any buffered data to be written
  24200. to the underlying device.
  24201. </summary>
  24202. <remarks>
  24203. Clears all buffers for this stream and causes any buffered data to be written
  24204. to the underlying device.
  24205. </remarks>
  24206. <param name="cancellationToken">The cancellation token.</param>
  24207. <exception cref="T:System.ObjectDisposedException">
  24208. The stream has been disposed.
  24209. </exception>
  24210. <exception cref="T:System.NotSupportedException">
  24211. The stream does not support writing.
  24212. </exception>
  24213. <exception cref="T:System.OperationCanceledException">
  24214. The operation was canceled via the cancellation token.
  24215. </exception>
  24216. <exception cref="T:System.IO.IOException">
  24217. An I/O error occurred.
  24218. </exception>
  24219. </member>
  24220. <member name="M:MailKit.Net.Smtp.SmtpStream.Flush">
  24221. <summary>
  24222. Clears all buffers for this stream and causes any buffered data to be written
  24223. to the underlying device.
  24224. </summary>
  24225. <remarks>
  24226. Clears all buffers for this stream and causes any buffered data to be written
  24227. to the underlying device.
  24228. </remarks>
  24229. <exception cref="T:System.ObjectDisposedException">
  24230. The stream has been disposed.
  24231. </exception>
  24232. <exception cref="T:System.NotSupportedException">
  24233. The stream does not support writing.
  24234. </exception>
  24235. <exception cref="T:System.IO.IOException">
  24236. An I/O error occurred.
  24237. </exception>
  24238. </member>
  24239. <member name="M:MailKit.Net.Smtp.SmtpStream.FlushAsync(System.Threading.CancellationToken)">
  24240. <summary>
  24241. Asynchronously clears all buffers for this stream and causes any buffered data to be written
  24242. to the underlying device.
  24243. </summary>
  24244. <remarks>
  24245. Clears all buffers for this stream and causes any buffered data to be written
  24246. to the underlying device.
  24247. </remarks>
  24248. <returns>A task that represents the asynchronous flush operation.</returns>
  24249. <param name="cancellationToken">The cancellation token.</param>
  24250. <exception cref="T:System.ObjectDisposedException">
  24251. The stream has been disposed.
  24252. </exception>
  24253. <exception cref="T:System.NotSupportedException">
  24254. The stream does not support writing.
  24255. </exception>
  24256. <exception cref="T:System.OperationCanceledException">
  24257. The operation was canceled via the cancellation token.
  24258. </exception>
  24259. <exception cref="T:System.IO.IOException">
  24260. An I/O error occurred.
  24261. </exception>
  24262. </member>
  24263. <member name="M:MailKit.Net.Smtp.SmtpStream.Seek(System.Int64,System.IO.SeekOrigin)">
  24264. <summary>
  24265. Sets the position within the current stream.
  24266. </summary>
  24267. <returns>The new position within the stream.</returns>
  24268. <param name="offset">The offset into the stream relative to the <paramref name="origin"/>.</param>
  24269. <param name="origin">The origin to seek from.</param>
  24270. <exception cref="T:System.NotSupportedException">
  24271. The stream does not support seeking.
  24272. </exception>
  24273. </member>
  24274. <member name="M:MailKit.Net.Smtp.SmtpStream.SetLength(System.Int64)">
  24275. <summary>
  24276. Sets the length of the stream.
  24277. </summary>
  24278. <param name="value">The desired length of the stream in bytes.</param>
  24279. <exception cref="T:System.NotSupportedException">
  24280. The stream does not support setting the length.
  24281. </exception>
  24282. </member>
  24283. <member name="M:MailKit.Net.Smtp.SmtpStream.Dispose(System.Boolean)">
  24284. <summary>
  24285. Releases the unmanaged resources used by the <see cref="T:MailKit.Net.Smtp.SmtpStream"/> and
  24286. optionally releases the managed resources.
  24287. </summary>
  24288. <remarks>
  24289. Releases the unmanaged resources used by the <see cref="T:MailKit.Net.Smtp.SmtpStream"/> and
  24290. optionally releases the managed resources.
  24291. </remarks>
  24292. <param name="disposing"><c>true</c> to release both managed and unmanaged resources;
  24293. <c>false</c> to release only the unmanaged resources.</param>
  24294. </member>
  24295. <member name="T:MailKit.Net.Smtp.DeliveryStatusNotificationType">
  24296. <summary>
  24297. Delivery status notification type.
  24298. </summary>
  24299. <remarks>
  24300. The delivery status notification type specifies whether or not
  24301. the full message should be included in any failed DSN issued for
  24302. a message transmission as opposed to just the headers.
  24303. </remarks>
  24304. </member>
  24305. <member name="F:MailKit.Net.Smtp.DeliveryStatusNotificationType.Unspecified">
  24306. <summary>
  24307. The return type is unspecified, allowing the server to choose.
  24308. </summary>
  24309. </member>
  24310. <member name="F:MailKit.Net.Smtp.DeliveryStatusNotificationType.Full">
  24311. <summary>
  24312. The full message should be included in any failed delivery status notification issued by the server.
  24313. </summary>
  24314. </member>
  24315. <member name="F:MailKit.Net.Smtp.DeliveryStatusNotificationType.HeadersOnly">
  24316. <summary>
  24317. Only the headers should be included in any failed delivery status notification issued by the server.
  24318. </summary>
  24319. </member>
  24320. <member name="T:MailKit.Search.AnnotationSearchQuery">
  24321. <summary>
  24322. An annotation-based search query.
  24323. </summary>
  24324. <remarks>
  24325. An annotation-based search query.
  24326. </remarks>
  24327. </member>
  24328. <member name="M:MailKit.Search.AnnotationSearchQuery.#ctor(MailKit.AnnotationEntry,MailKit.AnnotationAttribute,System.String)">
  24329. <summary>
  24330. Initializes a new instance of the <see cref="T:MailKit.Search.AnnotationSearchQuery"/> class.
  24331. </summary>
  24332. <remarks>
  24333. Creates a new annotation-based search query.
  24334. </remarks>
  24335. <param name="entry">The annotation entry.</param>
  24336. <param name="attribute">The annotation attribute.</param>
  24337. <param name="value">The annotation attribute value.</param>
  24338. <exception cref="T:System.ArgumentNullException">
  24339. <para><paramref name="entry"/> is <c>null</c>.</para>
  24340. <para>-or-</para>
  24341. <para><paramref name="attribute"/> is <c>null</c>.</para>
  24342. </exception>
  24343. <exception cref="T:System.ArgumentException">
  24344. <paramref name="attribute"/> is not a valid attribute for searching.
  24345. </exception>
  24346. </member>
  24347. <member name="P:MailKit.Search.AnnotationSearchQuery.Entry">
  24348. <summary>
  24349. Get the annotation entry.
  24350. </summary>
  24351. <remarks>
  24352. Gets the annotation entry.
  24353. </remarks>
  24354. <value>The annotation entry.</value>
  24355. </member>
  24356. <member name="P:MailKit.Search.AnnotationSearchQuery.Attribute">
  24357. <summary>
  24358. Get the annotation attribute.
  24359. </summary>
  24360. <remarks>
  24361. Gets the annotation attribute.
  24362. </remarks>
  24363. <value>The annotation attribute.</value>
  24364. </member>
  24365. <member name="P:MailKit.Search.AnnotationSearchQuery.Value">
  24366. <summary>
  24367. Get the annotation attribute value.
  24368. </summary>
  24369. <remarks>
  24370. Gets the annotation attribute value.
  24371. </remarks>
  24372. <value>The annotation attribute value.</value>
  24373. </member>
  24374. <member name="T:MailKit.Search.BinarySearchQuery">
  24375. <summary>
  24376. A binary search query such as an AND or OR expression.
  24377. </summary>
  24378. <remarks>
  24379. A binary search query such as an AND or OR expression.
  24380. </remarks>
  24381. </member>
  24382. <member name="M:MailKit.Search.BinarySearchQuery.#ctor(MailKit.Search.SearchTerm,MailKit.Search.SearchQuery,MailKit.Search.SearchQuery)">
  24383. <summary>
  24384. Initializes a new instance of the <see cref="T:MailKit.Search.BinarySearchQuery"/> class.
  24385. </summary>
  24386. <remarks>
  24387. Creates a new binary search query.
  24388. </remarks>
  24389. <param name="term">THe search term.</param>
  24390. <param name="left">The left expression.</param>
  24391. <param name="right">The right expression.</param>
  24392. <exception cref="T:System.ArgumentNullException">
  24393. <para><paramref name="left"/> is <c>null</c>.</para>
  24394. <para>-or-</para>
  24395. <para><paramref name="right"/> is <c>null</c>.</para>
  24396. </exception>
  24397. </member>
  24398. <member name="P:MailKit.Search.BinarySearchQuery.Left">
  24399. <summary>
  24400. Gets the left operand of the expression.
  24401. </summary>
  24402. <remarks>
  24403. Gets the left operand of the expression.
  24404. </remarks>
  24405. <value>The left operand.</value>
  24406. </member>
  24407. <member name="P:MailKit.Search.BinarySearchQuery.Right">
  24408. <summary>
  24409. Gets the right operand of the expression.
  24410. </summary>
  24411. <remarks>
  24412. Gets the right operand of the expression.
  24413. </remarks>
  24414. <value>The right operand.</value>
  24415. </member>
  24416. <member name="T:MailKit.Search.DateSearchQuery">
  24417. <summary>
  24418. A date-based search query.
  24419. </summary>
  24420. <remarks>
  24421. A date-based search query.
  24422. </remarks>
  24423. </member>
  24424. <member name="M:MailKit.Search.DateSearchQuery.#ctor(MailKit.Search.SearchTerm,System.DateTime)">
  24425. <summary>
  24426. Initializes a new instance of the <see cref="T:MailKit.Search.DateSearchQuery"/> class.
  24427. </summary>
  24428. <remarks>
  24429. Creates a new date-based search query.
  24430. </remarks>
  24431. <param name="term">The search term.</param>
  24432. <param name="date">The date.</param>
  24433. </member>
  24434. <member name="P:MailKit.Search.DateSearchQuery.Date">
  24435. <summary>
  24436. Gets the date value of the search query.
  24437. </summary>
  24438. <remarks>
  24439. Gets the date value of the search query.
  24440. </remarks>
  24441. <value>The date.</value>
  24442. </member>
  24443. <member name="T:MailKit.Search.FilterSearchQuery">
  24444. <summary>
  24445. A filter-based search query.
  24446. </summary>
  24447. <remarks>
  24448. A filter-based search query.
  24449. </remarks>
  24450. </member>
  24451. <member name="M:MailKit.Search.FilterSearchQuery.#ctor(System.String)">
  24452. <summary>
  24453. Initializes a new instance of the <see cref="T:MailKit.Search.FilterSearchQuery"/> class.
  24454. </summary>
  24455. <remarks>
  24456. A search query that references a predefined filter.
  24457. </remarks>
  24458. <param name="name">The name of the filter.</param>
  24459. <exception cref="T:System.ArgumentNullException">
  24460. <paramref name="name"/> is <c>null</c>.
  24461. </exception>
  24462. <exception cref="T:System.ArgumentException">
  24463. <paramref name="name"/> is empty.
  24464. </exception>
  24465. </member>
  24466. <member name="M:MailKit.Search.FilterSearchQuery.#ctor(MailKit.MetadataTag)">
  24467. <summary>
  24468. Initializes a new instance of the <see cref="T:MailKit.Search.FilterSearchQuery"/> class.
  24469. </summary>
  24470. <remarks>
  24471. A search query that references a predefined filter.
  24472. </remarks>
  24473. <param name="filter">The metadata tag representing the filter.</param>
  24474. <exception cref="T:System.ArgumentException">
  24475. <paramref name="filter"/> does not reference a valid filter.
  24476. </exception>
  24477. </member>
  24478. <member name="P:MailKit.Search.FilterSearchQuery.Name">
  24479. <summary>
  24480. Get the name of the filter.
  24481. </summary>
  24482. <remarks>
  24483. Gets the name of the filter.
  24484. </remarks>
  24485. <value>The name of the filter.</value>
  24486. </member>
  24487. <member name="T:MailKit.Search.HeaderSearchQuery">
  24488. <summary>
  24489. A header-based search query.
  24490. </summary>
  24491. <remarks>
  24492. A header-based search query.
  24493. </remarks>
  24494. </member>
  24495. <member name="M:MailKit.Search.HeaderSearchQuery.#ctor(System.String,System.String)">
  24496. <summary>
  24497. Initializes a new instance of the <see cref="T:MailKit.Search.HeaderSearchQuery"/> class.
  24498. </summary>
  24499. <remarks>
  24500. Creates a new header search query.
  24501. </remarks>
  24502. <param name="field">The header field name.</param>
  24503. <param name="value">The value to match against.</param>
  24504. <exception cref="T:System.ArgumentNullException">
  24505. <para><paramref name="field"/> is <c>null</c>.</para>
  24506. <para>-or-</para>
  24507. <para><paramref name="value"/> is <c>null</c>.</para>
  24508. </exception>
  24509. <exception cref="T:System.ArgumentException">
  24510. <paramref name="field"/> is empty.
  24511. </exception>
  24512. </member>
  24513. <member name="P:MailKit.Search.HeaderSearchQuery.Field">
  24514. <summary>
  24515. Gets the header field name.
  24516. </summary>
  24517. <remarks>
  24518. Gets the header field name.
  24519. </remarks>
  24520. <value>The header field.</value>
  24521. </member>
  24522. <member name="P:MailKit.Search.HeaderSearchQuery.Value">
  24523. <summary>
  24524. Gets the value to match against.
  24525. </summary>
  24526. <remarks>
  24527. Gets the value to match against.
  24528. </remarks>
  24529. <value>The value.</value>
  24530. </member>
  24531. <member name="T:MailKit.Search.NumericSearchQuery">
  24532. <summary>
  24533. A numeric search query.
  24534. </summary>
  24535. <remarks>
  24536. A numeric search query.
  24537. </remarks>
  24538. </member>
  24539. <member name="M:MailKit.Search.NumericSearchQuery.#ctor(MailKit.Search.SearchTerm,System.UInt64)">
  24540. <summary>
  24541. Initializes a new instance of the <see cref="T:MailKit.Search.NumericSearchQuery"/> class.
  24542. </summary>
  24543. <remarks>
  24544. Creates a new numeric search query.
  24545. </remarks>
  24546. <param name="term">The search term.</param>
  24547. <param name="value">The numeric value.</param>
  24548. </member>
  24549. <member name="P:MailKit.Search.NumericSearchQuery.Value">
  24550. <summary>
  24551. Gets the numeric value to match against.
  24552. </summary>
  24553. <remarks>
  24554. Gets the numeric value to match against.
  24555. </remarks>
  24556. <value>The numeric value.</value>
  24557. </member>
  24558. <member name="T:MailKit.Search.OrderBy">
  24559. <summary>
  24560. Specifies a sort order for search results.
  24561. </summary>
  24562. <remarks>
  24563. You can combine multiple <see cref="T:MailKit.Search.OrderBy"/> rules to specify the sort
  24564. order that <see cref="M:MailKit.IMailFolder.Sort(MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)"/>
  24565. should return the results in.
  24566. </remarks>
  24567. </member>
  24568. <member name="M:MailKit.Search.OrderBy.#ctor(MailKit.Search.OrderByType,MailKit.Search.SortOrder)">
  24569. <summary>
  24570. Initializes a new instance of the <see cref="T:MailKit.Search.OrderBy"/> class.
  24571. </summary>
  24572. <param name="type">The field to sort by.</param>
  24573. <param name="order">The sort order.</param>
  24574. <exception cref="T:System.ArgumentOutOfRangeException">
  24575. <paramref name="order"/> cannot be <see cref="F:MailKit.Search.SortOrder.None"/>.
  24576. </exception>
  24577. </member>
  24578. <member name="P:MailKit.Search.OrderBy.Type">
  24579. <summary>
  24580. Gets the field used for sorting.
  24581. </summary>
  24582. <remarks>
  24583. Gets the field used for sorting.
  24584. </remarks>
  24585. <value>The field used for sorting.</value>
  24586. </member>
  24587. <member name="P:MailKit.Search.OrderBy.Order">
  24588. <summary>
  24589. Gets the sort order.
  24590. </summary>
  24591. <remarks>
  24592. Gets the sort order.
  24593. </remarks>
  24594. <value>The sort order.</value>
  24595. </member>
  24596. <member name="F:MailKit.Search.OrderBy.Arrival">
  24597. <summary>
  24598. Sort results by arrival date in ascending order.
  24599. </summary>
  24600. <remarks>
  24601. Sort results by arrival date in ascending order.
  24602. </remarks>
  24603. </member>
  24604. <member name="F:MailKit.Search.OrderBy.ReverseArrival">
  24605. <summary>
  24606. Sort results by arrival date in desending order.
  24607. </summary>
  24608. <remarks>
  24609. Sort results by arrival date in desending order.
  24610. </remarks>
  24611. </member>
  24612. <member name="F:MailKit.Search.OrderBy.Cc">
  24613. <summary>
  24614. Sort results by the first email address in the Cc header in ascending order.
  24615. </summary>
  24616. <remarks>
  24617. Sort results by the first email address in the Cc header in ascending order.
  24618. </remarks>
  24619. </member>
  24620. <member name="F:MailKit.Search.OrderBy.ReverseCc">
  24621. <summary>
  24622. Sort results by the first email address in the Cc header in descending order.
  24623. </summary>
  24624. <remarks>
  24625. Sort results by the first email address in the Cc header in descending order.
  24626. </remarks>
  24627. </member>
  24628. <member name="F:MailKit.Search.OrderBy.Date">
  24629. <summary>
  24630. Sort results by the sent date in ascending order.
  24631. </summary>
  24632. <remarks>
  24633. Sort results by the sent date in ascending order.
  24634. </remarks>
  24635. </member>
  24636. <member name="F:MailKit.Search.OrderBy.ReverseDate">
  24637. <summary>
  24638. Sort results by the sent date in descending order.
  24639. </summary>
  24640. <remarks>
  24641. Sort results by the sent date in descending order.
  24642. </remarks>
  24643. </member>
  24644. <member name="F:MailKit.Search.OrderBy.From">
  24645. <summary>
  24646. Sort results by the first email address in the From header in ascending order.
  24647. </summary>
  24648. <remarks>
  24649. Sort results by the first email address in the From header in ascending order.
  24650. </remarks>
  24651. </member>
  24652. <member name="F:MailKit.Search.OrderBy.ReverseFrom">
  24653. <summary>
  24654. Sort results by the first email address in the From header in descending order.
  24655. </summary>
  24656. <remarks>
  24657. Sort results by the first email address in the From header in descending order.
  24658. </remarks>
  24659. </member>
  24660. <member name="F:MailKit.Search.OrderBy.DisplayFrom">
  24661. <summary>
  24662. Sort results by the first display name in the From header in ascending order.
  24663. </summary>
  24664. <remarks>
  24665. Sort results by the first display name in the From header in ascending order.
  24666. </remarks>
  24667. </member>
  24668. <member name="F:MailKit.Search.OrderBy.ReverseDisplayFrom">
  24669. <summary>
  24670. Sort results by the first display name in the From header in descending order.
  24671. </summary>
  24672. <remarks>
  24673. Sort results by the first display name in the From header in descending order.
  24674. </remarks>
  24675. </member>
  24676. <member name="F:MailKit.Search.OrderBy.Size">
  24677. <summary>
  24678. Sort results by the message size in ascending order.
  24679. </summary>
  24680. <remarks>
  24681. Sort results by the message size in ascending order.
  24682. </remarks>
  24683. </member>
  24684. <member name="F:MailKit.Search.OrderBy.ReverseSize">
  24685. <summary>
  24686. Sort results by the message size in descending order.
  24687. </summary>
  24688. <remarks>
  24689. Sort results by the message size in descending order.
  24690. </remarks>
  24691. </member>
  24692. <member name="F:MailKit.Search.OrderBy.Subject">
  24693. <summary>
  24694. Sort results by the Subject header in ascending order.
  24695. </summary>
  24696. <remarks>
  24697. Sort results by the Subject header in ascending order.
  24698. </remarks>
  24699. </member>
  24700. <member name="F:MailKit.Search.OrderBy.ReverseSubject">
  24701. <summary>
  24702. Sort results by the Subject header in descending order.
  24703. </summary>
  24704. <remarks>
  24705. Sort results by the Subject header in descending order.
  24706. </remarks>
  24707. </member>
  24708. <member name="F:MailKit.Search.OrderBy.To">
  24709. <summary>
  24710. Sort results by the first email address in the To header in ascending order.
  24711. </summary>
  24712. <remarks>
  24713. Sort results by the first email address in the To header in ascending order.
  24714. </remarks>
  24715. </member>
  24716. <member name="F:MailKit.Search.OrderBy.ReverseTo">
  24717. <summary>
  24718. Sort results by the first email address in the To header in descending order.
  24719. </summary>
  24720. <remarks>
  24721. Sort results by the first email address in the To header in descending order.
  24722. </remarks>
  24723. </member>
  24724. <member name="F:MailKit.Search.OrderBy.DisplayTo">
  24725. <summary>
  24726. Sort results by the first display name in the To header in ascending order.
  24727. </summary>
  24728. <remarks>
  24729. Sort results by the first display name in the To header in ascending order.
  24730. </remarks>
  24731. </member>
  24732. <member name="F:MailKit.Search.OrderBy.ReverseDisplayTo">
  24733. <summary>
  24734. Sort results by the first display name in the To header in descending order.
  24735. </summary>
  24736. <remarks>
  24737. Sort results by the first display name in the To header in descending order.
  24738. </remarks>
  24739. </member>
  24740. <member name="T:MailKit.Search.OrderByAnnotation">
  24741. <summary>
  24742. Specifies an annotation-based sort order for search results.
  24743. </summary>
  24744. <remarks>
  24745. You can combine multiple <see cref="T:MailKit.Search.OrderBy"/> rules to specify the sort
  24746. order that <see cref="M:MailKit.IMailFolder.Sort(MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)"/>
  24747. should return the results in.
  24748. </remarks>
  24749. </member>
  24750. <member name="M:MailKit.Search.OrderByAnnotation.#ctor(MailKit.AnnotationEntry,MailKit.AnnotationAttribute,MailKit.Search.SortOrder)">
  24751. <summary>
  24752. Initializes a new instance of the <see cref="T:MailKit.Search.OrderByAnnotation"/> class.
  24753. </summary>
  24754. <param name="entry">The annotation entry to sort by.</param>
  24755. <param name="attribute">The annotation attribute to use for sorting.</param>
  24756. <param name="order">The sort order.</param>
  24757. <exception cref="T:System.ArgumentNullException">
  24758. <para><paramref name="entry"/> is <c>null</c>.</para>
  24759. <para>-or-</para>
  24760. <para><paramref name="attribute"/>is <c>null</c>.</para>
  24761. </exception>
  24762. <exception cref="T:System.ArgumentException">
  24763. <paramref name="attribute"/> is not a valid attribute for sorting.
  24764. </exception>
  24765. </member>
  24766. <member name="P:MailKit.Search.OrderByAnnotation.Entry">
  24767. <summary>
  24768. Get the annotation entry.
  24769. </summary>
  24770. <remarks>
  24771. Gets the annotation entry.
  24772. </remarks>
  24773. <value>The annotation entry.</value>
  24774. </member>
  24775. <member name="P:MailKit.Search.OrderByAnnotation.Attribute">
  24776. <summary>
  24777. Get the annotation attribute.
  24778. </summary>
  24779. <remarks>
  24780. Gets the annotation attribute.
  24781. </remarks>
  24782. <value>The annotation attribute.</value>
  24783. </member>
  24784. <member name="T:MailKit.Search.OrderByType">
  24785. <summary>
  24786. The field to sort by.
  24787. </summary>
  24788. <remarks>
  24789. The field to sort by.
  24790. </remarks>
  24791. </member>
  24792. <member name="F:MailKit.Search.OrderByType.Annotation">
  24793. <summary>
  24794. Sort by an annotation value.
  24795. </summary>
  24796. </member>
  24797. <member name="F:MailKit.Search.OrderByType.Arrival">
  24798. <summary>
  24799. Sort by the arrival date.
  24800. </summary>
  24801. </member>
  24802. <member name="F:MailKit.Search.OrderByType.Cc">
  24803. <summary>
  24804. Sort by the Cc header.
  24805. </summary>
  24806. </member>
  24807. <member name="F:MailKit.Search.OrderByType.Date">
  24808. <summary>
  24809. Sort by the Date header.
  24810. </summary>
  24811. </member>
  24812. <member name="F:MailKit.Search.OrderByType.DisplayFrom">
  24813. <summary>
  24814. Sort by the Display Name of the From header.
  24815. </summary>
  24816. </member>
  24817. <member name="F:MailKit.Search.OrderByType.DisplayTo">
  24818. <summary>
  24819. Sort by the Display Name of the To header.
  24820. </summary>
  24821. </member>
  24822. <member name="F:MailKit.Search.OrderByType.From">
  24823. <summary>
  24824. Sort by the From header.
  24825. </summary>
  24826. </member>
  24827. <member name="F:MailKit.Search.OrderByType.ModSeq">
  24828. <summary>
  24829. Sort by the mod-sequence.
  24830. </summary>
  24831. </member>
  24832. <member name="F:MailKit.Search.OrderByType.Size">
  24833. <summary>
  24834. Sort by the message size.
  24835. </summary>
  24836. </member>
  24837. <member name="F:MailKit.Search.OrderByType.Subject">
  24838. <summary>
  24839. Sort by the message subject.
  24840. </summary>
  24841. </member>
  24842. <member name="F:MailKit.Search.OrderByType.To">
  24843. <summary>
  24844. Sort by the To header.
  24845. </summary>
  24846. </member>
  24847. <member name="T:MailKit.Search.SearchOptions">
  24848. <summary>
  24849. Advanced search options.
  24850. </summary>
  24851. <remarks>
  24852. Advanced search options.
  24853. </remarks>
  24854. </member>
  24855. <member name="F:MailKit.Search.SearchOptions.None">
  24856. <summary>
  24857. No options specified.
  24858. </summary>
  24859. </member>
  24860. <member name="F:MailKit.Search.SearchOptions.All">
  24861. <summary>
  24862. Returns all of the matching unique identifiers.
  24863. </summary>
  24864. </member>
  24865. <member name="F:MailKit.Search.SearchOptions.Count">
  24866. <summary>
  24867. Returns the number of messages that match the search query.
  24868. </summary>
  24869. </member>
  24870. <member name="F:MailKit.Search.SearchOptions.Min">
  24871. <summary>
  24872. Returns the minimum unique identifier of the messages that match the search query.
  24873. </summary>
  24874. </member>
  24875. <member name="F:MailKit.Search.SearchOptions.Max">
  24876. <summary>
  24877. Returns the maximum unique identifier of the messages that match the search query.
  24878. </summary>
  24879. </member>
  24880. <member name="F:MailKit.Search.SearchOptions.Relevancy">
  24881. <summary>
  24882. Returns the relevancy scores of the messages that match the query. Can only be used
  24883. when using FUZZY search.
  24884. </summary>
  24885. </member>
  24886. <member name="T:MailKit.Search.SearchQuery">
  24887. <summary>
  24888. A specialized query for searching messages in a <see cref="T:MailKit.IMailFolder"/>.
  24889. </summary>
  24890. <remarks>
  24891. A specialized query for searching messages in a <see cref="T:MailKit.IMailFolder"/>.
  24892. </remarks>
  24893. </member>
  24894. <member name="M:MailKit.Search.SearchQuery.#ctor">
  24895. <summary>
  24896. Initializes a new instance of the <see cref="T:MailKit.Search.SearchQuery"/> class.
  24897. </summary>
  24898. <remarks>
  24899. Creates a new <see cref="T:MailKit.Search.SearchQuery"/> that matches all messages.
  24900. </remarks>
  24901. </member>
  24902. <member name="M:MailKit.Search.SearchQuery.#ctor(MailKit.Search.SearchTerm)">
  24903. <summary>
  24904. Initializes a new instance of the <see cref="T:MailKit.Search.SearchQuery"/> class.
  24905. </summary>
  24906. <remarks>
  24907. Creates a new <see cref="T:MailKit.Search.SearchQuery"/> with the specified search term.
  24908. </remarks>
  24909. <param name="term">The search term.</param>
  24910. </member>
  24911. <member name="P:MailKit.Search.SearchQuery.Term">
  24912. <summary>
  24913. Get the search term used by the search query.
  24914. </summary>
  24915. <remarks>
  24916. Gets the search term used by the search query.
  24917. </remarks>
  24918. <value>The term.</value>
  24919. </member>
  24920. <member name="F:MailKit.Search.SearchQuery.All">
  24921. <summary>
  24922. Match all messages in the folder.
  24923. </summary>
  24924. <remarks>
  24925. Matches all messages in the folder.
  24926. </remarks>
  24927. </member>
  24928. <member name="M:MailKit.Search.SearchQuery.And(MailKit.Search.SearchQuery,MailKit.Search.SearchQuery)">
  24929. <summary>
  24930. Create a conditional AND operation.
  24931. </summary>
  24932. <remarks>
  24933. A conditional AND operation only evaluates the second operand if the first operand evaluates to true.
  24934. </remarks>
  24935. <returns>A <see cref="T:MailKit.Search.BinarySearchQuery"/> representing the conditional AND operation.</returns>
  24936. <param name="left">The first operand.</param>
  24937. <param name="right">The second operand.</param>
  24938. <exception cref="T:System.ArgumentNullException">
  24939. <para><paramref name="left"/> is <c>null</c>.</para>
  24940. <para>-or-</para>
  24941. <para><paramref name="right"/> is <c>null</c>.</para>
  24942. </exception>
  24943. </member>
  24944. <member name="M:MailKit.Search.SearchQuery.And(MailKit.Search.SearchQuery)">
  24945. <summary>
  24946. Create a conditional AND operation.
  24947. </summary>
  24948. <remarks>
  24949. A conditional AND operation only evaluates the second operand if the first operand evaluates to true.
  24950. </remarks>
  24951. <returns>A <see cref="T:MailKit.Search.BinarySearchQuery"/> representing the conditional AND operation.</returns>
  24952. <param name="expr">An additional query to execute.</param>
  24953. <exception cref="T:System.ArgumentNullException">
  24954. <paramref name="expr"/> is <c>null</c>.
  24955. </exception>
  24956. </member>
  24957. <member name="M:MailKit.Search.SearchQuery.AnnotationsContain(MailKit.AnnotationEntry,MailKit.AnnotationAttribute,System.String)">
  24958. <summary>
  24959. Match messages with the specified annotation.
  24960. </summary>
  24961. <remarks>
  24962. <para>Matches messages with the specified annotation.</para>
  24963. <note type="warning">This feature is not supported by all IMAP servers.</note>
  24964. </remarks>
  24965. <param name="entry">The annotation entry.</param>
  24966. <param name="attribute">The annotation attribute.</param>
  24967. <param name="value">The annotation attribute value.</param>
  24968. <returns>A <see cref="T:MailKit.Search.AnnotationSearchQuery"/>.</returns>
  24969. <exception cref="T:System.ArgumentNullException">
  24970. <para><paramref name="entry"/> is <c>null</c>.</para>
  24971. <para>-or-</para>
  24972. <para><paramref name="attribute"/> is <c>null</c>.</para>
  24973. </exception>
  24974. <exception cref="T:System.ArgumentException">
  24975. <paramref name="attribute"/> is not a valid attribute for searching.
  24976. </exception>
  24977. </member>
  24978. <member name="F:MailKit.Search.SearchQuery.Answered">
  24979. <summary>
  24980. Match messages with the <see cref="F:MailKit.MessageFlags.Answered"/> flag set.
  24981. </summary>
  24982. <remarks>
  24983. Matches messages with the <see cref="F:MailKit.MessageFlags.Answered"/> flag set.
  24984. </remarks>
  24985. </member>
  24986. <member name="M:MailKit.Search.SearchQuery.BccContains(System.String)">
  24987. <summary>
  24988. Match messages where the Bcc header contains the specified text.
  24989. </summary>
  24990. <remarks>
  24991. Matches messages where the Bcc header contains the specified text.
  24992. </remarks>
  24993. <returns>A <see cref="T:MailKit.Search.TextSearchQuery"/>.</returns>
  24994. <param name="text">The text to match against.</param>
  24995. <exception cref="T:System.ArgumentNullException">
  24996. <paramref name="text"/> is <c>null</c>.
  24997. </exception>
  24998. <exception cref="T:System.ArgumentException">
  24999. <paramref name="text"/> is empty.
  25000. </exception>
  25001. </member>
  25002. <member name="M:MailKit.Search.SearchQuery.BodyContains(System.String)">
  25003. <summary>
  25004. Match messages where the message body contains the specified text.
  25005. </summary>
  25006. <remarks>
  25007. Matches messages where the message body contains the specified text.
  25008. </remarks>
  25009. <returns>A <see cref="T:MailKit.Search.TextSearchQuery"/>.</returns>
  25010. <param name="text">The text to match against.</param>
  25011. <exception cref="T:System.ArgumentNullException">
  25012. <paramref name="text"/> is <c>null</c>.
  25013. </exception>
  25014. <exception cref="T:System.ArgumentException">
  25015. <paramref name="text"/> is empty.
  25016. </exception>
  25017. </member>
  25018. <member name="M:MailKit.Search.SearchQuery.CcContains(System.String)">
  25019. <summary>
  25020. Match messages where the Cc header contains the specified text.
  25021. </summary>
  25022. <remarks>
  25023. Matches messages where the Cc header contains the specified text.
  25024. </remarks>
  25025. <returns>A <see cref="T:MailKit.Search.TextSearchQuery"/>.</returns>
  25026. <param name="text">The text to match against.</param>
  25027. <exception cref="T:System.ArgumentNullException">
  25028. <paramref name="text"/> is <c>null</c>.
  25029. </exception>
  25030. <exception cref="T:System.ArgumentException">
  25031. <paramref name="text"/> is empty.
  25032. </exception>
  25033. </member>
  25034. <member name="M:MailKit.Search.SearchQuery.ChangedSince(System.UInt64)">
  25035. <summary>
  25036. Match messages that have mod-sequence values greater than or equal to the specified mod-sequence value.
  25037. </summary>
  25038. <remarks>
  25039. Matches messages that have mod-sequence values greater than or equal to the specified mod-sequence value.
  25040. </remarks>
  25041. <returns>A <see cref="T:MailKit.Search.SearchQuery"/>.</returns>
  25042. <param name="modseq">The mod-sequence value.</param>
  25043. </member>
  25044. <member name="F:MailKit.Search.SearchQuery.Deleted">
  25045. <summary>
  25046. Match messages with the <see cref="F:MailKit.MessageFlags.Deleted"/> flag set.
  25047. </summary>
  25048. <remarks>
  25049. Matches messages with the <see cref="F:MailKit.MessageFlags.Deleted"/> flag set.
  25050. </remarks>
  25051. </member>
  25052. <member name="M:MailKit.Search.SearchQuery.DeliveredAfter(System.DateTime)">
  25053. <summary>
  25054. Match messages that were delivered after the specified date.
  25055. </summary>
  25056. <remarks>
  25057. <para>Matches messages that were delivered after the specified date.</para>
  25058. <para>The resolution of this search query does not include the time.</para>
  25059. </remarks>
  25060. <returns>A <see cref="T:MailKit.Search.DateSearchQuery"/>.</returns>
  25061. <param name="date">The date.</param>
  25062. </member>
  25063. <member name="M:MailKit.Search.SearchQuery.DeliveredBefore(System.DateTime)">
  25064. <summary>
  25065. Match messages that were delivered before the specified date.
  25066. </summary>
  25067. <remarks>
  25068. <para>Matches messages that were delivered before the specified date.</para>
  25069. <para>The resolution of this search query does not include the time.</para>
  25070. </remarks>
  25071. <returns>A <see cref="T:MailKit.Search.DateSearchQuery"/>.</returns>
  25072. <param name="date">The date.</param>
  25073. </member>
  25074. <member name="M:MailKit.Search.SearchQuery.DeliveredOn(System.DateTime)">
  25075. <summary>
  25076. Match messages that were delivered on the specified date.
  25077. </summary>
  25078. <remarks>
  25079. <para>Matches messages that were delivered on the specified date.</para>
  25080. <para>The resolution of this search query does not include the time.</para>
  25081. </remarks>
  25082. <returns>A <see cref="T:MailKit.Search.DateSearchQuery"/>.</returns>
  25083. <param name="date">The date.</param>
  25084. </member>
  25085. <member name="M:MailKit.Search.SearchQuery.DoesNotHaveCustomFlag(System.String)">
  25086. <summary>
  25087. Match messages that do not have the specified custom flag set.
  25088. </summary>
  25089. <remarks>
  25090. Matches messages that do not have the specified custom flag set.
  25091. </remarks>
  25092. <returns>A <see cref="T:MailKit.Search.TextSearchQuery"/>.</returns>
  25093. <param name="flag">The custom flag.</param>
  25094. <exception cref="T:System.ArgumentNullException">
  25095. <paramref name="flag"/> is <c>null</c>.
  25096. </exception>
  25097. <exception cref="T:System.ArgumentException">
  25098. <paramref name="flag"/> is empty.
  25099. </exception>
  25100. </member>
  25101. <member name="M:MailKit.Search.SearchQuery.DoesNotHaveCustomFlags(System.Collections.Generic.IEnumerable{System.String})">
  25102. <summary>
  25103. Match messages that do not have any of the specified custom flags set.
  25104. </summary>
  25105. <remarks>
  25106. Matches messages that do not have any of the specified custom flags set.
  25107. </remarks>
  25108. <returns>A <see cref="T:MailKit.Search.SearchQuery"/>.</returns>
  25109. <param name="flags">The custom flags.</param>
  25110. <exception cref="T:System.ArgumentNullException">
  25111. <paramref name="flags"/> is <c>null</c>.
  25112. </exception>
  25113. <exception cref="T:System.ArgumentException">
  25114. <para>One or more of the <paramref name="flags"/> is <c>null</c> or empty.</para>
  25115. <para>-or-</para>
  25116. <para>No custom flags were given.</para>
  25117. </exception>
  25118. </member>
  25119. <member name="M:MailKit.Search.SearchQuery.DoesNotHaveFlags(MailKit.MessageFlags)">
  25120. <summary>
  25121. Match messages that do not have any of the specified flags set.
  25122. </summary>
  25123. <remarks>
  25124. Matches messages that do not have any of the specified flags set.
  25125. </remarks>
  25126. <returns>A <see cref="T:MailKit.Search.SearchQuery"/>.</returns>
  25127. <param name="flags">The message flags.</param>
  25128. <exception cref="T:System.ArgumentException">
  25129. <paramref name="flags"/> does not specify any valid message flags.
  25130. </exception>
  25131. </member>
  25132. <member name="F:MailKit.Search.SearchQuery.Draft">
  25133. <summary>
  25134. Match messages with the <see cref="F:MailKit.MessageFlags.Draft"/> flag set.
  25135. </summary>
  25136. <remarks>
  25137. Matches messages with the <see cref="F:MailKit.MessageFlags.Draft"/> flag set.
  25138. </remarks>
  25139. </member>
  25140. <member name="M:MailKit.Search.SearchQuery.Filter(System.String)">
  25141. <summary>
  25142. Match messages using a saved search filter.
  25143. </summary>
  25144. <remarks>
  25145. Matches messages using a saved search filter.
  25146. </remarks>
  25147. <returns>A <see cref="T:MailKit.Search.FilterSearchQuery"/>.</returns>
  25148. <param name="name">The name of the saved search.</param>
  25149. </member>
  25150. <member name="M:MailKit.Search.SearchQuery.Filter(MailKit.MetadataTag)">
  25151. <summary>
  25152. Match messages using a saved search filter.
  25153. </summary>
  25154. <remarks>
  25155. Matches messages using a saved search filter.
  25156. </remarks>
  25157. <returns>A <see cref="T:MailKit.Search.FilterSearchQuery"/>.</returns>
  25158. <param name="filter">The name of the saved search.</param>
  25159. </member>
  25160. <member name="F:MailKit.Search.SearchQuery.Flagged">
  25161. <summary>
  25162. Match messages with the <see cref="F:MailKit.MessageFlags.Flagged"/> flag set.
  25163. </summary>
  25164. <remarks>
  25165. Matches messages with the <see cref="F:MailKit.MessageFlags.Flagged"/> flag set.
  25166. </remarks>
  25167. </member>
  25168. <member name="M:MailKit.Search.SearchQuery.FromContains(System.String)">
  25169. <summary>
  25170. Match messages where the From header contains the specified text.
  25171. </summary>
  25172. <remarks>
  25173. Matches messages where the From header contains the specified text.
  25174. </remarks>
  25175. <returns>A <see cref="T:MailKit.Search.TextSearchQuery"/>.</returns>
  25176. <param name="text">The text to match against.</param>
  25177. <exception cref="T:System.ArgumentNullException">
  25178. <paramref name="text"/> is <c>null</c>.
  25179. </exception>
  25180. <exception cref="T:System.ArgumentException">
  25181. <paramref name="text"/> is empty.
  25182. </exception>
  25183. </member>
  25184. <member name="M:MailKit.Search.SearchQuery.Fuzzy(MailKit.Search.SearchQuery)">
  25185. <summary>
  25186. Apply a fuzzy matching algorithm to the specified expression.
  25187. </summary>
  25188. <remarks>
  25189. <para>Applies a fuzzy matching algorithm to the specified expression.</para>
  25190. <note type="warning">This feature is not supported by all IMAP servers.</note>
  25191. </remarks>
  25192. <returns>A <see cref="T:MailKit.Search.UnarySearchQuery"/>.</returns>
  25193. <param name="expr">The expression</param>
  25194. <exception cref="T:System.ArgumentNullException">
  25195. <paramref name="expr"/> is <c>null</c>.
  25196. </exception>
  25197. </member>
  25198. <member name="M:MailKit.Search.SearchQuery.HasCustomFlag(System.String)">
  25199. <summary>
  25200. Match messages that have the specified custom flag set.
  25201. </summary>
  25202. <remarks>
  25203. Matches messages that have the specified custom flag set.
  25204. </remarks>
  25205. <returns>A <see cref="T:MailKit.Search.TextSearchQuery"/>.</returns>
  25206. <param name="flag">The custom flag.</param>
  25207. <exception cref="T:System.ArgumentNullException">
  25208. <paramref name="flag"/> is <c>null</c>.
  25209. </exception>
  25210. <exception cref="T:System.ArgumentException">
  25211. <paramref name="flag"/> is empty.
  25212. </exception>
  25213. </member>
  25214. <member name="M:MailKit.Search.SearchQuery.HasCustomFlags(System.Collections.Generic.IEnumerable{System.String})">
  25215. <summary>
  25216. Match messages that have the specified custom flags set.
  25217. </summary>
  25218. <remarks>
  25219. Matches messages that have the specified custom flags set.
  25220. </remarks>
  25221. <returns>A <see cref="T:MailKit.Search.SearchQuery"/>.</returns>
  25222. <param name="flags">The custom flags.</param>
  25223. <exception cref="T:System.ArgumentNullException">
  25224. <paramref name="flags"/> is <c>null</c>.
  25225. </exception>
  25226. <exception cref="T:System.ArgumentException">
  25227. <para>One or more of the <paramref name="flags"/> is <c>null</c> or empty.</para>
  25228. <para>-or-</para>
  25229. <para>No custom flags were given.</para>
  25230. </exception>
  25231. </member>
  25232. <member name="M:MailKit.Search.SearchQuery.HasFlags(MailKit.MessageFlags)">
  25233. <summary>
  25234. Match messages that have the specified flags set.
  25235. </summary>
  25236. <remarks>
  25237. Matches messages that have the specified flags set.
  25238. </remarks>
  25239. <returns>A <see cref="T:MailKit.Search.SearchQuery"/>.</returns>
  25240. <param name="flags">The message flags.</param>
  25241. <exception cref="T:System.ArgumentException">
  25242. <paramref name="flags"/> does not specify any valid message flags.
  25243. </exception>
  25244. </member>
  25245. <member name="M:MailKit.Search.SearchQuery.NotFlags(MailKit.MessageFlags)">
  25246. <summary>
  25247. Match messages that do not have any of the specified flags set.
  25248. </summary>
  25249. <remarks>
  25250. Matches messages that do not have any of the specified flags set.
  25251. </remarks>
  25252. <returns>A <see cref="T:MailKit.Search.SearchQuery"/>.</returns>
  25253. <param name="flags">The message flags.</param>
  25254. <exception cref="T:System.ArgumentException">
  25255. <paramref name="flags"/> does not specify any valid message flags.
  25256. </exception>
  25257. </member>
  25258. <member name="M:MailKit.Search.SearchQuery.HasKeyword(System.String)">
  25259. <summary>
  25260. Match messages that have the specified keyword set.
  25261. </summary>
  25262. <remarks>
  25263. <para>Matches messages that have the specified keyword set.</para>
  25264. <note type="info">A keyword is a user-defined message flag.</note>
  25265. </remarks>
  25266. <returns>A <see cref="T:MailKit.Search.TextSearchQuery"/>.</returns>
  25267. <param name="keyword">The keyword.</param>
  25268. <exception cref="T:System.ArgumentNullException">
  25269. <paramref name="keyword"/> is <c>null</c>.
  25270. </exception>
  25271. <exception cref="T:System.ArgumentException">
  25272. <paramref name="keyword"/> is empty.
  25273. </exception>
  25274. </member>
  25275. <member name="M:MailKit.Search.SearchQuery.HasKeywords(System.Collections.Generic.IEnumerable{System.String})">
  25276. <summary>
  25277. Match messages that have all of the specified keywords set.
  25278. </summary>
  25279. <remarks>
  25280. <para>Matches messages that have all of the specified keywords set.</para>
  25281. <note type="info">A keyword is a user-defined message flag.</note>
  25282. </remarks>
  25283. <returns>A <see cref="T:MailKit.Search.SearchQuery"/>.</returns>
  25284. <param name="keywords">The keywords.</param>
  25285. <exception cref="T:System.ArgumentNullException">
  25286. <paramref name="keywords"/> is <c>null</c>.
  25287. </exception>
  25288. <exception cref="T:System.ArgumentException">
  25289. <para>One or more of the <paramref name="keywords"/> is <c>null</c> or empty.</para>
  25290. <para>-or-</para>
  25291. <para>No keywords were given.</para>
  25292. </exception>
  25293. </member>
  25294. <member name="M:MailKit.Search.SearchQuery.NotKeyword(System.String)">
  25295. <summary>
  25296. Match messages that do not have the specified keyword set.
  25297. </summary>
  25298. <remarks>
  25299. <para>Matches messages that do not have the specified keyword set.</para>
  25300. <note type="info">A keyword is a user-defined message flag.</note>
  25301. </remarks>
  25302. <returns>A <see cref="T:MailKit.Search.TextSearchQuery"/>.</returns>
  25303. <param name="keyword">The keyword.</param>
  25304. <exception cref="T:System.ArgumentNullException">
  25305. <paramref name="keyword"/> is <c>null</c>.
  25306. </exception>
  25307. <exception cref="T:System.ArgumentException">
  25308. <paramref name="keyword"/> is empty.
  25309. </exception>
  25310. </member>
  25311. <member name="M:MailKit.Search.SearchQuery.NotKeywords(System.Collections.Generic.IEnumerable{System.String})">
  25312. <summary>
  25313. Match messages that do not have any of the specified keywords set.
  25314. </summary>
  25315. <remarks>
  25316. <para>Matches messages that do not have any of the specified keywords set.</para>
  25317. <note type="info">A keyword is a user-defined message flag.</note>
  25318. </remarks>
  25319. <returns>A <see cref="T:MailKit.Search.SearchQuery"/>.</returns>
  25320. <param name="keywords">The keywords.</param>
  25321. <exception cref="T:System.ArgumentNullException">
  25322. <paramref name="keywords"/> is <c>null</c>.
  25323. </exception>
  25324. <exception cref="T:System.ArgumentException">
  25325. <para>One or more of the <paramref name="keywords"/> is <c>null</c> or empty.</para>
  25326. <para>-or-</para>
  25327. <para>No keywords were given.</para>
  25328. </exception>
  25329. </member>
  25330. <member name="M:MailKit.Search.SearchQuery.HeaderContains(System.String,System.String)">
  25331. <summary>
  25332. Match messages where the specified header contains the specified text.
  25333. </summary>
  25334. <remarks>
  25335. Matches messages where the specified header contains the specified text.
  25336. </remarks>
  25337. <returns>A <see cref="T:MailKit.Search.HeaderSearchQuery"/>.</returns>
  25338. <param name="field">The header field to match against.</param>
  25339. <param name="text">The text to match against.</param>
  25340. <exception cref="T:System.ArgumentNullException">
  25341. <para><paramref name="field"/> is <c>null</c>.</para>
  25342. <para>-or-</para>
  25343. <para><paramref name="text"/> is <c>null</c>.</para>
  25344. </exception>
  25345. <exception cref="T:System.ArgumentException">
  25346. <paramref name="field"/> is empty.
  25347. </exception>
  25348. </member>
  25349. <member name="M:MailKit.Search.SearchQuery.LargerThan(System.Int32)">
  25350. <summary>
  25351. Match messages that are larger than the specified number of octets.
  25352. </summary>
  25353. <remarks>
  25354. Matches messages that are larger than the specified number of octets.
  25355. </remarks>
  25356. <returns>A <see cref="T:MailKit.Search.NumericSearchQuery"/>.</returns>
  25357. <param name="octets">The number of octets.</param>
  25358. <exception cref="T:System.ArgumentOutOfRangeException">
  25359. <paramref name="octets"/> is a negative value.
  25360. </exception>
  25361. </member>
  25362. <member name="M:MailKit.Search.SearchQuery.MessageContains(System.String)">
  25363. <summary>
  25364. Match messages where the raw message contains the specified text.
  25365. </summary>
  25366. <remarks>
  25367. Matches messages where the raw message contains the specified text.
  25368. </remarks>
  25369. <returns>A <see cref="T:MailKit.Search.TextSearchQuery"/>.</returns>
  25370. <param name="text">The text to match against.</param>
  25371. <exception cref="T:System.ArgumentNullException">
  25372. <paramref name="text"/> is <c>null</c>.
  25373. </exception>
  25374. <exception cref="T:System.ArgumentException">
  25375. <paramref name="text"/> is empty.
  25376. </exception>
  25377. </member>
  25378. <member name="F:MailKit.Search.SearchQuery.New">
  25379. <summary>
  25380. Match messages with the <see cref="F:MailKit.MessageFlags.Recent"/> flag set but not the <see cref="F:MailKit.MessageFlags.Seen"/>.
  25381. </summary>
  25382. <remarks>
  25383. Matches messages with the <see cref="F:MailKit.MessageFlags.Recent"/> flag set but not the <see cref="F:MailKit.MessageFlags.Seen"/>.
  25384. </remarks>
  25385. </member>
  25386. <member name="M:MailKit.Search.SearchQuery.Not(MailKit.Search.SearchQuery)">
  25387. <summary>
  25388. Create a logical negation of the specified expression.
  25389. </summary>
  25390. <remarks>
  25391. Creates a logical negation of the specified expression.
  25392. </remarks>
  25393. <returns>A <see cref="T:MailKit.Search.UnarySearchQuery"/>.</returns>
  25394. <param name="expr">The expression</param>
  25395. <exception cref="T:System.ArgumentNullException">
  25396. <paramref name="expr"/> is <c>null</c>.
  25397. </exception>
  25398. </member>
  25399. <member name="F:MailKit.Search.SearchQuery.NotAnswered">
  25400. <summary>
  25401. Match messages that do not have the <see cref="F:MailKit.MessageFlags.Answered"/> flag set.
  25402. </summary>
  25403. <remarks>
  25404. Matches messages that do not have the <see cref="F:MailKit.MessageFlags.Answered"/> flag set.
  25405. </remarks>
  25406. </member>
  25407. <member name="F:MailKit.Search.SearchQuery.NotDeleted">
  25408. <summary>
  25409. Match messages that do not have the <see cref="F:MailKit.MessageFlags.Deleted"/> flag set.
  25410. </summary>
  25411. <remarks>
  25412. Matches messages that do not have the <see cref="F:MailKit.MessageFlags.Deleted"/> flag set.
  25413. </remarks>
  25414. </member>
  25415. <member name="F:MailKit.Search.SearchQuery.NotDraft">
  25416. <summary>
  25417. Match messages that do not have the <see cref="F:MailKit.MessageFlags.Draft"/> flag set.
  25418. </summary>
  25419. <remarks>
  25420. Matches messages that do not have the <see cref="F:MailKit.MessageFlags.Draft"/> flag set.
  25421. </remarks>
  25422. </member>
  25423. <member name="F:MailKit.Search.SearchQuery.NotFlagged">
  25424. <summary>
  25425. Match messages that do not have the <see cref="F:MailKit.MessageFlags.Flagged"/> flag set.
  25426. </summary>
  25427. <remarks>
  25428. Matches messages that do not have the <see cref="F:MailKit.MessageFlags.Flagged"/> flag set.
  25429. </remarks>
  25430. </member>
  25431. <member name="F:MailKit.Search.SearchQuery.NotRecent">
  25432. <summary>
  25433. Match messages that do not have the <see cref="F:MailKit.MessageFlags.Recent"/> flag set.
  25434. </summary>
  25435. <remarks>
  25436. Matches messages that do not have the <see cref="F:MailKit.MessageFlags.Recent"/> flag set.
  25437. </remarks>
  25438. </member>
  25439. <member name="F:MailKit.Search.SearchQuery.NotSeen">
  25440. <summary>
  25441. Match messages that do not have the <see cref="F:MailKit.MessageFlags.Seen"/> flag set.
  25442. </summary>
  25443. <remarks>
  25444. Matches messages that do not have the <see cref="F:MailKit.MessageFlags.Seen"/> flag set.
  25445. </remarks>
  25446. </member>
  25447. <member name="F:MailKit.Search.SearchQuery.Old">
  25448. <summary>
  25449. Match messages that do not have the <see cref="F:MailKit.MessageFlags.Recent"/> flag set.
  25450. </summary>
  25451. <remarks>
  25452. Matches messages that do not have the <see cref="F:MailKit.MessageFlags.Recent"/> flag set.
  25453. </remarks>
  25454. </member>
  25455. <member name="M:MailKit.Search.SearchQuery.OlderThan(System.Int32)">
  25456. <summary>
  25457. Match messages older than the specified number of seconds.
  25458. </summary>
  25459. <remarks>
  25460. Matches messages older than the specified number of seconds.
  25461. </remarks>
  25462. <returns>A <see cref="T:MailKit.Search.NumericSearchQuery"/>.</returns>
  25463. <param name="seconds">The number of seconds.</param>
  25464. <exception cref="T:System.ArgumentOutOfRangeException">
  25465. The number of seconds cannot be less than <c>1</c>.
  25466. </exception>
  25467. </member>
  25468. <member name="M:MailKit.Search.SearchQuery.Or(MailKit.Search.SearchQuery,MailKit.Search.SearchQuery)">
  25469. <summary>
  25470. Create a conditional OR operation.
  25471. </summary>
  25472. <remarks>
  25473. A conditional OR operation only evaluates the second operand if the first operand evaluates to false.
  25474. </remarks>
  25475. <returns>A <see cref="T:MailKit.Search.BinarySearchQuery"/> representing the conditional OR operation.</returns>
  25476. <param name="left">The first operand.</param>
  25477. <param name="right">The second operand.</param>
  25478. <exception cref="T:System.ArgumentNullException">
  25479. <para><paramref name="left"/> is <c>null</c>.</para>
  25480. <para>-or-</para>
  25481. <para><paramref name="right"/> is <c>null</c>.</para>
  25482. </exception>
  25483. </member>
  25484. <member name="M:MailKit.Search.SearchQuery.Or(MailKit.Search.SearchQuery)">
  25485. <summary>
  25486. Create a conditional OR operation.
  25487. </summary>
  25488. <remarks>
  25489. A conditional OR operation only evaluates the second operand if the first operand evaluates to true.
  25490. </remarks>
  25491. <returns>A <see cref="T:MailKit.Search.BinarySearchQuery"/> representing the conditional AND operation.</returns>
  25492. <param name="expr">An additional query to execute.</param>
  25493. <exception cref="T:System.ArgumentNullException">
  25494. <paramref name="expr"/> is <c>null</c>.
  25495. </exception>
  25496. </member>
  25497. <member name="F:MailKit.Search.SearchQuery.Recent">
  25498. <summary>
  25499. Match messages with the <see cref="F:MailKit.MessageFlags.Recent"/> flag set.
  25500. </summary>
  25501. <remarks>
  25502. Matches messages with the <see cref="F:MailKit.MessageFlags.Recent"/> flag set.
  25503. </remarks>
  25504. </member>
  25505. <member name="F:MailKit.Search.SearchQuery.Seen">
  25506. <summary>
  25507. Match messages with the <see cref="F:MailKit.MessageFlags.Seen"/> flag set.
  25508. </summary>
  25509. <remarks>
  25510. Matches messages with the <see cref="F:MailKit.MessageFlags.Seen"/> flag set.
  25511. </remarks>
  25512. </member>
  25513. <member name="M:MailKit.Search.SearchQuery.SentAfter(System.DateTime)">
  25514. <summary>
  25515. Match messages that were sent on or after the specified date.
  25516. </summary>
  25517. <remarks>
  25518. <para>Matches messages that were sent on or after the specified date.</para>
  25519. <para>The resolution of this search query does not include the time.</para>
  25520. </remarks>
  25521. <returns>A <see cref="T:MailKit.Search.DateSearchQuery"/>.</returns>
  25522. <param name="date">The date.</param>
  25523. </member>
  25524. <member name="M:MailKit.Search.SearchQuery.SentBefore(System.DateTime)">
  25525. <summary>
  25526. Match messages that were sent before the specified date.
  25527. </summary>
  25528. <remarks>
  25529. <para>Matches messages that were sent before the specified date.</para>
  25530. <note type="note">The resolution of this search query does not include the time.</note>
  25531. </remarks>
  25532. <returns>A <see cref="T:MailKit.Search.DateSearchQuery"/>.</returns>
  25533. <param name="date">The date.</param>
  25534. </member>
  25535. <member name="M:MailKit.Search.SearchQuery.SentOn(System.DateTime)">
  25536. <summary>
  25537. Match messages that were sent on the specified date.
  25538. </summary>
  25539. <remarks>
  25540. <para>Matches messages that were sent on the specified date.</para>
  25541. <note type="note">The resolution of this search query does not include the time.</note>
  25542. </remarks>
  25543. <returns>A <see cref="T:MailKit.Search.DateSearchQuery"/>.</returns>
  25544. <param name="date">The date.</param>
  25545. </member>
  25546. <member name="M:MailKit.Search.SearchQuery.SentSince(System.DateTime)">
  25547. <summary>
  25548. Match messages that were sent since the specified date.
  25549. </summary>
  25550. <remarks>
  25551. <para>Matches messages that were sent since the specified date.</para>
  25552. <note type="note">The resolution of this search query does not include the time.</note>
  25553. </remarks>
  25554. <returns>A <see cref="T:MailKit.Search.DateSearchQuery"/>.</returns>
  25555. <param name="date">The date.</param>
  25556. </member>
  25557. <member name="M:MailKit.Search.SearchQuery.SmallerThan(System.Int32)">
  25558. <summary>
  25559. Match messages that are smaller than the specified number of octets.
  25560. </summary>
  25561. <remarks>
  25562. Matches messages that are smaller than the specified number of octets.
  25563. </remarks>
  25564. <returns>A <see cref="T:MailKit.Search.NumericSearchQuery"/>.</returns>
  25565. <param name="octets">The number of octets.</param>
  25566. <exception cref="T:System.ArgumentOutOfRangeException">
  25567. <paramref name="octets"/> is a negative value.
  25568. </exception>
  25569. </member>
  25570. <member name="M:MailKit.Search.SearchQuery.SubjectContains(System.String)">
  25571. <summary>
  25572. Match messages where the Subject header contains the specified text.
  25573. </summary>
  25574. <remarks>
  25575. Matches messages where the Subject header contains the specified text.
  25576. </remarks>
  25577. <returns>A <see cref="T:MailKit.Search.TextSearchQuery"/>.</returns>
  25578. <param name="text">The text to match against.</param>
  25579. <exception cref="T:System.ArgumentNullException">
  25580. <paramref name="text"/> is <c>null</c>.
  25581. </exception>
  25582. <exception cref="T:System.ArgumentException">
  25583. <paramref name="text"/> is empty.
  25584. </exception>
  25585. </member>
  25586. <member name="M:MailKit.Search.SearchQuery.ToContains(System.String)">
  25587. <summary>
  25588. Match messages where the To header contains the specified text.
  25589. </summary>
  25590. <remarks>
  25591. Matches messages where the To header contains the specified text.
  25592. </remarks>
  25593. <returns>A <see cref="T:MailKit.Search.TextSearchQuery"/>.</returns>
  25594. <param name="text">The text to match against.</param>
  25595. <exception cref="T:System.ArgumentNullException">
  25596. <paramref name="text"/> is <c>null</c>.
  25597. </exception>
  25598. <exception cref="T:System.ArgumentException">
  25599. <paramref name="text"/> is empty.
  25600. </exception>
  25601. </member>
  25602. <member name="M:MailKit.Search.SearchQuery.Uids(System.Collections.Generic.IList{MailKit.UniqueId})">
  25603. <summary>
  25604. Limit the search query to messages with the specified unique identifiers.
  25605. </summary>
  25606. <remarks>
  25607. Limits the search query to messages with the specified unique identifiers.
  25608. </remarks>
  25609. <returns>A <see cref="T:MailKit.Search.UidSearchQuery"/>.</returns>
  25610. <param name="uids">The unique identifiers.</param>
  25611. <exception cref="T:System.ArgumentNullException">
  25612. <paramref name="uids"/> is <c>null</c>.
  25613. </exception>
  25614. <exception cref="T:System.ArgumentException">
  25615. <paramref name="uids"/> is empty.
  25616. </exception>
  25617. </member>
  25618. <member name="M:MailKit.Search.SearchQuery.YoungerThan(System.Int32)">
  25619. <summary>
  25620. Match messages younger than the specified number of seconds.
  25621. </summary>
  25622. <remarks>
  25623. Matches messages younger than the specified number of seconds.
  25624. </remarks>
  25625. <returns>A <see cref="T:MailKit.Search.NumericSearchQuery"/>.</returns>
  25626. <param name="seconds">The number of seconds.</param>
  25627. <exception cref="T:System.ArgumentOutOfRangeException">
  25628. The number of seconds cannot be less than <c>1</c>.
  25629. </exception>
  25630. </member>
  25631. <member name="M:MailKit.Search.SearchQuery.GMailMessageId(System.UInt64)">
  25632. <summary>
  25633. Match messages that have the specified GMail message identifier.
  25634. </summary>
  25635. <remarks>
  25636. This search term can only be used with GMail.
  25637. </remarks>
  25638. <returns>A <see cref="T:MailKit.Search.NumericSearchQuery"/>.</returns>
  25639. <param name="id">The GMail message identifier.</param>
  25640. </member>
  25641. <member name="M:MailKit.Search.SearchQuery.GMailThreadId(System.UInt64)">
  25642. <summary>
  25643. Match messages belonging to the specified GMail thread.
  25644. </summary>
  25645. <remarks>
  25646. This search term can only be used with GMail.
  25647. </remarks>
  25648. <returns>A <see cref="T:MailKit.Search.NumericSearchQuery"/>.</returns>
  25649. <param name="thread">The GMail thread.</param>
  25650. </member>
  25651. <member name="M:MailKit.Search.SearchQuery.HasGMailLabel(System.String)">
  25652. <summary>
  25653. Match messages that have the specified GMail label.
  25654. </summary>
  25655. <remarks>
  25656. This search term can only be used with GMail.
  25657. </remarks>
  25658. <returns>A <see cref="T:MailKit.Search.TextSearchQuery"/>.</returns>
  25659. <param name="label">The GMail label.</param>
  25660. <exception cref="T:System.ArgumentNullException">
  25661. <paramref name="label"/> is <c>null</c>.
  25662. </exception>
  25663. <exception cref="T:System.ArgumentException">
  25664. <paramref name="label"/> is empty.
  25665. </exception>
  25666. </member>
  25667. <member name="M:MailKit.Search.SearchQuery.GMailRawSearch(System.String)">
  25668. <summary>
  25669. Match messages using the GMail search expression.
  25670. </summary>
  25671. <remarks>
  25672. This search term can only be used with GMail.
  25673. </remarks>
  25674. <returns>A <see cref="T:MailKit.Search.TextSearchQuery"/>.</returns>
  25675. <param name="expression">The raw GMail search text.</param>
  25676. <exception cref="T:System.ArgumentNullException">
  25677. <paramref name="expression"/> is <c>null</c>.
  25678. </exception>
  25679. <exception cref="T:System.ArgumentException">
  25680. <paramref name="expression"/> is empty.
  25681. </exception>
  25682. </member>
  25683. <member name="T:MailKit.Search.SearchResults">
  25684. <summary>
  25685. The results of a search.
  25686. </summary>
  25687. <remarks>
  25688. The results of a search.
  25689. </remarks>
  25690. </member>
  25691. <member name="M:MailKit.Search.SearchResults.#ctor(MailKit.Search.SortOrder)">
  25692. <summary>
  25693. Initializes a new instance of the <see cref="T:MailKit.Search.SearchResults"/> class.
  25694. </summary>
  25695. <remarks>
  25696. Creates a new <see cref="T:MailKit.Search.SearchResults"/>.
  25697. </remarks>
  25698. <param name="order">The sort-order to use for the unique identifiers.</param>
  25699. </member>
  25700. <member name="P:MailKit.Search.SearchResults.UniqueIds">
  25701. <summary>
  25702. Get or set the unique identifiers of the messages that matched the search query.
  25703. </summary>
  25704. <remarks>
  25705. Gets or sets the unique identifiers of the messages that matched the search query.
  25706. </remarks>
  25707. <value>The unique identifiers.</value>
  25708. </member>
  25709. <member name="P:MailKit.Search.SearchResults.Count">
  25710. <summary>
  25711. Get or set the number of messages that matched the search query.
  25712. </summary>
  25713. <remarks>
  25714. Gets or sets the number of messages that matched the search query.
  25715. </remarks>
  25716. <value>The count.</value>
  25717. </member>
  25718. <member name="P:MailKit.Search.SearchResults.Min">
  25719. <summary>
  25720. Get or set the minimum unique identifier that matched the search query.
  25721. </summary>
  25722. <remarks>
  25723. Gets or sets the minimum unique identifier that matched the search query.
  25724. </remarks>
  25725. <value>The minimum unique identifier.</value>
  25726. </member>
  25727. <member name="P:MailKit.Search.SearchResults.Max">
  25728. <summary>
  25729. Get or set the maximum unique identifier that matched the search query.
  25730. </summary>
  25731. <remarks>
  25732. Gets or sets the maximum unique identifier that matched the search query.
  25733. </remarks>
  25734. <value>The maximum unique identifier.</value>
  25735. </member>
  25736. <member name="P:MailKit.Search.SearchResults.ModSeq">
  25737. <summary>
  25738. Gets or sets the mod-sequence identifier of the messages that matched the search query.
  25739. </summary>
  25740. <remarks>
  25741. Gets or sets the mod-sequence identifier of the messages that matched the search query.
  25742. </remarks>
  25743. <value>The mod-sequence identifier.</value>
  25744. </member>
  25745. <member name="P:MailKit.Search.SearchResults.Relevancy">
  25746. <summary>
  25747. Gets or sets the relevancy scores of the messages that matched the search query.
  25748. </summary>
  25749. <remarks>
  25750. Gets or sets the relevancy scores of the messages that matched the search query.
  25751. </remarks>
  25752. <value>The relevancy scores.</value>
  25753. </member>
  25754. <member name="T:MailKit.Search.SearchTerm">
  25755. <summary>
  25756. A search term.
  25757. </summary>
  25758. <remarks>
  25759. The search term as used by <see cref="T:MailKit.Search.SearchQuery"/>.
  25760. </remarks>
  25761. </member>
  25762. <member name="F:MailKit.Search.SearchTerm.All">
  25763. <summary>
  25764. A search term that matches all messages.
  25765. </summary>
  25766. </member>
  25767. <member name="F:MailKit.Search.SearchTerm.And">
  25768. <summary>
  25769. A search term that logically combines 2 or more other
  25770. search expressions such that messages must match both
  25771. expressions.
  25772. </summary>
  25773. </member>
  25774. <member name="F:MailKit.Search.SearchTerm.Annotation">
  25775. <summary>
  25776. A search term that matches messages that have the specified annotation.
  25777. </summary>
  25778. </member>
  25779. <member name="F:MailKit.Search.SearchTerm.Answered">
  25780. <summary>
  25781. A search term that matches answered messages.
  25782. </summary>
  25783. </member>
  25784. <member name="F:MailKit.Search.SearchTerm.BccContains">
  25785. <summary>
  25786. A search term that matches messages that contain a specified
  25787. string within the <c>Bcc</c> header.
  25788. </summary>
  25789. </member>
  25790. <member name="F:MailKit.Search.SearchTerm.BodyContains">
  25791. <summary>
  25792. A search term that matches messages that contain a specified
  25793. string within the body of the message.
  25794. </summary>
  25795. </member>
  25796. <member name="F:MailKit.Search.SearchTerm.CcContains">
  25797. <summary>
  25798. A search term that matches messages that contain a specified
  25799. string within the <c>Cc</c> header.
  25800. </summary>
  25801. </member>
  25802. <member name="F:MailKit.Search.SearchTerm.Deleted">
  25803. <summary>
  25804. A search term that matches deleted messages.
  25805. </summary>
  25806. </member>
  25807. <member name="F:MailKit.Search.SearchTerm.DeliveredAfter">
  25808. <summary>
  25809. A search term that matches messages delivered after a specified date.
  25810. </summary>
  25811. </member>
  25812. <member name="F:MailKit.Search.SearchTerm.DeliveredBefore">
  25813. <summary>
  25814. A search term that matches messages delivered before a specified date.
  25815. </summary>
  25816. </member>
  25817. <member name="F:MailKit.Search.SearchTerm.DeliveredOn">
  25818. <summary>
  25819. A search term that matches messages delivered on a specified date.
  25820. </summary>
  25821. </member>
  25822. <member name="F:MailKit.Search.SearchTerm.Draft">
  25823. <summary>
  25824. A search term that matches draft messages.
  25825. </summary>
  25826. </member>
  25827. <member name="F:MailKit.Search.SearchTerm.Filter">
  25828. <summary>
  25829. A search term that makes use of a predefined filter.
  25830. </summary>
  25831. </member>
  25832. <member name="F:MailKit.Search.SearchTerm.Flagged">
  25833. <summary>
  25834. A search term that matches flagged messages.
  25835. </summary>
  25836. </member>
  25837. <member name="F:MailKit.Search.SearchTerm.FromContains">
  25838. <summary>
  25839. A search term that matches messages that contain a specified
  25840. string within the <c>From</c> header.
  25841. </summary>
  25842. </member>
  25843. <member name="F:MailKit.Search.SearchTerm.Fuzzy">
  25844. <summary>
  25845. A search term that modifies another search expression to allow
  25846. fuzzy matching.
  25847. </summary>
  25848. </member>
  25849. <member name="F:MailKit.Search.SearchTerm.HeaderContains">
  25850. <summary>
  25851. A search term that matches messages that contain a specified
  25852. string within a particular header.
  25853. </summary>
  25854. </member>
  25855. <member name="F:MailKit.Search.SearchTerm.Keyword">
  25856. <summary>
  25857. A search term that matches messages that contain a specified
  25858. keyword.
  25859. </summary>
  25860. </member>
  25861. <member name="F:MailKit.Search.SearchTerm.LargerThan">
  25862. <summary>
  25863. A search term that matches messages that are larger than a
  25864. specified number of bytes.
  25865. </summary>
  25866. </member>
  25867. <member name="F:MailKit.Search.SearchTerm.MessageContains">
  25868. <summary>
  25869. A search term that matches messages that contain a specified
  25870. string anywhere within the message.
  25871. </summary>
  25872. </member>
  25873. <member name="F:MailKit.Search.SearchTerm.ModSeq">
  25874. <summary>
  25875. A search term that matches messages that have the specified
  25876. modification sequence value.
  25877. </summary>
  25878. </member>
  25879. <member name="F:MailKit.Search.SearchTerm.New">
  25880. <summary>
  25881. A search term that matches new messages.
  25882. </summary>
  25883. </member>
  25884. <member name="F:MailKit.Search.SearchTerm.Not">
  25885. <summary>
  25886. A search term that modifies another search expression such that
  25887. messages must match the logical inverse of the expression.
  25888. </summary>
  25889. </member>
  25890. <member name="F:MailKit.Search.SearchTerm.NotAnswered">
  25891. <summary>
  25892. A search term that matches messages that have not been answered.
  25893. </summary>
  25894. </member>
  25895. <member name="F:MailKit.Search.SearchTerm.NotDeleted">
  25896. <summary>
  25897. A search term that matches messages that have not been deleted.
  25898. </summary>
  25899. </member>
  25900. <member name="F:MailKit.Search.SearchTerm.NotDraft">
  25901. <summary>
  25902. A search term that matches messages that are not drafts.
  25903. </summary>
  25904. </member>
  25905. <member name="F:MailKit.Search.SearchTerm.NotFlagged">
  25906. <summary>
  25907. A search term that matches messages that have not been flagged.
  25908. </summary>
  25909. </member>
  25910. <member name="F:MailKit.Search.SearchTerm.NotKeyword">
  25911. <summary>
  25912. A search term that matches messages that do not contain a specified
  25913. keyword.
  25914. </summary>
  25915. </member>
  25916. <member name="F:MailKit.Search.SearchTerm.NotRecent">
  25917. <summary>
  25918. A search term that matches messages that are not recent.
  25919. </summary>
  25920. </member>
  25921. <member name="F:MailKit.Search.SearchTerm.NotSeen">
  25922. <summary>
  25923. A search term that matches messages that have not been seen.
  25924. </summary>
  25925. </member>
  25926. <member name="F:MailKit.Search.SearchTerm.Older">
  25927. <summary>
  25928. A search term that matches messages that are older than a specified date.
  25929. </summary>
  25930. </member>
  25931. <member name="F:MailKit.Search.SearchTerm.Or">
  25932. <summary>
  25933. A search term that logically combines 2 or more other
  25934. search expressions such that messages only need to match
  25935. one of the expressions.
  25936. </summary>
  25937. </member>
  25938. <member name="F:MailKit.Search.SearchTerm.Recent">
  25939. <summary>
  25940. A search term that matches messages that are recent.
  25941. </summary>
  25942. </member>
  25943. <member name="F:MailKit.Search.SearchTerm.Seen">
  25944. <summary>
  25945. A search term that matches messages that have been seen.
  25946. </summary>
  25947. </member>
  25948. <member name="F:MailKit.Search.SearchTerm.SentBefore">
  25949. <summary>
  25950. A search term that matches messages that were sent before a specified date.
  25951. </summary>
  25952. </member>
  25953. <member name="F:MailKit.Search.SearchTerm.SentOn">
  25954. <summary>
  25955. A search term that matches messages that were sent on a specified date.
  25956. </summary>
  25957. </member>
  25958. <member name="F:MailKit.Search.SearchTerm.SentSince">
  25959. <summary>
  25960. A search term that matches messages that were sent since a specified date.
  25961. </summary>
  25962. </member>
  25963. <member name="F:MailKit.Search.SearchTerm.SmallerThan">
  25964. <summary>
  25965. A search term that matches messages that are smaller than a
  25966. specified number of bytes.
  25967. </summary>
  25968. </member>
  25969. <member name="F:MailKit.Search.SearchTerm.SubjectContains">
  25970. <summary>
  25971. A search term that matches messages that contain a specified
  25972. string within the <c>Subject</c> header.
  25973. </summary>
  25974. </member>
  25975. <member name="F:MailKit.Search.SearchTerm.ToContains">
  25976. <summary>
  25977. A search term that matches messages that contain a specified
  25978. string within the <c>To</c> header.
  25979. </summary>
  25980. </member>
  25981. <member name="F:MailKit.Search.SearchTerm.Uid">
  25982. <summary>
  25983. A search term that matches messages included within a specified
  25984. set of unique identifiers.
  25985. </summary>
  25986. </member>
  25987. <member name="F:MailKit.Search.SearchTerm.Younger">
  25988. <summary>
  25989. A search term that matches messages that are younger than a specified date.
  25990. </summary>
  25991. </member>
  25992. <member name="F:MailKit.Search.SearchTerm.GMailMessageId">
  25993. <summary>
  25994. A search term that matches messages with a specified GMail message identifier.
  25995. </summary>
  25996. </member>
  25997. <member name="F:MailKit.Search.SearchTerm.GMailThreadId">
  25998. <summary>
  25999. A search term that matches messages with a specified GMail thread (conversation)
  26000. identifier.
  26001. </summary>
  26002. </member>
  26003. <member name="F:MailKit.Search.SearchTerm.GMailLabels">
  26004. <summary>
  26005. A search term that matches messages with the specified GMail labels.
  26006. </summary>
  26007. </member>
  26008. <member name="F:MailKit.Search.SearchTerm.GMailRaw">
  26009. <summary>
  26010. A search term that uses the GMail search syntax.
  26011. </summary>
  26012. </member>
  26013. <member name="T:MailKit.Search.SortOrder">
  26014. <summary>
  26015. An enumeration of sort orders.
  26016. </summary>
  26017. <remarks>
  26018. An enumeration of sort orders.
  26019. </remarks>
  26020. </member>
  26021. <member name="F:MailKit.Search.SortOrder.None">
  26022. <summary>
  26023. No sorting order.
  26024. </summary>
  26025. </member>
  26026. <member name="F:MailKit.Search.SortOrder.Ascending">
  26027. <summary>
  26028. Sort in ascending order.
  26029. </summary>
  26030. </member>
  26031. <member name="F:MailKit.Search.SortOrder.Descending">
  26032. <summary>
  26033. Sort in descending order.
  26034. </summary>
  26035. </member>
  26036. <member name="T:MailKit.Search.TextSearchQuery">
  26037. <summary>
  26038. A text-based search query.
  26039. </summary>
  26040. <remarks>
  26041. A text-based search query.
  26042. </remarks>
  26043. </member>
  26044. <member name="M:MailKit.Search.TextSearchQuery.#ctor(MailKit.Search.SearchTerm,System.String)">
  26045. <summary>
  26046. Initializes a new instance of the <see cref="T:MailKit.Search.TextSearchQuery"/> class.
  26047. </summary>
  26048. <remarks>
  26049. Creates a new text-based search query.
  26050. </remarks>
  26051. <param name="term">The search term.</param>
  26052. <param name="text">The text to match against.</param>
  26053. <exception cref="T:System.ArgumentNullException">
  26054. <paramref name="text"/> is <c>null</c>.
  26055. </exception>
  26056. <exception cref="T:System.ArgumentException">
  26057. <paramref name="text"/> is empty.
  26058. </exception>
  26059. </member>
  26060. <member name="P:MailKit.Search.TextSearchQuery.Text">
  26061. <summary>
  26062. Gets the text to match against.
  26063. </summary>
  26064. <remarks>
  26065. Gets the text to match against.
  26066. </remarks>
  26067. <value>The text.</value>
  26068. </member>
  26069. <member name="T:MailKit.Search.UidSearchQuery">
  26070. <summary>
  26071. A unique identifier-based search query.
  26072. </summary>
  26073. <remarks>
  26074. A unique identifier-based search query.
  26075. </remarks>
  26076. </member>
  26077. <member name="M:MailKit.Search.UidSearchQuery.#ctor(System.Collections.Generic.IList{MailKit.UniqueId})">
  26078. <summary>
  26079. Initializes a new instance of the <see cref="T:MailKit.Search.UidSearchQuery"/> class.
  26080. </summary>
  26081. <remarks>
  26082. Creates a new unique identifier-based search query.
  26083. </remarks>
  26084. <param name="uids">The unique identifiers to match against.</param>
  26085. <exception cref="T:System.ArgumentNullException">
  26086. <paramref name="uids"/> is <c>null</c>.
  26087. </exception>
  26088. <exception cref="T:System.ArgumentException">
  26089. <paramref name="uids"/> is empty.
  26090. </exception>
  26091. </member>
  26092. <member name="M:MailKit.Search.UidSearchQuery.#ctor(MailKit.UniqueId)">
  26093. <summary>
  26094. Initializes a new instance of the <see cref="T:MailKit.Search.UidSearchQuery"/> class.
  26095. </summary>
  26096. <remarks>
  26097. Creates a new unique identifier-based search query.
  26098. </remarks>
  26099. <param name="uid">The unique identifier to match against.</param>
  26100. <exception cref="T:System.ArgumentException">
  26101. <paramref name="uid"/> is an invalid unique identifier.
  26102. </exception>
  26103. </member>
  26104. <member name="P:MailKit.Search.UidSearchQuery.Uids">
  26105. <summary>
  26106. Gets the unique identifiers to match against.
  26107. </summary>
  26108. <remarks>
  26109. Gets the unique identifiers to match against.
  26110. </remarks>
  26111. <value>The unique identifiers.</value>
  26112. </member>
  26113. <member name="T:MailKit.Search.UnarySearchQuery">
  26114. <summary>
  26115. A unary search query such as a NOT expression.
  26116. </summary>
  26117. <remarks>
  26118. A unary search query such as a NOT expression.
  26119. </remarks>
  26120. </member>
  26121. <member name="M:MailKit.Search.UnarySearchQuery.#ctor(MailKit.Search.SearchTerm,MailKit.Search.SearchQuery)">
  26122. <summary>
  26123. Initializes a new instance of the <see cref="T:MailKit.Search.UnarySearchQuery"/> class.
  26124. </summary>
  26125. <remarks>
  26126. Creates a new unary search query.
  26127. </remarks>
  26128. <param name="term">The search term.</param>
  26129. <param name="operand">The operand.</param>
  26130. <exception cref="T:System.ArgumentNullException">
  26131. <paramref name="operand"/> is <c>null</c>.
  26132. </exception>
  26133. </member>
  26134. <member name="P:MailKit.Search.UnarySearchQuery.Operand">
  26135. <summary>
  26136. Gets the inner operand.
  26137. </summary>
  26138. <remarks>
  26139. Gets the inner operand.
  26140. </remarks>
  26141. <value>The operand.</value>
  26142. </member>
  26143. <member name="T:MailKit.Security.Ntlm.NtlmFlags">
  26144. <summary>
  26145. The NTLM message header flags.
  26146. </summary>
  26147. <remarks>
  26148. More details here: http://davenport.sourceforge.net/ntlm.html#theNtlmMessageHeaderLayout
  26149. and at https://msdn.microsoft.com/en-us/library/cc236650.aspx
  26150. </remarks>
  26151. </member>
  26152. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateUnicode">
  26153. <summary>
  26154. Indicates that Unicode strings are supported for use in security buffer data.
  26155. </summary>
  26156. </member>
  26157. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateOem">
  26158. <summary>
  26159. Indicates that OEM strings are supported for use in security buffer data.
  26160. </summary>
  26161. </member>
  26162. <member name="F:MailKit.Security.Ntlm.NtlmFlags.RequestTarget">
  26163. <summary>
  26164. Requests that the server's authentication realm be included in the Type 2 message.
  26165. </summary>
  26166. </member>
  26167. <member name="F:MailKit.Security.Ntlm.NtlmFlags.R10">
  26168. <summary>
  26169. This flag's usage has not been identified.
  26170. </summary>
  26171. </member>
  26172. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateSign">
  26173. <summary>
  26174. Specifies that authenticated communication between the client and server should carry a digital signature (message integrity).
  26175. </summary>
  26176. </member>
  26177. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateSeal">
  26178. <summary>
  26179. Specifies that authenticated communication between the client and server should be encrypted (message confidentiality).
  26180. </summary>
  26181. </member>
  26182. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateDatagramStyle">
  26183. <summary>
  26184. Indicates that datagram authentication is being used.
  26185. </summary>
  26186. </member>
  26187. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateLanManagerKey">
  26188. <summary>
  26189. Indicates that the Lan Manager Session Key should be used for signing
  26190. and sealing authenticated communications.
  26191. </summary>
  26192. </member>
  26193. <member name="F:MailKit.Security.Ntlm.NtlmFlags.R9">
  26194. <summary>
  26195. This flag is unused and MUST be zero. (r8)
  26196. </summary>
  26197. </member>
  26198. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateNtlm">
  26199. <summary>
  26200. Indicates that NTLM authentication is being used.
  26201. </summary>
  26202. </member>
  26203. <member name="F:MailKit.Security.Ntlm.NtlmFlags.R8">
  26204. <summary>
  26205. This flag is unused and MUST be zero. (r8)
  26206. </summary>
  26207. </member>
  26208. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateAnonymous">
  26209. <summary>
  26210. Sent by the client in the Type 3 message to indicate that an anonymous
  26211. context has been established. This also affects the response fields.
  26212. </summary>
  26213. </member>
  26214. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateDomainSupplied">
  26215. <summary>
  26216. Sent by the client in the Type 1 message to indicate that the name of the
  26217. domain in which the client workstation has membership is included in the
  26218. message. This is used by the server to determine whether the client is
  26219. eligible for local authentication.
  26220. </summary>
  26221. </member>
  26222. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateWorkstationSupplied">
  26223. <summary>
  26224. Sent by the client in the Type 1 message to indicate that the client
  26225. workstation's name is included in the message. This is used by the server
  26226. to determine whether the client is eligible for local authentication.
  26227. </summary>
  26228. </member>
  26229. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateLocalCall">
  26230. <summary>
  26231. Sent by the server to indicate that the server and client are on the same
  26232. machine. Implies that the client may use the established local credentials
  26233. for authentication instead of calculating a response to the challenge.
  26234. </summary>
  26235. </member>
  26236. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateAlwaysSign">
  26237. <summary>
  26238. Indicates that authenticated communication between the client and server
  26239. should be signed with a "dummy" signature.
  26240. </summary>
  26241. </member>
  26242. <member name="F:MailKit.Security.Ntlm.NtlmFlags.TargetTypeDomain">
  26243. <summary>
  26244. Sent by the server in the Type 2 message to indicate that the target
  26245. authentication realm is a domain.
  26246. </summary>
  26247. </member>
  26248. <member name="F:MailKit.Security.Ntlm.NtlmFlags.TargetTypeServer">
  26249. <summary>
  26250. Sent by the server in the Type 2 message to indicate that the target
  26251. authentication realm is a server.
  26252. </summary>
  26253. </member>
  26254. <member name="F:MailKit.Security.Ntlm.NtlmFlags.TargetTypeShare">
  26255. <summary>
  26256. Sent by the server in the Type 2 message to indicate that the target
  26257. authentication realm is a share. Presumably, this is for share-level
  26258. authentication. Usage is unclear.
  26259. </summary>
  26260. </member>
  26261. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateNtlm2Key">
  26262. <summary>
  26263. Indicates that the NTLM2 signing and sealing scheme should be used for
  26264. protecting authenticated communications. Note that this refers to a
  26265. particular session security scheme, and is not related to the use of
  26266. NTLMv2 authentication. This flag can, however, have an effect on the
  26267. response calculations.
  26268. </summary>
  26269. </member>
  26270. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateIdentify">
  26271. <summary>
  26272. This flag's usage has not been identified.
  26273. </summary>
  26274. </member>
  26275. <member name="F:MailKit.Security.Ntlm.NtlmFlags.R5">
  26276. <summary>
  26277. This flag is unused and MUST be zero. (r5)
  26278. </summary>
  26279. </member>
  26280. <member name="F:MailKit.Security.Ntlm.NtlmFlags.RequestNonNTSessionKey">
  26281. <summary>
  26282. Indicates that the LMOWF function should be used to generate a session key.
  26283. </summary>
  26284. </member>
  26285. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateTargetInfo">
  26286. <summary>
  26287. Sent by the server in the Type 2 message to indicate that it is including
  26288. a Target Information block in the message. The Target Information block
  26289. is used in the calculation of the NTLMv2 response.
  26290. </summary>
  26291. </member>
  26292. <member name="F:MailKit.Security.Ntlm.NtlmFlags.R4">
  26293. <summary>
  26294. This flag is unused and MUST be zero. (r4)
  26295. </summary>
  26296. </member>
  26297. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateVersion">
  26298. <summary>
  26299. Indicates that the version field is present.
  26300. </summary>
  26301. </member>
  26302. <member name="F:MailKit.Security.Ntlm.NtlmFlags.R3">
  26303. <summary>
  26304. This flag is unused and MUST be zero. (r3)
  26305. </summary>
  26306. </member>
  26307. <member name="F:MailKit.Security.Ntlm.NtlmFlags.R2">
  26308. <summary>
  26309. This flag is unused and MUST be zero. (r2)
  26310. </summary>
  26311. </member>
  26312. <member name="F:MailKit.Security.Ntlm.NtlmFlags.R1">
  26313. <summary>
  26314. This flag is unused and MUST be zero. (r1)
  26315. </summary>
  26316. </member>
  26317. <member name="F:MailKit.Security.Ntlm.NtlmFlags.Negotiate128">
  26318. <summary>
  26319. Indicates that 128-bit encryption is supported.
  26320. </summary>
  26321. </member>
  26322. <member name="F:MailKit.Security.Ntlm.NtlmFlags.NegotiateKeyExchange">
  26323. <summary>
  26324. Indicates that the client will provide an encrypted master key in the
  26325. "Session Key" field of the Type 3 message.
  26326. </summary>
  26327. </member>
  26328. <member name="F:MailKit.Security.Ntlm.NtlmFlags.Negotiate56">
  26329. <summary>
  26330. Indicates that 56-bit encryption is supported.
  26331. </summary>
  26332. </member>
  26333. <member name="T:MailKit.Security.AuthenticationException">
  26334. <summary>
  26335. The exception that is thrown when there is an authentication error.
  26336. </summary>
  26337. <remarks>
  26338. The exception that is thrown when there is an authentication error.
  26339. </remarks>
  26340. </member>
  26341. <member name="M:MailKit.Security.AuthenticationException.#ctor(System.String,System.Exception)">
  26342. <summary>
  26343. Initializes a new instance of the <see cref="T:MailKit.Security.AuthenticationException"/> class.
  26344. </summary>
  26345. <remarks>
  26346. Creates a new <see cref="T:MailKit.Security.AuthenticationException"/>.
  26347. </remarks>
  26348. <param name="message">The error message.</param>
  26349. <param name="innerException">An inner exception.</param>
  26350. </member>
  26351. <member name="M:MailKit.Security.AuthenticationException.#ctor(System.String)">
  26352. <summary>
  26353. Initializes a new instance of the <see cref="T:MailKit.Security.AuthenticationException"/> class.
  26354. </summary>
  26355. <remarks>
  26356. Creates a new <see cref="T:MailKit.Security.AuthenticationException"/>.
  26357. </remarks>
  26358. <param name="message">The error message.</param>
  26359. </member>
  26360. <member name="M:MailKit.Security.AuthenticationException.#ctor">
  26361. <summary>
  26362. Initializes a new instance of the <see cref="T:MailKit.Security.AuthenticationException"/> class.
  26363. </summary>
  26364. <remarks>
  26365. Creates a new <see cref="T:MailKit.Security.AuthenticationException"/>.
  26366. </remarks>
  26367. </member>
  26368. <member name="T:MailKit.Security.SaslErrorCode">
  26369. <summary>
  26370. An enumeration of the possible error codes that may be reported by a <see cref="T:MailKit.Security.SaslException"/>.
  26371. </summary>
  26372. <remarks>
  26373. An enumeration of the possible error codes that may be reported by a <see cref="T:MailKit.Security.SaslException"/>.
  26374. </remarks>
  26375. </member>
  26376. <member name="F:MailKit.Security.SaslErrorCode.ChallengeTooLong">
  26377. <summary>
  26378. The server's challenge was too long.
  26379. </summary>
  26380. </member>
  26381. <member name="F:MailKit.Security.SaslErrorCode.IncompleteChallenge">
  26382. <summary>
  26383. The server's response contained an incomplete challenge.
  26384. </summary>
  26385. </member>
  26386. <member name="F:MailKit.Security.SaslErrorCode.InvalidChallenge">
  26387. <summary>
  26388. The server's challenge was invalid.
  26389. </summary>
  26390. </member>
  26391. <member name="F:MailKit.Security.SaslErrorCode.MissingChallenge">
  26392. <summary>
  26393. The server's response did not contain a challenge.
  26394. </summary>
  26395. </member>
  26396. <member name="F:MailKit.Security.SaslErrorCode.IncorrectHash">
  26397. <summary>
  26398. The server's challenge contained an incorrect hash.
  26399. </summary>
  26400. </member>
  26401. <member name="T:MailKit.Security.SaslException">
  26402. <summary>
  26403. A SASL authentication exception.
  26404. </summary>
  26405. <remarks>
  26406. Typically indicates an error while parsing a server's challenge token.
  26407. </remarks>
  26408. </member>
  26409. <member name="M:MailKit.Security.SaslException.#ctor(System.String,MailKit.Security.SaslErrorCode,System.String)">
  26410. <summary>
  26411. Initializes a new instance of the <see cref="T:MailKit.Security.SaslException"/> class.
  26412. </summary>
  26413. <remarks>
  26414. Creates a new <see cref="T:MailKit.Security.SaslException"/>.
  26415. </remarks>
  26416. <param name="mechanism">The SASL mechanism.</param>
  26417. <param name="code">The error code.</param>
  26418. <param name="message">The error message.</param>
  26419. <exception cref="T:System.ArgumentNullException">
  26420. <paramref name="mechanism"/> is <c>null</c>.
  26421. </exception>
  26422. </member>
  26423. <member name="P:MailKit.Security.SaslException.ErrorCode">
  26424. <summary>
  26425. Gets the error code.
  26426. </summary>
  26427. <remarks>
  26428. Gets the error code.
  26429. </remarks>
  26430. <value>The error code.</value>
  26431. </member>
  26432. <member name="P:MailKit.Security.SaslException.Mechanism">
  26433. <summary>
  26434. Gets the name of the SASL mechanism that had the error.
  26435. </summary>
  26436. <remarks>
  26437. Gets the name of the SASL mechanism that had the error.
  26438. </remarks>
  26439. <value>The name of the SASL mechanism.</value>
  26440. </member>
  26441. <member name="T:MailKit.Security.SaslMechanism">
  26442. <summary>
  26443. A SASL authentication mechanism.
  26444. </summary>
  26445. <remarks>
  26446. Authenticating via a SASL mechanism may be a multi-step process.
  26447. To determine if the mechanism has completed the necessary steps
  26448. to authentication, check the <see cref="P:MailKit.Security.SaslMechanism.IsAuthenticated"/> after
  26449. each call to <see cref="M:MailKit.Security.SaslMechanism.Challenge(System.String)"/>.
  26450. </remarks>
  26451. </member>
  26452. <member name="F:MailKit.Security.SaslMechanism.AuthMechanismRank">
  26453. <summary>
  26454. The supported authentication mechanisms in order of strongest to weakest.
  26455. </summary>
  26456. <remarks>
  26457. Used by the various clients when authenticating via SASL to determine
  26458. which order the SASL mechanisms supported by the server should be tried.
  26459. </remarks>
  26460. </member>
  26461. <member name="M:MailKit.Security.SaslMechanism.#ctor(System.Uri,System.Net.ICredentials)">
  26462. <summary>
  26463. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanism"/> class.
  26464. </summary>
  26465. <remarks>
  26466. Creates a new SASL context.
  26467. </remarks>
  26468. <param name="uri">The URI of the service.</param>
  26469. <param name="credentials">The user's credentials.</param>
  26470. <exception cref="T:System.ArgumentNullException">
  26471. <para><paramref name="uri"/> is <c>null</c>.</para>
  26472. <para>-or-</para>
  26473. <para><paramref name="credentials"/> is <c>null</c>.</para>
  26474. </exception>
  26475. </member>
  26476. <member name="M:MailKit.Security.SaslMechanism.#ctor(System.Uri,System.String,System.String)">
  26477. <summary>
  26478. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanism"/> class.
  26479. </summary>
  26480. <remarks>
  26481. Creates a new SASL context.
  26482. </remarks>
  26483. <param name="uri">The URI of the service.</param>
  26484. <param name="userName">The user name.</param>
  26485. <param name="password">The password.</param>
  26486. <exception cref="T:System.ArgumentNullException">
  26487. <para><paramref name="uri"/> is <c>null</c>.</para>
  26488. <para>-or-</para>
  26489. <para><paramref name="userName"/> is <c>null</c>.</para>
  26490. <para>-or-</para>
  26491. <para><paramref name="password"/> is <c>null</c>.</para>
  26492. </exception>
  26493. </member>
  26494. <member name="M:MailKit.Security.SaslMechanism.#ctor(System.Net.NetworkCredential)">
  26495. <summary>
  26496. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanism"/> class.
  26497. </summary>
  26498. <remarks>
  26499. Creates a new SASL context.
  26500. </remarks>
  26501. <param name="credentials">The user's credentials.</param>
  26502. <exception cref="T:System.ArgumentNullException">
  26503. <paramref name="credentials"/> is <c>null</c>.
  26504. </exception>
  26505. </member>
  26506. <member name="M:MailKit.Security.SaslMechanism.#ctor(System.String,System.String)">
  26507. <summary>
  26508. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanism"/> class.
  26509. </summary>
  26510. <remarks>
  26511. Creates a new SASL context.
  26512. </remarks>
  26513. <param name="userName">The user name.</param>
  26514. <param name="password">The password.</param>
  26515. <exception cref="T:System.ArgumentNullException">
  26516. <para><paramref name="userName"/> is <c>null</c>.</para>
  26517. <para>-or-</para>
  26518. <para><paramref name="password"/> is <c>null</c>.</para>
  26519. </exception>
  26520. </member>
  26521. <member name="P:MailKit.Security.SaslMechanism.MechanismName">
  26522. <summary>
  26523. Gets the name of the mechanism.
  26524. </summary>
  26525. <remarks>
  26526. Gets the name of the mechanism.
  26527. </remarks>
  26528. <value>The name of the mechanism.</value>
  26529. </member>
  26530. <member name="P:MailKit.Security.SaslMechanism.Credentials">
  26531. <summary>
  26532. Gets the user's credentials.
  26533. </summary>
  26534. <remarks>
  26535. Gets the user's credentials.
  26536. </remarks>
  26537. <value>The user's credentials.</value>
  26538. </member>
  26539. <member name="P:MailKit.Security.SaslMechanism.SupportsInitialResponse">
  26540. <summary>
  26541. Gets whether or not the mechanism supports an initial response (SASL-IR).
  26542. </summary>
  26543. <remarks>
  26544. SASL mechanisms that support sending an initial client response to the server
  26545. should return <value>true</value>.
  26546. </remarks>
  26547. <value><c>true</c> if the mechanism supports an initial response; otherwise, <c>false</c>.</value>
  26548. </member>
  26549. <member name="P:MailKit.Security.SaslMechanism.IsAuthenticated">
  26550. <summary>
  26551. Gets or sets whether the SASL mechanism has finished authenticating.
  26552. </summary>
  26553. <remarks>
  26554. Gets or sets whether the SASL mechanism has finished authenticating.
  26555. </remarks>
  26556. <value><c>true</c> if the SASL mechanism has finished authenticating; otherwise, <c>false</c>.</value>
  26557. </member>
  26558. <member name="P:MailKit.Security.SaslMechanism.NegotiatedSecurityLayer">
  26559. <summary>
  26560. Gets whether or not a security layer was negotiated.
  26561. </summary>
  26562. <remarks>
  26563. <para>Gets whether or not a security layer has been negotiated by the SASL mechanism.</para>
  26564. <note type="note">Some SASL mechanisms, such as GSSAPI, are able to negotiate security layers
  26565. such as integrity and confidentiality protection.</note>
  26566. </remarks>
  26567. <value><c>true</c> if a security layer was negotiated; otherwise, <c>false</c>.</value>
  26568. </member>
  26569. <member name="P:MailKit.Security.SaslMechanism.Uri">
  26570. <summary>
  26571. Gets or sets the URI of the service.
  26572. </summary>
  26573. <remarks>
  26574. Gets or sets the URI of the service.
  26575. </remarks>
  26576. <value>The URI of the service.</value>
  26577. </member>
  26578. <member name="M:MailKit.Security.SaslMechanism.Challenge(System.Byte[],System.Int32,System.Int32)">
  26579. <summary>
  26580. Parses the server's challenge token and returns the next challenge response.
  26581. </summary>
  26582. <remarks>
  26583. Parses the server's challenge token and returns the next challenge response.
  26584. </remarks>
  26585. <returns>The next challenge response.</returns>
  26586. <param name="token">The server's challenge token.</param>
  26587. <param name="startIndex">The index into the token specifying where the server's challenge begins.</param>
  26588. <param name="length">The length of the server's challenge.</param>
  26589. <exception cref="T:System.InvalidOperationException">
  26590. The SASL mechanism is already authenticated.
  26591. </exception>
  26592. <exception cref="T:System.NotSupportedException">
  26593. THe SASL mechanism does not support SASL-IR.
  26594. </exception>
  26595. <exception cref="T:MailKit.Security.SaslException">
  26596. An error has occurred while parsing the server's challenge token.
  26597. </exception>
  26598. </member>
  26599. <member name="M:MailKit.Security.SaslMechanism.Challenge(System.String)">
  26600. <summary>
  26601. Decodes the base64-encoded server challenge and returns the next challenge response encoded in base64.
  26602. </summary>
  26603. <remarks>
  26604. Decodes the base64-encoded server challenge and returns the next challenge response encoded in base64.
  26605. </remarks>
  26606. <returns>The next base64-encoded challenge response.</returns>
  26607. <param name="token">The server's base64-encoded challenge token.</param>
  26608. <exception cref="T:System.InvalidOperationException">
  26609. The SASL mechanism is already authenticated.
  26610. </exception>
  26611. <exception cref="T:System.NotSupportedException">
  26612. THe SASL mechanism does not support SASL-IR.
  26613. </exception>
  26614. <exception cref="T:MailKit.Security.SaslException">
  26615. An error has occurred while parsing the server's challenge token.
  26616. </exception>
  26617. </member>
  26618. <member name="M:MailKit.Security.SaslMechanism.Reset">
  26619. <summary>
  26620. Resets the state of the SASL mechanism.
  26621. </summary>
  26622. <remarks>
  26623. Resets the state of the SASL mechanism.
  26624. </remarks>
  26625. </member>
  26626. <member name="M:MailKit.Security.SaslMechanism.IsSupported(System.String)">
  26627. <summary>
  26628. Determines if the specified SASL mechanism is supported by MailKit.
  26629. </summary>
  26630. <remarks>
  26631. Use this method to make sure that a SASL mechanism is supported before calling
  26632. <see cref="M:MailKit.Security.SaslMechanism.Create(System.String,System.Uri,System.Net.ICredentials)"/>.
  26633. </remarks>
  26634. <returns><c>true</c> if the specified SASL mechanism is supported; otherwise, <c>false</c>.</returns>
  26635. <param name="mechanism">The name of the SASL mechanism.</param>
  26636. <exception cref="T:System.ArgumentNullException">
  26637. <paramref name="mechanism"/> is <c>null</c>.
  26638. </exception>
  26639. </member>
  26640. <member name="M:MailKit.Security.SaslMechanism.Create(System.String,System.Uri,System.Text.Encoding,System.Net.ICredentials)">
  26641. <summary>
  26642. Create an instance of the specified SASL mechanism using the uri and credentials.
  26643. </summary>
  26644. <remarks>
  26645. If unsure that a particular SASL mechanism is supported, you should first call
  26646. <see cref="M:MailKit.Security.SaslMechanism.IsSupported(System.String)"/>.
  26647. </remarks>
  26648. <returns>An instance of the requested SASL mechanism if supported; otherwise <c>null</c>.</returns>
  26649. <param name="mechanism">The name of the SASL mechanism.</param>
  26650. <param name="uri">The URI of the service to authenticate against.</param>
  26651. <param name="encoding">The text encoding to use for the credentials.</param>
  26652. <param name="credentials">The user's credentials.</param>
  26653. <exception cref="T:System.ArgumentNullException">
  26654. <para><paramref name="mechanism"/> is <c>null</c>.</para>
  26655. <para>-or-</para>
  26656. <para><paramref name="uri"/> is <c>null</c>.</para>
  26657. <para>-or-</para>
  26658. <para><paramref name="encoding"/> is <c>null</c>.</para>
  26659. <para>-or-</para>
  26660. <para><paramref name="credentials"/> is <c>null</c>.</para>
  26661. </exception>
  26662. </member>
  26663. <member name="M:MailKit.Security.SaslMechanism.Create(System.String,System.Uri,System.Net.ICredentials)">
  26664. <summary>
  26665. Create an instance of the specified SASL mechanism using the uri and credentials.
  26666. </summary>
  26667. <remarks>
  26668. If unsure that a particular SASL mechanism is supported, you should first call
  26669. <see cref="M:MailKit.Security.SaslMechanism.IsSupported(System.String)"/>.
  26670. </remarks>
  26671. <returns>An instance of the requested SASL mechanism if supported; otherwise <c>null</c>.</returns>
  26672. <param name="mechanism">The name of the SASL mechanism.</param>
  26673. <param name="uri">The URI of the service to authenticate against.</param>
  26674. <param name="credentials">The user's credentials.</param>
  26675. <exception cref="T:System.ArgumentNullException">
  26676. <para><paramref name="mechanism"/> is <c>null</c>.</para>
  26677. <para>-or-</para>
  26678. <para><paramref name="uri"/> is <c>null</c>.</para>
  26679. <para>-or-</para>
  26680. <para><paramref name="credentials"/> is <c>null</c>.</para>
  26681. </exception>
  26682. </member>
  26683. <member name="M:MailKit.Security.SaslMechanism.IsNonAsciiSpace(System.Char)">
  26684. <summary>
  26685. Determines if the character is a non-ASCII space.
  26686. </summary>
  26687. <remarks>
  26688. This list was obtained from http://tools.ietf.org/html/rfc3454#appendix-C.1.2
  26689. </remarks>
  26690. <returns><c>true</c> if the character is a non-ASCII space; otherwise, <c>false</c>.</returns>
  26691. <param name="c">The character.</param>
  26692. </member>
  26693. <member name="M:MailKit.Security.SaslMechanism.IsCommonlyMappedToNothing(System.Char)">
  26694. <summary>
  26695. Determines if the character is commonly mapped to nothing.
  26696. </summary>
  26697. <remarks>
  26698. This list was obtained from http://tools.ietf.org/html/rfc3454#appendix-B.1
  26699. </remarks>
  26700. <returns><c>true</c> if the character is commonly mapped to nothing; otherwise, <c>false</c>.</returns>
  26701. <param name="c">The character.</param>
  26702. </member>
  26703. <member name="M:MailKit.Security.SaslMechanism.IsProhibited(System.String,System.Int32)">
  26704. <summary>
  26705. Determines if the character is prohibited.
  26706. </summary>
  26707. <remarks>
  26708. This list was obtained from http://tools.ietf.org/html/rfc3454#appendix-C.3
  26709. </remarks>
  26710. <returns><c>true</c> if the character is prohibited; otherwise, <c>false</c>.</returns>
  26711. <param name="s">The string.</param>
  26712. <param name="index">The character index.</param>
  26713. </member>
  26714. <member name="M:MailKit.Security.SaslMechanism.SaslPrep(System.String)">
  26715. <summary>
  26716. Prepares the user name or password string.
  26717. </summary>
  26718. <remarks>
  26719. Prepares a user name or password string according to the rules of rfc4013.
  26720. </remarks>
  26721. <returns>The prepared string.</returns>
  26722. <param name="s">The string to prepare.</param>
  26723. <exception cref="T:System.ArgumentNullException">
  26724. <paramref name="s"/> is <c>null</c>.
  26725. </exception>
  26726. <exception cref="T:System.ArgumentException">
  26727. <paramref name="s"/> contains prohibited characters.
  26728. </exception>
  26729. </member>
  26730. <member name="T:MailKit.Security.SaslMechanismCramMd5">
  26731. <summary>
  26732. The CRAM-MD5 SASL mechanism.
  26733. </summary>
  26734. <remarks>
  26735. A SASL mechanism based on HMAC-MD5.
  26736. </remarks>
  26737. </member>
  26738. <member name="M:MailKit.Security.SaslMechanismCramMd5.#ctor(System.Uri,System.Net.ICredentials)">
  26739. <summary>
  26740. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismCramMd5"/> class.
  26741. </summary>
  26742. <remarks>
  26743. Creates a new CRAM-MD5 SASL context.
  26744. </remarks>
  26745. <param name="uri">The URI of the service.</param>
  26746. <param name="credentials">The user's credentials.</param>
  26747. <exception cref="T:System.ArgumentNullException">
  26748. <para><paramref name="uri"/> is <c>null</c>.</para>
  26749. <para>-or-</para>
  26750. <para><paramref name="credentials"/> is <c>null</c>.</para>
  26751. </exception>
  26752. </member>
  26753. <member name="M:MailKit.Security.SaslMechanismCramMd5.#ctor(System.Uri,System.String,System.String)">
  26754. <summary>
  26755. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismCramMd5"/> class.
  26756. </summary>
  26757. <remarks>
  26758. Creates a new CRAM-MD5 SASL context.
  26759. </remarks>
  26760. <param name="uri">The URI of the service.</param>
  26761. <param name="userName">The user name.</param>
  26762. <param name="password">The password.</param>
  26763. <exception cref="T:System.ArgumentNullException">
  26764. <para><paramref name="uri"/> is <c>null</c>.</para>
  26765. <para>-or-</para>
  26766. <para><paramref name="userName"/> is <c>null</c>.</para>
  26767. <para>-or-</para>
  26768. <para><paramref name="password"/> is <c>null</c>.</para>
  26769. </exception>
  26770. </member>
  26771. <member name="M:MailKit.Security.SaslMechanismCramMd5.#ctor(System.Net.NetworkCredential)">
  26772. <summary>
  26773. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismCramMd5"/> class.
  26774. </summary>
  26775. <remarks>
  26776. Creates a new CRAM-MD5 SASL context.
  26777. </remarks>
  26778. <param name="credentials">The user's credentials.</param>
  26779. <exception cref="T:System.ArgumentNullException">
  26780. <paramref name="credentials"/> is <c>null</c>.
  26781. </exception>
  26782. </member>
  26783. <member name="M:MailKit.Security.SaslMechanismCramMd5.#ctor(System.String,System.String)">
  26784. <summary>
  26785. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismCramMd5"/> class.
  26786. </summary>
  26787. <remarks>
  26788. Creates a new CRAM-MD5 SASL context.
  26789. </remarks>
  26790. <param name="userName">The user name.</param>
  26791. <param name="password">The password.</param>
  26792. <exception cref="T:System.ArgumentNullException">
  26793. <para><paramref name="userName"/> is <c>null</c>.</para>
  26794. <para>-or-</para>
  26795. <para><paramref name="password"/> is <c>null</c>.</para>
  26796. </exception>
  26797. </member>
  26798. <member name="P:MailKit.Security.SaslMechanismCramMd5.MechanismName">
  26799. <summary>
  26800. Gets the name of the mechanism.
  26801. </summary>
  26802. <remarks>
  26803. Gets the name of the mechanism.
  26804. </remarks>
  26805. <value>The name of the mechanism.</value>
  26806. </member>
  26807. <member name="M:MailKit.Security.SaslMechanismCramMd5.Challenge(System.Byte[],System.Int32,System.Int32)">
  26808. <summary>
  26809. Parses the server's challenge token and returns the next challenge response.
  26810. </summary>
  26811. <remarks>
  26812. Parses the server's challenge token and returns the next challenge response.
  26813. </remarks>
  26814. <returns>The next challenge response.</returns>
  26815. <param name="token">The server's challenge token.</param>
  26816. <param name="startIndex">The index into the token specifying where the server's challenge begins.</param>
  26817. <param name="length">The length of the server's challenge.</param>
  26818. <exception cref="T:System.InvalidOperationException">
  26819. The SASL mechanism is already authenticated.
  26820. </exception>
  26821. <exception cref="T:System.NotSupportedException">
  26822. The SASL mechanism does not support SASL-IR.
  26823. </exception>
  26824. <exception cref="T:MailKit.Security.SaslException">
  26825. An error has occurred while parsing the server's challenge token.
  26826. </exception>
  26827. </member>
  26828. <member name="T:MailKit.Security.SaslMechanismDigestMd5">
  26829. <summary>
  26830. The DIGEST-MD5 SASL mechanism.
  26831. </summary>
  26832. <remarks>
  26833. Unlike the PLAIN and LOGIN SASL mechanisms, the DIGEST-MD5 mechanism
  26834. provides some level of protection and should be relatively safe to
  26835. use even with a clear-text connection.
  26836. </remarks>
  26837. </member>
  26838. <member name="M:MailKit.Security.SaslMechanismDigestMd5.#ctor(System.Uri,System.Net.ICredentials)">
  26839. <summary>
  26840. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismDigestMd5"/> class.
  26841. </summary>
  26842. <remarks>
  26843. Creates a new DIGEST-MD5 SASL context.
  26844. </remarks>
  26845. <param name="uri">The URI of the service.</param>
  26846. <param name="credentials">The user's credentials.</param>
  26847. <exception cref="T:System.ArgumentNullException">
  26848. <para><paramref name="uri"/> is <c>null</c>.</para>
  26849. <para>-or-</para>
  26850. <para><paramref name="credentials"/> is <c>null</c>.</para>
  26851. </exception>
  26852. </member>
  26853. <member name="M:MailKit.Security.SaslMechanismDigestMd5.#ctor(System.Uri,System.String,System.String)">
  26854. <summary>
  26855. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismDigestMd5"/> class.
  26856. </summary>
  26857. <remarks>
  26858. Creates a new DIGEST-MD5 SASL context.
  26859. </remarks>
  26860. <param name="uri">The URI of the service.</param>
  26861. <param name="userName">The user name.</param>
  26862. <param name="password">The password.</param>
  26863. <exception cref="T:System.ArgumentNullException">
  26864. <para><paramref name="uri"/> is <c>null</c>.</para>
  26865. <para>-or-</para>
  26866. <para><paramref name="userName"/> is <c>null</c>.</para>
  26867. <para>-or-</para>
  26868. <para><paramref name="password"/> is <c>null</c>.</para>
  26869. </exception>
  26870. </member>
  26871. <member name="M:MailKit.Security.SaslMechanismDigestMd5.#ctor(System.Net.NetworkCredential)">
  26872. <summary>
  26873. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismDigestMd5"/> class.
  26874. </summary>
  26875. <remarks>
  26876. Creates a new DIGEST-MD5 SASL context.
  26877. </remarks>
  26878. <param name="credentials">The user's credentials.</param>
  26879. <exception cref="T:System.ArgumentNullException">
  26880. <paramref name="credentials"/> is <c>null</c>.
  26881. </exception>
  26882. </member>
  26883. <member name="M:MailKit.Security.SaslMechanismDigestMd5.#ctor(System.String,System.String)">
  26884. <summary>
  26885. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismDigestMd5"/> class.
  26886. </summary>
  26887. <remarks>
  26888. Creates a new DIGEST-MD5 SASL context.
  26889. </remarks>
  26890. <param name="userName">The user name.</param>
  26891. <param name="password">The password.</param>
  26892. <exception cref="T:System.ArgumentNullException">
  26893. <para><paramref name="userName"/> is <c>null</c>.</para>
  26894. <para>-or-</para>
  26895. <para><paramref name="password"/> is <c>null</c>.</para>
  26896. </exception>
  26897. </member>
  26898. <member name="P:MailKit.Security.SaslMechanismDigestMd5.AuthorizationId">
  26899. <summary>
  26900. Gets or sets the authorization identifier.
  26901. </summary>
  26902. <remarks>
  26903. The authorization identifier is the desired user account that the server should use
  26904. for all accesses. This is separate from the user name used for authentication.
  26905. </remarks>
  26906. <value>The authorization identifier.</value>
  26907. </member>
  26908. <member name="P:MailKit.Security.SaslMechanismDigestMd5.MechanismName">
  26909. <summary>
  26910. Gets the name of the mechanism.
  26911. </summary>
  26912. <remarks>
  26913. Gets the name of the mechanism.
  26914. </remarks>
  26915. <value>The name of the mechanism.</value>
  26916. </member>
  26917. <member name="M:MailKit.Security.SaslMechanismDigestMd5.Challenge(System.Byte[],System.Int32,System.Int32)">
  26918. <summary>
  26919. Parses the server's challenge token and returns the next challenge response.
  26920. </summary>
  26921. <remarks>
  26922. Parses the server's challenge token and returns the next challenge response.
  26923. </remarks>
  26924. <returns>The next challenge response.</returns>
  26925. <param name="token">The server's challenge token.</param>
  26926. <param name="startIndex">The index into the token specifying where the server's challenge begins.</param>
  26927. <param name="length">The length of the server's challenge.</param>
  26928. <exception cref="T:System.InvalidOperationException">
  26929. The SASL mechanism is already authenticated.
  26930. </exception>
  26931. <exception cref="T:System.NotSupportedException">
  26932. THe SASL mechanism does not support SASL-IR.
  26933. </exception>
  26934. <exception cref="T:MailKit.Security.SaslException">
  26935. An error has occurred while parsing the server's challenge token.
  26936. </exception>
  26937. </member>
  26938. <member name="M:MailKit.Security.SaslMechanismDigestMd5.Reset">
  26939. <summary>
  26940. Resets the state of the SASL mechanism.
  26941. </summary>
  26942. <remarks>
  26943. Resets the state of the SASL mechanism.
  26944. </remarks>
  26945. </member>
  26946. <member name="T:MailKit.Security.SaslMechanismLogin">
  26947. <summary>
  26948. The LOGIN SASL mechanism.
  26949. </summary>
  26950. <remarks>
  26951. The LOGIN SASL mechanism provides little protection over the use
  26952. of plain-text passwords by obscuring the user name and password within
  26953. individual base64-encoded blobs and should be avoided unless used in
  26954. combination with an SSL or TLS connection.
  26955. </remarks>
  26956. </member>
  26957. <member name="M:MailKit.Security.SaslMechanismLogin.#ctor(System.Uri,System.Text.Encoding,System.Net.ICredentials)">
  26958. <summary>
  26959. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismLogin"/> class.
  26960. </summary>
  26961. <remarks>
  26962. Creates a new LOGIN SASL context.
  26963. </remarks>
  26964. <param name="uri">The URI of the service.</param>
  26965. <param name="encoding">The encoding to use for the user's credentials.</param>
  26966. <param name="credentials">The user's credentials.</param>
  26967. <exception cref="T:System.ArgumentNullException">
  26968. <para><paramref name="uri"/> is <c>null</c>.</para>
  26969. <para>-or-</para>
  26970. <para><paramref name="encoding"/> is <c>null</c>.</para>
  26971. <para>-or-</para>
  26972. <para><paramref name="credentials"/> is <c>null</c>.</para>
  26973. </exception>
  26974. </member>
  26975. <member name="M:MailKit.Security.SaslMechanismLogin.#ctor(System.Uri,System.Text.Encoding,System.String,System.String)">
  26976. <summary>
  26977. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismLogin"/> class.
  26978. </summary>
  26979. <remarks>
  26980. Creates a new LOGIN SASL context.
  26981. </remarks>
  26982. <param name="uri">The URI of the service.</param>
  26983. <param name="encoding">The encoding to use for the user's credentials.</param>
  26984. <param name="userName">The user name.</param>
  26985. <param name="password">The password.</param>
  26986. <exception cref="T:System.ArgumentNullException">
  26987. <para><paramref name="uri"/> is <c>null</c>.</para>
  26988. <para>-or-</para>
  26989. <para><paramref name="encoding"/> is <c>null</c>.</para>
  26990. <para>-or-</para>
  26991. <para><paramref name="userName"/> is <c>null</c>.</para>
  26992. <para>-or-</para>
  26993. <para><paramref name="password"/> is <c>null</c>.</para>
  26994. </exception>
  26995. </member>
  26996. <member name="M:MailKit.Security.SaslMechanismLogin.#ctor(System.Uri,System.Net.ICredentials)">
  26997. <summary>
  26998. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismLogin"/> class.
  26999. </summary>
  27000. <remarks>
  27001. Creates a new LOGIN SASL context.
  27002. </remarks>
  27003. <param name="uri">The URI of the service.</param>
  27004. <param name="credentials">The user's credentials.</param>
  27005. <exception cref="T:System.ArgumentNullException">
  27006. <para><paramref name="uri"/> is <c>null</c>.</para>
  27007. <para>-or-</para>
  27008. <para><paramref name="credentials"/> is <c>null</c>.</para>
  27009. </exception>
  27010. </member>
  27011. <member name="M:MailKit.Security.SaslMechanismLogin.#ctor(System.Uri,System.String,System.String)">
  27012. <summary>
  27013. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismLogin"/> class.
  27014. </summary>
  27015. <remarks>
  27016. Creates a new LOGIN SASL context.
  27017. </remarks>
  27018. <param name="uri">The URI of the service.</param>
  27019. <param name="userName">The user name.</param>
  27020. <param name="password">The password.</param>
  27021. <exception cref="T:System.ArgumentNullException">
  27022. <para><paramref name="uri"/> is <c>null</c>.</para>
  27023. <para>-or-</para>
  27024. <para><paramref name="userName"/> is <c>null</c>.</para>
  27025. <para>-or-</para>
  27026. <para><paramref name="password"/> is <c>null</c>.</para>
  27027. </exception>
  27028. </member>
  27029. <member name="M:MailKit.Security.SaslMechanismLogin.#ctor(System.Text.Encoding,System.Net.NetworkCredential)">
  27030. <summary>
  27031. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismLogin"/> class.
  27032. </summary>
  27033. <remarks>
  27034. Creates a new LOGIN SASL context.
  27035. </remarks>
  27036. <param name="encoding">The encoding to use for the user's credentials.</param>
  27037. <param name="credentials">The user's credentials.</param>
  27038. <exception cref="T:System.ArgumentNullException">
  27039. <para><paramref name="encoding"/> is <c>null</c>.</para>
  27040. <para>-or-</para>
  27041. <para><paramref name="credentials"/> is <c>null</c>.</para>
  27042. </exception>
  27043. </member>
  27044. <member name="M:MailKit.Security.SaslMechanismLogin.#ctor(System.Text.Encoding,System.String,System.String)">
  27045. <summary>
  27046. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismLogin"/> class.
  27047. </summary>
  27048. <remarks>
  27049. Creates a new LOGIN SASL context.
  27050. </remarks>
  27051. <param name="encoding">The encoding to use for the user's credentials.</param>
  27052. <param name="userName">The user name.</param>
  27053. <param name="password">The password.</param>
  27054. <exception cref="T:System.ArgumentNullException">
  27055. <para><paramref name="encoding"/> is <c>null</c>.</para>
  27056. <para>-or-</para>
  27057. <para><paramref name="userName"/> is <c>null</c>.</para>
  27058. <para>-or-</para>
  27059. <para><paramref name="password"/> is <c>null</c>.</para>
  27060. </exception>
  27061. </member>
  27062. <member name="M:MailKit.Security.SaslMechanismLogin.#ctor(System.Net.NetworkCredential)">
  27063. <summary>
  27064. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismLogin"/> class.
  27065. </summary>
  27066. <remarks>
  27067. Creates a new LOGIN SASL context.
  27068. </remarks>
  27069. <param name="credentials">The user's credentials.</param>
  27070. <exception cref="T:System.ArgumentNullException">
  27071. <paramref name="credentials"/> is <c>null</c>.
  27072. </exception>
  27073. </member>
  27074. <member name="M:MailKit.Security.SaslMechanismLogin.#ctor(System.String,System.String)">
  27075. <summary>
  27076. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismLogin"/> class.
  27077. </summary>
  27078. <remarks>
  27079. Creates a new LOGIN SASL context.
  27080. </remarks>
  27081. <param name="userName">The user name.</param>
  27082. <param name="password">The password.</param>
  27083. <exception cref="T:System.ArgumentNullException">
  27084. <para><paramref name="userName"/> is <c>null</c>.</para>
  27085. <para>-or-</para>
  27086. <para><paramref name="password"/> is <c>null</c>.</para>
  27087. </exception>
  27088. </member>
  27089. <member name="P:MailKit.Security.SaslMechanismLogin.MechanismName">
  27090. <summary>
  27091. Gets the name of the mechanism.
  27092. </summary>
  27093. <remarks>
  27094. Gets the name of the mechanism.
  27095. </remarks>
  27096. <value>The name of the mechanism.</value>
  27097. </member>
  27098. <member name="P:MailKit.Security.SaslMechanismLogin.SupportsInitialResponse">
  27099. <summary>
  27100. Gets whether or not the mechanism supports an initial response (SASL-IR).
  27101. </summary>
  27102. <remarks>
  27103. SASL mechanisms that support sending an initial client response to the server
  27104. should return <value>true</value>.
  27105. </remarks>
  27106. <value><c>true</c> if the mechanism supports an initial response; otherwise, <c>false</c>.</value>
  27107. </member>
  27108. <member name="M:MailKit.Security.SaslMechanismLogin.Challenge(System.Byte[],System.Int32,System.Int32)">
  27109. <summary>
  27110. Parses the server's challenge token and returns the next challenge response.
  27111. </summary>
  27112. <remarks>
  27113. Parses the server's challenge token and returns the next challenge response.
  27114. </remarks>
  27115. <returns>The next challenge response.</returns>
  27116. <param name="token">The server's challenge token.</param>
  27117. <param name="startIndex">The index into the token specifying where the server's challenge begins.</param>
  27118. <param name="length">The length of the server's challenge.</param>
  27119. <exception cref="T:System.InvalidOperationException">
  27120. The SASL mechanism is already authenticated.
  27121. </exception>
  27122. <exception cref="T:System.NotSupportedException">
  27123. The SASL mechanism does not support SASL-IR.
  27124. </exception>
  27125. <exception cref="T:MailKit.Security.SaslException">
  27126. An error has occurred while parsing the server's challenge token.
  27127. </exception>
  27128. </member>
  27129. <member name="M:MailKit.Security.SaslMechanismLogin.Reset">
  27130. <summary>
  27131. Resets the state of the SASL mechanism.
  27132. </summary>
  27133. <remarks>
  27134. Resets the state of the SASL mechanism.
  27135. </remarks>
  27136. </member>
  27137. <member name="T:MailKit.Security.SaslMechanismNtlm">
  27138. <summary>
  27139. The NTLM SASL mechanism.
  27140. </summary>
  27141. <remarks>
  27142. A SASL mechanism based on NTLM.
  27143. </remarks>
  27144. </member>
  27145. <member name="M:MailKit.Security.SaslMechanismNtlm.#ctor(System.Uri,System.Net.ICredentials)">
  27146. <summary>
  27147. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismNtlm"/> class.
  27148. </summary>
  27149. <remarks>
  27150. Creates a new NTLM SASL context.
  27151. </remarks>
  27152. <param name="uri">The URI of the service.</param>
  27153. <param name="credentials">The user's credentials.</param>
  27154. <exception cref="T:System.ArgumentNullException">
  27155. <para><paramref name="uri"/> is <c>null</c>.</para>
  27156. <para>-or-</para>
  27157. <para><paramref name="credentials"/> is <c>null</c>.</para>
  27158. </exception>
  27159. </member>
  27160. <member name="M:MailKit.Security.SaslMechanismNtlm.#ctor(System.Uri,System.String,System.String)">
  27161. <summary>
  27162. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismNtlm"/> class.
  27163. </summary>
  27164. <remarks>
  27165. Creates a new NTLM SASL context.
  27166. </remarks>
  27167. <param name="uri">The URI of the service.</param>
  27168. <param name="userName">The user name.</param>
  27169. <param name="password">The password.</param>
  27170. <exception cref="T:System.ArgumentNullException">
  27171. <para><paramref name="uri"/> is <c>null</c>.</para>
  27172. <para>-or-</para>
  27173. <para><paramref name="userName"/> is <c>null</c>.</para>
  27174. <para>-or-</para>
  27175. <para><paramref name="password"/> is <c>null</c>.</para>
  27176. </exception>
  27177. </member>
  27178. <member name="M:MailKit.Security.SaslMechanismNtlm.#ctor(System.Net.NetworkCredential)">
  27179. <summary>
  27180. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismNtlm"/> class.
  27181. </summary>
  27182. <remarks>
  27183. Creates a new NTLM SASL context.
  27184. </remarks>
  27185. <param name="credentials">The user's credentials.</param>
  27186. <exception cref="T:System.ArgumentNullException">
  27187. <paramref name="credentials"/> is <c>null</c>.
  27188. </exception>
  27189. </member>
  27190. <member name="M:MailKit.Security.SaslMechanismNtlm.#ctor(System.String,System.String)">
  27191. <summary>
  27192. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismNtlm"/> class.
  27193. </summary>
  27194. <remarks>
  27195. Creates a new NTLM SASL context.
  27196. </remarks>
  27197. <param name="userName">The user name.</param>
  27198. <param name="password">The password.</param>
  27199. <exception cref="T:System.ArgumentNullException">
  27200. <para><paramref name="userName"/> is <c>null</c>.</para>
  27201. <para>-or-</para>
  27202. <para><paramref name="password"/> is <c>null</c>.</para>
  27203. </exception>
  27204. </member>
  27205. <member name="P:MailKit.Security.SaslMechanismNtlm.MechanismName">
  27206. <summary>
  27207. Gets the name of the mechanism.
  27208. </summary>
  27209. <remarks>
  27210. Gets the name of the mechanism.
  27211. </remarks>
  27212. <value>The name of the mechanism.</value>
  27213. </member>
  27214. <member name="P:MailKit.Security.SaslMechanismNtlm.SupportsInitialResponse">
  27215. <summary>
  27216. Gets whether or not the mechanism supports an initial response (SASL-IR).
  27217. </summary>
  27218. <remarks>
  27219. SASL mechanisms that support sending an initial client response to the server
  27220. should return <value>true</value>.
  27221. </remarks>
  27222. <value><c>true</c> if the mechanism supports an initial response; otherwise, <c>false</c>.</value>
  27223. </member>
  27224. <member name="P:MailKit.Security.SaslMechanismNtlm.Workstation">
  27225. <summary>
  27226. Gets or sets the workstation name to use for authentication.
  27227. </summary>
  27228. <remarks>
  27229. Gets or sets the workstation name to use for authentication.
  27230. </remarks>
  27231. <value>The workstation name.</value>
  27232. </member>
  27233. <member name="M:MailKit.Security.SaslMechanismNtlm.Challenge(System.Byte[],System.Int32,System.Int32)">
  27234. <summary>
  27235. Parses the server's challenge token and returns the next challenge response.
  27236. </summary>
  27237. <remarks>
  27238. Parses the server's challenge token and returns the next challenge response.
  27239. </remarks>
  27240. <returns>The next challenge response.</returns>
  27241. <param name="token">The server's challenge token.</param>
  27242. <param name="startIndex">The index into the token specifying where the server's challenge begins.</param>
  27243. <param name="length">The length of the server's challenge.</param>
  27244. <exception cref="T:System.InvalidOperationException">
  27245. The SASL mechanism is already authenticated.
  27246. </exception>
  27247. <exception cref="T:MailKit.Security.SaslException">
  27248. An error has occurred while parsing the server's challenge token.
  27249. </exception>
  27250. </member>
  27251. <member name="M:MailKit.Security.SaslMechanismNtlm.Reset">
  27252. <summary>
  27253. Resets the state of the SASL mechanism.
  27254. </summary>
  27255. <remarks>
  27256. Resets the state of the SASL mechanism.
  27257. </remarks>
  27258. </member>
  27259. <member name="T:MailKit.Security.SaslMechanismOAuth2">
  27260. <summary>
  27261. The OAuth2 SASL mechanism.
  27262. </summary>
  27263. <remarks>
  27264. A SASL mechanism used by Google that makes use of a short-lived
  27265. OAuth 2.0 access token.
  27266. </remarks>
  27267. </member>
  27268. <member name="M:MailKit.Security.SaslMechanismOAuth2.#ctor(System.Uri,System.Net.ICredentials)">
  27269. <summary>
  27270. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismOAuth2"/> class.
  27271. </summary>
  27272. <remarks>
  27273. Creates a new XOAUTH2 SASL context.
  27274. </remarks>
  27275. <param name="uri">The URI of the service.</param>
  27276. <param name="credentials">The user's credentials.</param>
  27277. <exception cref="T:System.ArgumentNullException">
  27278. <para><paramref name="uri"/> is <c>null</c>.</para>
  27279. <para>-or-</para>
  27280. <para><paramref name="credentials"/> is <c>null</c>.</para>
  27281. </exception>
  27282. </member>
  27283. <member name="M:MailKit.Security.SaslMechanismOAuth2.#ctor(System.Uri,System.String,System.String)">
  27284. <summary>
  27285. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismOAuth2"/> class.
  27286. </summary>
  27287. <remarks>
  27288. Creates a new XOAUTH2 SASL context.
  27289. </remarks>
  27290. <param name="uri">The URI of the service.</param>
  27291. <param name="userName">The user name.</param>
  27292. <param name="auth_token">The auth token.</param>
  27293. <exception cref="T:System.ArgumentNullException">
  27294. <para><paramref name="uri"/> is <c>null</c>.</para>
  27295. <para>-or-</para>
  27296. <para><paramref name="userName"/> is <c>null</c>.</para>
  27297. <para>-or-</para>
  27298. <para><paramref name="auth_token"/> is <c>null</c>.</para>
  27299. </exception>
  27300. </member>
  27301. <member name="M:MailKit.Security.SaslMechanismOAuth2.#ctor(System.Net.NetworkCredential)">
  27302. <summary>
  27303. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismOAuth2"/> class.
  27304. </summary>
  27305. <remarks>
  27306. Creates a new XOAUTH2 SASL context.
  27307. </remarks>
  27308. <param name="credentials">The user's credentials.</param>
  27309. <exception cref="T:System.ArgumentNullException">
  27310. <paramref name="credentials"/> is <c>null</c>.
  27311. </exception>
  27312. </member>
  27313. <member name="M:MailKit.Security.SaslMechanismOAuth2.#ctor(System.String,System.String)">
  27314. <summary>
  27315. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismOAuth2"/> class.
  27316. </summary>
  27317. <remarks>
  27318. Creates a new XOAUTH2 SASL context.
  27319. </remarks>
  27320. <param name="userName">The user name.</param>
  27321. <param name="auth_token">The auth token.</param>
  27322. <exception cref="T:System.ArgumentNullException">
  27323. <para><paramref name="userName"/> is <c>null</c>.</para>
  27324. <para>-or-</para>
  27325. <para><paramref name="auth_token"/> is <c>null</c>.</para>
  27326. </exception>
  27327. </member>
  27328. <member name="P:MailKit.Security.SaslMechanismOAuth2.MechanismName">
  27329. <summary>
  27330. Gets the name of the mechanism.
  27331. </summary>
  27332. <remarks>
  27333. Gets the name of the mechanism.
  27334. </remarks>
  27335. <value>The name of the mechanism.</value>
  27336. </member>
  27337. <member name="P:MailKit.Security.SaslMechanismOAuth2.SupportsInitialResponse">
  27338. <summary>
  27339. Gets whether or not the mechanism supports an initial response (SASL-IR).
  27340. </summary>
  27341. <remarks>
  27342. SASL mechanisms that support sending an initial client response to the server
  27343. should return <value>true</value>.
  27344. </remarks>
  27345. <value><c>true</c> if the mechanism supports an initial response; otherwise, <c>false</c>.</value>
  27346. </member>
  27347. <member name="M:MailKit.Security.SaslMechanismOAuth2.Challenge(System.Byte[],System.Int32,System.Int32)">
  27348. <summary>
  27349. Parses the server's challenge token and returns the next challenge response.
  27350. </summary>
  27351. <remarks>
  27352. Parses the server's challenge token and returns the next challenge response.
  27353. </remarks>
  27354. <returns>The next challenge response.</returns>
  27355. <param name="token">The server's challenge token.</param>
  27356. <param name="startIndex">The index into the token specifying where the server's challenge begins.</param>
  27357. <param name="length">The length of the server's challenge.</param>
  27358. <exception cref="T:System.InvalidOperationException">
  27359. The SASL mechanism is already authenticated.
  27360. </exception>
  27361. <exception cref="T:MailKit.Security.SaslException">
  27362. An error has occurred while parsing the server's challenge token.
  27363. </exception>
  27364. </member>
  27365. <member name="T:MailKit.Security.SaslMechanismPlain">
  27366. <summary>
  27367. The PLAIN SASL mechanism.
  27368. </summary>
  27369. <remarks>
  27370. The PLAIN SASL mechanism provides little protection over the use
  27371. of plain-text passwords by combining the user name and password and
  27372. obscuring them within a base64-encoded blob and should be avoided
  27373. unless used in combination with an SSL or TLS connection.
  27374. </remarks>
  27375. </member>
  27376. <member name="M:MailKit.Security.SaslMechanismPlain.#ctor(System.Uri,System.Text.Encoding,System.Net.ICredentials)">
  27377. <summary>
  27378. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismPlain"/> class.
  27379. </summary>
  27380. <remarks>
  27381. Creates a new PLAIN SASL context.
  27382. </remarks>
  27383. <param name="uri">The URI of the service.</param>
  27384. <param name="encoding">The encoding to use for the user's credentials.</param>
  27385. <param name="credentials">The user's credentials.</param>
  27386. <exception cref="T:System.ArgumentNullException">
  27387. <para><paramref name="uri"/> is <c>null</c>.</para>
  27388. <para>-or-</para>
  27389. <para><paramref name="encoding"/> is <c>null</c>.</para>
  27390. <para>-or-</para>
  27391. <para><paramref name="credentials"/> is <c>null</c>.</para>
  27392. </exception>
  27393. </member>
  27394. <member name="M:MailKit.Security.SaslMechanismPlain.#ctor(System.Uri,System.Text.Encoding,System.String,System.String)">
  27395. <summary>
  27396. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismPlain"/> class.
  27397. </summary>
  27398. <remarks>
  27399. Creates a new PLAIN SASL context.
  27400. </remarks>
  27401. <param name="uri">The URI of the service.</param>
  27402. <param name="encoding">The encoding to use for the user's credentials.</param>
  27403. <param name="userName">The user name.</param>
  27404. <param name="password">The password.</param>
  27405. <exception cref="T:System.ArgumentNullException">
  27406. <para><paramref name="uri"/> is <c>null</c>.</para>
  27407. <para>-or-</para>
  27408. <para><paramref name="encoding"/> is <c>null</c>.</para>
  27409. <para>-or-</para>
  27410. <para><paramref name="userName"/> is <c>null</c>.</para>
  27411. <para>-or-</para>
  27412. <para><paramref name="password"/> is <c>null</c>.</para>
  27413. </exception>
  27414. </member>
  27415. <member name="M:MailKit.Security.SaslMechanismPlain.#ctor(System.Uri,System.Net.ICredentials)">
  27416. <summary>
  27417. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismPlain"/> class.
  27418. </summary>
  27419. <remarks>
  27420. Creates a new PLAIN SASL context.
  27421. </remarks>
  27422. <param name="uri">The URI of the service.</param>
  27423. <param name="credentials">The user's credentials.</param>
  27424. <exception cref="T:System.ArgumentNullException">
  27425. <para><paramref name="uri"/> is <c>null</c>.</para>
  27426. <para>-or-</para>
  27427. <para><paramref name="credentials"/> is <c>null</c>.</para>
  27428. </exception>
  27429. </member>
  27430. <member name="M:MailKit.Security.SaslMechanismPlain.#ctor(System.Uri,System.String,System.String)">
  27431. <summary>
  27432. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismPlain"/> class.
  27433. </summary>
  27434. <remarks>
  27435. Creates a new PLAIN SASL context.
  27436. </remarks>
  27437. <param name="uri">The URI of the service.</param>
  27438. <param name="userName">The user name.</param>
  27439. <param name="password">The password.</param>
  27440. <exception cref="T:System.ArgumentNullException">
  27441. <para><paramref name="uri"/> is <c>null</c>.</para>
  27442. <para>-or-</para>
  27443. <para><paramref name="userName"/> is <c>null</c>.</para>
  27444. <para>-or-</para>
  27445. <para><paramref name="password"/> is <c>null</c>.</para>
  27446. </exception>
  27447. </member>
  27448. <member name="M:MailKit.Security.SaslMechanismPlain.#ctor(System.Text.Encoding,System.Net.NetworkCredential)">
  27449. <summary>
  27450. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismPlain"/> class.
  27451. </summary>
  27452. <remarks>
  27453. Creates a new PLAIN SASL context.
  27454. </remarks>
  27455. <param name="encoding">The encoding to use for the user's credentials.</param>
  27456. <param name="credentials">The user's credentials.</param>
  27457. <exception cref="T:System.ArgumentNullException">
  27458. <para><paramref name="encoding"/> is <c>null</c>.</para>
  27459. <para>-or-</para>
  27460. <para><paramref name="credentials"/> is <c>null</c>.</para>
  27461. </exception>
  27462. </member>
  27463. <member name="M:MailKit.Security.SaslMechanismPlain.#ctor(System.Text.Encoding,System.String,System.String)">
  27464. <summary>
  27465. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismPlain"/> class.
  27466. </summary>
  27467. <remarks>
  27468. Creates a new PLAIN SASL context.
  27469. </remarks>
  27470. <param name="encoding">The encoding to use for the user's credentials.</param>
  27471. <param name="userName">The user name.</param>
  27472. <param name="password">The password.</param>
  27473. <exception cref="T:System.ArgumentNullException">
  27474. <para><paramref name="encoding"/> is <c>null</c>.</para>
  27475. <para>-or-</para>
  27476. <para><paramref name="userName"/> is <c>null</c>.</para>
  27477. <para>-or-</para>
  27478. <para><paramref name="password"/> is <c>null</c>.</para>
  27479. </exception>
  27480. </member>
  27481. <member name="M:MailKit.Security.SaslMechanismPlain.#ctor(System.Net.NetworkCredential)">
  27482. <summary>
  27483. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismPlain"/> class.
  27484. </summary>
  27485. <remarks>
  27486. Creates a new PLAIN SASL context.
  27487. </remarks>
  27488. <param name="credentials">The user's credentials.</param>
  27489. <exception cref="T:System.ArgumentNullException">
  27490. <paramref name="credentials"/> is <c>null</c>.
  27491. </exception>
  27492. </member>
  27493. <member name="M:MailKit.Security.SaslMechanismPlain.#ctor(System.String,System.String)">
  27494. <summary>
  27495. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismPlain"/> class.
  27496. </summary>
  27497. <remarks>
  27498. Creates a new PLAIN SASL context.
  27499. </remarks>
  27500. <param name="userName">The user name.</param>
  27501. <param name="password">The password.</param>
  27502. <exception cref="T:System.ArgumentNullException">
  27503. <para><paramref name="userName"/> is <c>null</c>.</para>
  27504. <para>-or-</para>
  27505. <para><paramref name="password"/> is <c>null</c>.</para>
  27506. </exception>
  27507. </member>
  27508. <member name="P:MailKit.Security.SaslMechanismPlain.AuthorizationId">
  27509. <summary>
  27510. Gets or sets the authorization identifier.
  27511. </summary>
  27512. <remarks>
  27513. The authorization identifier is the desired user account that the server should use
  27514. for all accesses. This is separate from the user name used for authentication.
  27515. </remarks>
  27516. <value>The authorization identifier.</value>
  27517. </member>
  27518. <member name="P:MailKit.Security.SaslMechanismPlain.MechanismName">
  27519. <summary>
  27520. Gets the name of the mechanism.
  27521. </summary>
  27522. <remarks>
  27523. Gets the name of the mechanism.
  27524. </remarks>
  27525. <value>The name of the mechanism.</value>
  27526. </member>
  27527. <member name="P:MailKit.Security.SaslMechanismPlain.SupportsInitialResponse">
  27528. <summary>
  27529. Gets whether or not the mechanism supports an initial response (SASL-IR).
  27530. </summary>
  27531. <remarks>
  27532. SASL mechanisms that support sending an initial client response to the server
  27533. should return <value>true</value>.
  27534. </remarks>
  27535. <value><c>true</c> if the mechanism supports an initial response; otherwise, <c>false</c>.</value>
  27536. </member>
  27537. <member name="M:MailKit.Security.SaslMechanismPlain.Challenge(System.Byte[],System.Int32,System.Int32)">
  27538. <summary>
  27539. Parses the server's challenge token and returns the next challenge response.
  27540. </summary>
  27541. <remarks>
  27542. Parses the server's challenge token and returns the next challenge response.
  27543. </remarks>
  27544. <returns>The next challenge response.</returns>
  27545. <param name="token">The server's challenge token.</param>
  27546. <param name="startIndex">The index into the token specifying where the server's challenge begins.</param>
  27547. <param name="length">The length of the server's challenge.</param>
  27548. <exception cref="T:System.InvalidOperationException">
  27549. The SASL mechanism is already authenticated.
  27550. </exception>
  27551. <exception cref="T:MailKit.Security.SaslException">
  27552. An error has occurred while parsing the server's challenge token.
  27553. </exception>
  27554. </member>
  27555. <member name="T:MailKit.Security.SaslMechanismScramBase">
  27556. <summary>
  27557. The base class for SCRAM-based SASL mechanisms.
  27558. </summary>
  27559. <remarks>
  27560. SCRAM-based SASL mechanisms are salted challenge/response authentication mechanisms.
  27561. </remarks>
  27562. </member>
  27563. <member name="M:MailKit.Security.SaslMechanismScramBase.#ctor(System.Uri,System.Net.ICredentials)">
  27564. <summary>
  27565. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismScramBase"/> class.
  27566. </summary>
  27567. <remarks>
  27568. Creates a new SCRAM-based SASL context.
  27569. </remarks>
  27570. <param name="uri">The URI of the service.</param>
  27571. <param name="credentials">The user's credentials.</param>
  27572. <exception cref="T:System.ArgumentNullException">
  27573. <para><paramref name="uri"/> is <c>null</c>.</para>
  27574. <para>-or-</para>
  27575. <para><paramref name="credentials"/> is <c>null</c>.</para>
  27576. </exception>
  27577. </member>
  27578. <member name="M:MailKit.Security.SaslMechanismScramBase.#ctor(System.Uri,System.String,System.String)">
  27579. <summary>
  27580. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismScramBase"/> class.
  27581. </summary>
  27582. <remarks>
  27583. Creates a new SCRAM-based SASL context.
  27584. </remarks>
  27585. <param name="uri">The URI of the service.</param>
  27586. <param name="userName">The user name.</param>
  27587. <param name="password">The password.</param>
  27588. <exception cref="T:System.ArgumentNullException">
  27589. <para><paramref name="uri"/> is <c>null</c>.</para>
  27590. <para>-or-</para>
  27591. <para><paramref name="userName"/> is <c>null</c>.</para>
  27592. <para>-or-</para>
  27593. <para><paramref name="password"/> is <c>null</c>.</para>
  27594. </exception>
  27595. </member>
  27596. <member name="M:MailKit.Security.SaslMechanismScramBase.#ctor(System.Net.NetworkCredential)">
  27597. <summary>
  27598. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismScramBase"/> class.
  27599. </summary>
  27600. <remarks>
  27601. Creates a new SCRAM-based SASL context.
  27602. </remarks>
  27603. <param name="credentials">The user's credentials.</param>
  27604. <exception cref="T:System.ArgumentNullException">
  27605. <paramref name="credentials"/> is <c>null</c>.
  27606. </exception>
  27607. </member>
  27608. <member name="M:MailKit.Security.SaslMechanismScramBase.#ctor(System.String,System.String)">
  27609. <summary>
  27610. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismScramBase"/> class.
  27611. </summary>
  27612. <remarks>
  27613. Creates a new SCRAM-based SASL context.
  27614. </remarks>
  27615. <param name="userName">The user name.</param>
  27616. <param name="password">The password.</param>
  27617. <exception cref="T:System.ArgumentNullException">
  27618. <para><paramref name="userName"/> is <c>null</c>.</para>
  27619. <para>-or-</para>
  27620. <para><paramref name="password"/> is <c>null</c>.</para>
  27621. </exception>
  27622. </member>
  27623. <member name="P:MailKit.Security.SaslMechanismScramBase.SupportsInitialResponse">
  27624. <summary>
  27625. Gets whether or not the mechanism supports an initial response (SASL-IR).
  27626. </summary>
  27627. <remarks>
  27628. SASL mechanisms that support sending an initial client response to the server
  27629. should return <value>true</value>.
  27630. </remarks>
  27631. <value><c>true</c> if the mechanism supports an initial response; otherwise, <c>false</c>.</value>
  27632. </member>
  27633. <member name="M:MailKit.Security.SaslMechanismScramBase.CreateHMAC(System.Byte[])">
  27634. <summary>
  27635. Create the HMAC context.
  27636. </summary>
  27637. <remarks>
  27638. Creates the HMAC context using the secret key.
  27639. </remarks>
  27640. <returns>The HMAC context.</returns>
  27641. <param name="key">The secret key.</param>
  27642. </member>
  27643. <member name="M:MailKit.Security.SaslMechanismScramBase.HMAC(System.Byte[],System.Byte[])">
  27644. <summary>
  27645. Apply the HMAC keyed algorithm.
  27646. </summary>
  27647. <remarks>
  27648. HMAC(key, str): Apply the HMAC keyed hash algorithm (defined in
  27649. [RFC2104]) using the octet string represented by "key" as the key
  27650. and the octet string "str" as the input string. The size of the
  27651. result is the hash result size for the hash function in use. For
  27652. example, it is 20 octets for SHA-1 (see [RFC3174]).
  27653. </remarks>
  27654. <returns>The results of the HMAC keyed algorithm.</returns>
  27655. <param name="key">The key.</param>
  27656. <param name="str">The string.</param>
  27657. </member>
  27658. <member name="M:MailKit.Security.SaslMechanismScramBase.Hash(System.Byte[])">
  27659. <summary>
  27660. Apply the cryptographic hash function.
  27661. </summary>
  27662. <remarks>
  27663. H(str): Apply the cryptographic hash function to the octet string
  27664. "str", producing an octet string as a result. The size of the
  27665. result depends on the hash result size for the hash function in
  27666. use.
  27667. </remarks>
  27668. <returns>The results of the hash.</returns>
  27669. <param name="str">The string.</param>
  27670. </member>
  27671. <member name="M:MailKit.Security.SaslMechanismScramBase.Xor(System.Byte[],System.Byte[])">
  27672. <summary>
  27673. Apply the exclusive-or operation to combine two octet strings.
  27674. </summary>
  27675. <remarks>
  27676. Apply the exclusive-or operation to combine the octet string
  27677. on the left of this operator with the octet string on the right of
  27678. this operator. The length of the output and each of the two
  27679. inputs will be the same for this use.
  27680. </remarks>
  27681. <param name="a">The alpha component.</param>
  27682. <param name="b">The blue component.</param>
  27683. </member>
  27684. <member name="M:MailKit.Security.SaslMechanismScramBase.Challenge(System.Byte[],System.Int32,System.Int32)">
  27685. <summary>
  27686. Parses the server's challenge token and returns the next challenge response.
  27687. </summary>
  27688. <remarks>
  27689. Parses the server's challenge token and returns the next challenge response.
  27690. </remarks>
  27691. <returns>The next challenge response.</returns>
  27692. <param name="token">The server's challenge token.</param>
  27693. <param name="startIndex">The index into the token specifying where the server's challenge begins.</param>
  27694. <param name="length">The length of the server's challenge.</param>
  27695. <exception cref="T:System.InvalidOperationException">
  27696. The SASL mechanism is already authenticated.
  27697. </exception>
  27698. <exception cref="T:MailKit.Security.SaslException">
  27699. An error has occurred while parsing the server's challenge token.
  27700. </exception>
  27701. </member>
  27702. <member name="M:MailKit.Security.SaslMechanismScramBase.Reset">
  27703. <summary>
  27704. Resets the state of the SASL mechanism.
  27705. </summary>
  27706. <remarks>
  27707. Resets the state of the SASL mechanism.
  27708. </remarks>
  27709. </member>
  27710. <member name="T:MailKit.Security.SaslMechanismScramSha1">
  27711. <summary>
  27712. The SCRAM-SHA-1 SASL mechanism.
  27713. </summary>
  27714. <remarks>
  27715. A salted challenge/response SASL mechanism that uses the HMAC SHA-1 algorithm.
  27716. </remarks>
  27717. </member>
  27718. <member name="M:MailKit.Security.SaslMechanismScramSha1.#ctor(System.Uri,System.Net.ICredentials)">
  27719. <summary>
  27720. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismScramSha1"/> class.
  27721. </summary>
  27722. <remarks>
  27723. Creates a new SCRAM-SHA-1 SASL context.
  27724. </remarks>
  27725. <param name="uri">The URI of the service.</param>
  27726. <param name="credentials">The user's credentials.</param>
  27727. <exception cref="T:System.ArgumentNullException">
  27728. <para><paramref name="uri"/> is <c>null</c>.</para>
  27729. <para>-or-</para>
  27730. <para><paramref name="credentials"/> is <c>null</c>.</para>
  27731. </exception>
  27732. </member>
  27733. <member name="M:MailKit.Security.SaslMechanismScramSha1.#ctor(System.Uri,System.String,System.String)">
  27734. <summary>
  27735. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismScramSha1"/> class.
  27736. </summary>
  27737. <remarks>
  27738. Creates a new SCRAM-SHA-1 SASL context.
  27739. </remarks>
  27740. <param name="uri">The URI of the service.</param>
  27741. <param name="userName">The user name.</param>
  27742. <param name="password">The password.</param>
  27743. <exception cref="T:System.ArgumentNullException">
  27744. <para><paramref name="uri"/> is <c>null</c>.</para>
  27745. <para>-or-</para>
  27746. <para><paramref name="userName"/> is <c>null</c>.</para>
  27747. <para>-or-</para>
  27748. <para><paramref name="password"/> is <c>null</c>.</para>
  27749. </exception>
  27750. </member>
  27751. <member name="M:MailKit.Security.SaslMechanismScramSha1.#ctor(System.Net.NetworkCredential)">
  27752. <summary>
  27753. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismScramSha1"/> class.
  27754. </summary>
  27755. <remarks>
  27756. Creates a new SCRAM-SHA-1 SASL context.
  27757. </remarks>
  27758. <param name="credentials">The user's credentials.</param>
  27759. <exception cref="T:System.ArgumentNullException">
  27760. <paramref name="credentials"/> is <c>null</c>.
  27761. </exception>
  27762. </member>
  27763. <member name="M:MailKit.Security.SaslMechanismScramSha1.#ctor(System.String,System.String)">
  27764. <summary>
  27765. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismScramSha1"/> class.
  27766. </summary>
  27767. <remarks>
  27768. Creates a new SCRAM-SHA-1 SASL context.
  27769. </remarks>
  27770. <param name="userName">The user name.</param>
  27771. <param name="password">The password.</param>
  27772. <exception cref="T:System.ArgumentNullException">
  27773. <para><paramref name="userName"/> is <c>null</c>.</para>
  27774. <para>-or-</para>
  27775. <para><paramref name="password"/> is <c>null</c>.</para>
  27776. </exception>
  27777. </member>
  27778. <member name="P:MailKit.Security.SaslMechanismScramSha1.MechanismName">
  27779. <summary>
  27780. Gets the name of the mechanism.
  27781. </summary>
  27782. <remarks>
  27783. Gets the name of the mechanism.
  27784. </remarks>
  27785. <value>The name of the mechanism.</value>
  27786. </member>
  27787. <member name="M:MailKit.Security.SaslMechanismScramSha1.CreateHMAC(System.Byte[])">
  27788. <summary>
  27789. Create the HMAC context.
  27790. </summary>
  27791. <remarks>
  27792. Creates the HMAC context using the secret key.
  27793. </remarks>
  27794. <returns>The HMAC context.</returns>
  27795. <param name="key">The secret key.</param>
  27796. </member>
  27797. <member name="M:MailKit.Security.SaslMechanismScramSha1.Hash(System.Byte[])">
  27798. <summary>
  27799. Apply the cryptographic hash function.
  27800. </summary>
  27801. <remarks>
  27802. H(str): Apply the cryptographic hash function to the octet string
  27803. "str", producing an octet string as a result. The size of the
  27804. result depends on the hash result size for the hash function in
  27805. use.
  27806. </remarks>
  27807. <returns>The results of the hash.</returns>
  27808. <param name="str">The string.</param>
  27809. </member>
  27810. <member name="T:MailKit.Security.SaslMechanismScramSha256">
  27811. <summary>
  27812. The SCRAM-SHA-256 SASL mechanism.
  27813. </summary>
  27814. <remarks>
  27815. A salted challenge/response SASL mechanism that uses the HMAC SHA-256 algorithm.
  27816. </remarks>
  27817. </member>
  27818. <member name="M:MailKit.Security.SaslMechanismScramSha256.#ctor(System.Uri,System.Net.ICredentials)">
  27819. <summary>
  27820. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismScramSha256"/> class.
  27821. </summary>
  27822. <remarks>
  27823. Creates a new SCRAM-SHA-256 SASL context.
  27824. </remarks>
  27825. <param name="uri">The URI of the service.</param>
  27826. <param name="credentials">The user's credentials.</param>
  27827. <exception cref="T:System.ArgumentNullException">
  27828. <para><paramref name="uri"/> is <c>null</c>.</para>
  27829. <para>-or-</para>
  27830. <para><paramref name="credentials"/> is <c>null</c>.</para>
  27831. </exception>
  27832. </member>
  27833. <member name="M:MailKit.Security.SaslMechanismScramSha256.#ctor(System.Uri,System.String,System.String)">
  27834. <summary>
  27835. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismScramSha256"/> class.
  27836. </summary>
  27837. <remarks>
  27838. Creates a new SCRAM-SHA-256 SASL context.
  27839. </remarks>
  27840. <param name="uri">The URI of the service.</param>
  27841. <param name="userName">The user name.</param>
  27842. <param name="password">The password.</param>
  27843. <exception cref="T:System.ArgumentNullException">
  27844. <para><paramref name="uri"/> is <c>null</c>.</para>
  27845. <para>-or-</para>
  27846. <para><paramref name="userName"/> is <c>null</c>.</para>
  27847. <para>-or-</para>
  27848. <para><paramref name="password"/> is <c>null</c>.</para>
  27849. </exception>
  27850. </member>
  27851. <member name="M:MailKit.Security.SaslMechanismScramSha256.#ctor(System.Net.NetworkCredential)">
  27852. <summary>
  27853. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismScramSha256"/> class.
  27854. </summary>
  27855. <remarks>
  27856. Creates a new SCRAM-SHA-256 SASL context.
  27857. </remarks>
  27858. <param name="credentials">The user's credentials.</param>
  27859. <exception cref="T:System.ArgumentNullException">
  27860. <paramref name="credentials"/> is <c>null</c>.
  27861. </exception>
  27862. </member>
  27863. <member name="M:MailKit.Security.SaslMechanismScramSha256.#ctor(System.String,System.String)">
  27864. <summary>
  27865. Initializes a new instance of the <see cref="T:MailKit.Security.SaslMechanismScramSha256"/> class.
  27866. </summary>
  27867. <remarks>
  27868. Creates a new SCRAM-SHA-256 SASL context.
  27869. </remarks>
  27870. <param name="userName">The user name.</param>
  27871. <param name="password">The password.</param>
  27872. <exception cref="T:System.ArgumentNullException">
  27873. <para><paramref name="userName"/> is <c>null</c>.</para>
  27874. <para>-or-</para>
  27875. <para><paramref name="password"/> is <c>null</c>.</para>
  27876. </exception>
  27877. </member>
  27878. <member name="P:MailKit.Security.SaslMechanismScramSha256.MechanismName">
  27879. <summary>
  27880. Gets the name of the mechanism.
  27881. </summary>
  27882. <remarks>
  27883. Gets the name of the mechanism.
  27884. </remarks>
  27885. <value>The name of the mechanism.</value>
  27886. </member>
  27887. <member name="M:MailKit.Security.SaslMechanismScramSha256.CreateHMAC(System.Byte[])">
  27888. <summary>
  27889. Create the HMAC context.
  27890. </summary>
  27891. <remarks>
  27892. Creates the HMAC context using the secret key.
  27893. </remarks>
  27894. <returns>The HMAC context.</returns>
  27895. <param name="key">The secret key.</param>
  27896. </member>
  27897. <member name="M:MailKit.Security.SaslMechanismScramSha256.Hash(System.Byte[])">
  27898. <summary>
  27899. Apply the cryptographic hash function.
  27900. </summary>
  27901. <remarks>
  27902. H(str): Apply the cryptographic hash function to the octet string
  27903. "str", producing an octet string as a result. The size of the
  27904. result depends on the hash result size for the hash function in
  27905. use.
  27906. </remarks>
  27907. <returns>The results of the hash.</returns>
  27908. <param name="str">The string.</param>
  27909. </member>
  27910. <member name="T:MailKit.Security.SecureSocketOptions">
  27911. <summary>
  27912. Secure socket options.
  27913. </summary>
  27914. <remarks>
  27915. Provides a way of specifying the SSL and/or TLS encryption that
  27916. should be used for a connection.
  27917. </remarks>
  27918. </member>
  27919. <member name="F:MailKit.Security.SecureSocketOptions.None">
  27920. <summary>
  27921. No SSL or TLS encryption should be used.
  27922. </summary>
  27923. </member>
  27924. <member name="F:MailKit.Security.SecureSocketOptions.Auto">
  27925. <summary>
  27926. Allow the <see cref="T:MailKit.IMailService"/> to decide which SSL or TLS
  27927. options to use (default). If the server does not support SSL or TLS,
  27928. then the connection will continue without any encryption.
  27929. </summary>
  27930. </member>
  27931. <member name="F:MailKit.Security.SecureSocketOptions.SslOnConnect">
  27932. <summary>
  27933. The connection should use SSL or TLS encryption immediately.
  27934. </summary>
  27935. </member>
  27936. <member name="F:MailKit.Security.SecureSocketOptions.StartTls">
  27937. <summary>
  27938. Elevates the connection to use TLS encryption immediately after
  27939. reading the greeting and capabilities of the server. If the server
  27940. does not support the STARTTLS extension, then the connection will
  27941. fail and a <see cref="T:System.NotSupportedException"/> will be thrown.
  27942. </summary>
  27943. </member>
  27944. <member name="F:MailKit.Security.SecureSocketOptions.StartTlsWhenAvailable">
  27945. <summary>
  27946. Elevates the connection to use TLS encryption immediately after
  27947. reading the greeting and capabilities of the server, but only if
  27948. the server supports the STARTTLS extension.
  27949. </summary>
  27950. </member>
  27951. <member name="T:MailKit.Security.SslHandshakeException">
  27952. <summary>
  27953. The exception that is thrown when there is an error during the SSL/TLS handshake.
  27954. </summary>
  27955. <remarks>
  27956. <para>The exception that is thrown when there is an error during the SSL/TLS handshake.</para>
  27957. <para>When this exception occurrs, it typically means that the IMAP, POP3 or SMTP server that
  27958. you are connecting to is using an SSL certificate that is either expired or untrusted by
  27959. your system.</para>
  27960. <para>Often times, mail servers will use self-signed certificates instead of using a certificate
  27961. that has been signed by a trusted Certificate Authority. When your system is unable to validate
  27962. the mail server's certificate because it is not signed by a known and trusted Certificate Authority,
  27963. this exception will occur.</para>
  27964. <para>You can work around this problem by supplying a custom <see cref="T:System.Net.Security.RemoteCertificateValidationCallback"/>
  27965. and setting it on the client's <see cref="P:MailKit.MailService.ServerCertificateValidationCallback"/> property.</para>
  27966. <para>Most likely, you'll want to compare the thumbprint of the server's certificate with a known
  27967. value and/or prompt the user to accept the certificate (similar to what you've probably seen web
  27968. browsers do when they encounter untrusted certificates).</para>
  27969. </remarks>
  27970. </member>
  27971. <member name="M:MailKit.Security.SslHandshakeException.#ctor(System.String,System.Exception)">
  27972. <summary>
  27973. Initializes a new instance of the <see cref="T:MailKit.Security.SslHandshakeException"/> class.
  27974. </summary>
  27975. <remarks>
  27976. Creates a new <see cref="T:MailKit.Security.SslHandshakeException"/>.
  27977. </remarks>
  27978. <param name="message">The error message.</param>
  27979. <param name="innerException">An inner exception.</param>
  27980. </member>
  27981. <member name="M:MailKit.Security.SslHandshakeException.#ctor(System.String)">
  27982. <summary>
  27983. Initializes a new instance of the <see cref="T:MailKit.Security.SslHandshakeException"/> class.
  27984. </summary>
  27985. <remarks>
  27986. Creates a new <see cref="T:MailKit.Security.SslHandshakeException"/>.
  27987. </remarks>
  27988. <param name="message">The error message.</param>
  27989. </member>
  27990. <member name="M:MailKit.Security.SslHandshakeException.#ctor">
  27991. <summary>
  27992. Initializes a new instance of the <see cref="T:MailKit.Security.SslHandshakeException"/> class.
  27993. </summary>
  27994. <remarks>
  27995. Creates a new <see cref="T:MailKit.Security.SslHandshakeException"/>.
  27996. </remarks>
  27997. </member>
  27998. <member name="P:MailKit.Security.SslHandshakeException.ServerCertificate">
  27999. <summary>
  28000. Get the server's SSL certificate.
  28001. </summary>
  28002. <remarks>
  28003. Gets the server's SSL certificate, if it is available.
  28004. </remarks>
  28005. <value>The server's SSL certificate.</value>
  28006. </member>
  28007. <member name="P:MailKit.Security.SslHandshakeException.RootCertificateAuthority">
  28008. <summary>
  28009. Get the certificate for the Root Certificate Authority.
  28010. </summary>
  28011. <remarks>
  28012. Gets the certificate for the Root Certificate Authority, if it is available.
  28013. </remarks>
  28014. <value>The Root Certificate Authority certificate.</value>
  28015. </member>
  28016. <member name="T:MailKit.AccessControl">
  28017. <summary>
  28018. An Access Control.
  28019. </summary>
  28020. <remarks>
  28021. An Access Control is a set of permissions available for a particular identity,
  28022. controlling whether or not that identity has the ability to perform various tasks.
  28023. </remarks>
  28024. <example>
  28025. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  28026. </example>
  28027. </member>
  28028. <member name="M:MailKit.AccessControl.#ctor(System.String,System.Collections.Generic.IEnumerable{MailKit.AccessRight})">
  28029. <summary>
  28030. Initializes a new instance of the <see cref="T:MailKit.AccessControl"/> class.
  28031. </summary>
  28032. <remarks>
  28033. Creates a new <see cref="T:MailKit.AccessControl"/> with the given name and
  28034. access rights.
  28035. </remarks>
  28036. <param name="name">The identifier name.</param>
  28037. <param name="rights">The access rights.</param>
  28038. <exception cref="T:System.ArgumentNullException">
  28039. <para><paramref name="name"/> is <c>null</c>.</para>
  28040. <para>-or-</para>
  28041. <para><paramref name="rights"/> is <c>null</c>.</para>
  28042. </exception>
  28043. </member>
  28044. <member name="M:MailKit.AccessControl.#ctor(System.String,System.String)">
  28045. <summary>
  28046. Initializes a new instance of the <see cref="T:MailKit.AccessControl"/> class.
  28047. </summary>
  28048. <remarks>
  28049. Creates a new <see cref="T:MailKit.AccessControl"/> with the given name and
  28050. access rights.
  28051. </remarks>
  28052. <param name="name">The identifier name.</param>
  28053. <param name="rights">The access rights.</param>
  28054. <exception cref="T:System.ArgumentNullException">
  28055. <para><paramref name="name"/> is <c>null</c>.</para>
  28056. <para>-or-</para>
  28057. <para><paramref name="rights"/> is <c>null</c>.</para>
  28058. </exception>
  28059. </member>
  28060. <member name="M:MailKit.AccessControl.#ctor(System.String)">
  28061. <summary>
  28062. Initializes a new instance of the <see cref="T:MailKit.AccessControl"/> class.
  28063. </summary>
  28064. <remarks>
  28065. Creates a new <see cref="T:MailKit.AccessControl"/> with the given name and no
  28066. access rights.
  28067. </remarks>
  28068. <param name="name">The identifier name.</param>
  28069. <exception cref="T:System.ArgumentNullException">
  28070. <paramref name="name"/> is <c>null</c>.
  28071. </exception>
  28072. </member>
  28073. <member name="P:MailKit.AccessControl.Name">
  28074. <summary>
  28075. The identifier name for the access control.
  28076. </summary>
  28077. <remarks>
  28078. The identifier name for the access control.
  28079. </remarks>
  28080. <example>
  28081. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  28082. </example>
  28083. <value>The identifier name.</value>
  28084. </member>
  28085. <member name="P:MailKit.AccessControl.Rights">
  28086. <summary>
  28087. Get the access rights.
  28088. </summary>
  28089. <remarks>
  28090. Gets the access rights.
  28091. </remarks>
  28092. <example>
  28093. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  28094. </example>
  28095. <value>The access rights.</value>
  28096. </member>
  28097. <member name="T:MailKit.AccessControlList">
  28098. <summary>
  28099. An Access Control List (ACL)
  28100. </summary>
  28101. <remarks>
  28102. An Access Control List (ACL) is a list of access controls defining the permissions
  28103. various identities have available.
  28104. </remarks>
  28105. <example>
  28106. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  28107. </example>
  28108. </member>
  28109. <member name="M:MailKit.AccessControlList.#ctor(System.Collections.Generic.IEnumerable{MailKit.AccessControl})">
  28110. <summary>
  28111. Initializes a new instance of the <see cref="T:MailKit.AccessControlList"/> class.
  28112. </summary>
  28113. <remarks>
  28114. Creates a new <see cref="T:MailKit.AccessControlList"/>.
  28115. </remarks>
  28116. <param name="controls">The list of access controls.</param>
  28117. <exception cref="T:System.ArgumentNullException">
  28118. <paramref name="controls"/> is <c>null</c>.
  28119. </exception>
  28120. </member>
  28121. <member name="M:MailKit.AccessControlList.#ctor">
  28122. <summary>
  28123. Initializes a new instance of the <see cref="T:MailKit.AccessControlList"/> class.
  28124. </summary>
  28125. <remarks>
  28126. Creates a new <see cref="T:MailKit.AccessControlList"/>.
  28127. </remarks>
  28128. </member>
  28129. <member name="T:MailKit.AccessRight">
  28130. <summary>
  28131. An individual Access Right to be used with ACLs.
  28132. </summary>
  28133. <remarks>
  28134. <para>An individual Access Right meant to be used with
  28135. <see cref="T:MailKit.AccessControlList"/>.</para>
  28136. <para>For more information on what rights are available,
  28137. see https://tools.ietf.org/html/rfc4314#section-2.1
  28138. </para>
  28139. </remarks>
  28140. </member>
  28141. <member name="F:MailKit.AccessRight.LookupFolder">
  28142. <summary>
  28143. The access right for folder lookups.
  28144. </summary>
  28145. <remarks>
  28146. Allows the <see cref="T:MailKit.IMailFolder"/> to be visible when listing folders.
  28147. </remarks>
  28148. </member>
  28149. <member name="F:MailKit.AccessRight.OpenFolder">
  28150. <summary>
  28151. The access right for opening a folder and getting the status.
  28152. </summary>
  28153. <remarks>
  28154. Provides access for opening and getting the status of the folder.
  28155. </remarks>
  28156. </member>
  28157. <member name="F:MailKit.AccessRight.SetMessageSeen">
  28158. <summary>
  28159. The access right for adding or removing the Seen flag on messages in the folder.
  28160. </summary>
  28161. <remarks>
  28162. Provides access to add or remove the <see cref="F:MailKit.MessageFlags.Seen"/> flag on messages within the
  28163. <see cref="T:MailKit.IMailFolder"/>.
  28164. </remarks>
  28165. </member>
  28166. <member name="F:MailKit.AccessRight.SetMessageFlags">
  28167. <summary>
  28168. The access right for adding or removing flags (other than Seen and Deleted)
  28169. on messages in a folder.
  28170. </summary>
  28171. <remarks>
  28172. Provides access to add or remove the <see cref="T:MailKit.MessageFlags"/> on messages
  28173. (other than <see cref="F:MailKit.MessageFlags.Seen"/> and
  28174. <see cref="F:MailKit.MessageFlags.Deleted"/>) within the folder.
  28175. </remarks>
  28176. </member>
  28177. <member name="F:MailKit.AccessRight.AppendMessages">
  28178. <summary>
  28179. The access right allowing messages to be appended or copied into the folder.
  28180. </summary>
  28181. <remarks>
  28182. Provides access to append or copy messages into the folder.
  28183. </remarks>
  28184. </member>
  28185. <member name="F:MailKit.AccessRight.CreateFolder">
  28186. <summary>
  28187. The access right allowing subfolders to be created.
  28188. </summary>
  28189. <remarks>
  28190. Provides access to create subfolders.
  28191. </remarks>
  28192. </member>
  28193. <member name="F:MailKit.AccessRight.DeleteFolder">
  28194. <summary>
  28195. The access right for deleting a folder and/or its subfolders.
  28196. </summary>
  28197. <remarks>
  28198. Provides access to delete the folder and/or any subfolders.
  28199. </remarks>
  28200. </member>
  28201. <member name="F:MailKit.AccessRight.SetMessageDeleted">
  28202. <summary>
  28203. The access right for adding or removing the Deleted flag to messages within a folder.
  28204. </summary>
  28205. <remarks>
  28206. Provides access to add or remove the <see cref="F:MailKit.MessageFlags.Deleted"/> flag from
  28207. messages within the folder. It also provides access for setting the
  28208. <see cref="F:MailKit.MessageFlags.Deleted"/> flag when appending a message to a folder.
  28209. </remarks>
  28210. </member>
  28211. <member name="F:MailKit.AccessRight.ExpungeFolder">
  28212. <summary>
  28213. The access right for expunging deleted messages in a folder.
  28214. </summary>
  28215. <remarks>
  28216. Provides access to expunge deleted messages in a folder.
  28217. </remarks>
  28218. </member>
  28219. <member name="F:MailKit.AccessRight.Administer">
  28220. <summary>
  28221. The access right for administering the ACLs of a folder.
  28222. </summary>
  28223. <remarks>
  28224. Provides administrative access to change the ACLs for the folder.
  28225. </remarks>
  28226. </member>
  28227. <member name="F:MailKit.AccessRight.Right">
  28228. <summary>
  28229. The character representing the particular access right.
  28230. </summary>
  28231. <remarks>
  28232. Represents the character value of the access right.
  28233. </remarks>
  28234. </member>
  28235. <member name="M:MailKit.AccessRight.#ctor(System.Char)">
  28236. <summary>
  28237. Initializes a new instance of the <see cref="T:MailKit.AccessRight"/> struct.
  28238. </summary>
  28239. <remarks>
  28240. Creates a new <see cref="T:MailKit.AccessRight"/> struct.
  28241. </remarks>
  28242. <param name="right">The access right.</param>
  28243. </member>
  28244. <member name="M:MailKit.AccessRight.Equals(MailKit.AccessRight)">
  28245. <summary>
  28246. Determines whether the specified <see cref="T:MailKit.AccessRight"/> is equal to the current <see cref="T:MailKit.AccessRight"/>.
  28247. </summary>
  28248. <remarks>
  28249. Determines whether the specified <see cref="T:MailKit.AccessRight"/> is equal to the current <see cref="T:MailKit.AccessRight"/>.
  28250. </remarks>
  28251. <param name="other">The <see cref="T:MailKit.AccessRight"/> to compare with the current <see cref="T:MailKit.AccessRight"/>.</param>
  28252. <returns><c>true</c> if the specified <see cref="T:MailKit.AccessRight"/> is equal to the current
  28253. <see cref="T:MailKit.AccessRight"/>; otherwise, <c>false</c>.</returns>
  28254. </member>
  28255. <member name="M:MailKit.AccessRight.op_Equality(MailKit.AccessRight,MailKit.AccessRight)">
  28256. <summary>
  28257. Determines whether two access rights are equal.
  28258. </summary>
  28259. <remarks>
  28260. Determines whether two access rights are equal.
  28261. </remarks>
  28262. <returns><c>true</c> if <paramref name="right1"/> and <paramref name="right2"/> are equal; otherwise, <c>false</c>.</returns>
  28263. <param name="right1">The first access right to compare.</param>
  28264. <param name="right2">The second access right to compare.</param>
  28265. </member>
  28266. <member name="M:MailKit.AccessRight.op_Inequality(MailKit.AccessRight,MailKit.AccessRight)">
  28267. <summary>
  28268. Determines whether two access rights are not equal.
  28269. </summary>
  28270. <remarks>
  28271. Determines whether two access rights are not equal.
  28272. </remarks>
  28273. <returns><c>true</c> if <paramref name="right1"/> and <paramref name="right2"/> are not equal; otherwise, <c>false</c>.</returns>
  28274. <param name="right1">The first access right to compare.</param>
  28275. <param name="right2">The second access right to compare.</param>
  28276. </member>
  28277. <member name="M:MailKit.AccessRight.Equals(System.Object)">
  28278. <summary>
  28279. Determines whether the specified <see cref="T:System.Object"/> is equal to the current <see cref="T:MailKit.AccessRight"/>.
  28280. </summary>
  28281. <remarks>
  28282. Determines whether the specified <see cref="T:System.Object"/> is equal to the current <see cref="T:MailKit.AccessRight"/>.
  28283. </remarks>
  28284. <param name="obj">The <see cref="T:System.Object"/> to compare with the current <see cref="T:MailKit.AccessRight"/>.</param>
  28285. <returns><c>true</c> if the specified <see cref="T:System.Object"/> is equal to the current <see cref="T:MailKit.AccessRight"/>;
  28286. otherwise, <c>false</c>.</returns>
  28287. </member>
  28288. <member name="M:MailKit.AccessRight.GetHashCode">
  28289. <summary>
  28290. Serves as a hash function for a <see cref="T:MailKit.AccessRight"/> object.
  28291. </summary>
  28292. <remarks>
  28293. Serves as a hash function for a <see cref="T:MailKit.AccessRight"/> object.
  28294. </remarks>
  28295. <returns>A hash code for this instance that is suitable for use in hashing algorithms and data structures such as a hash table.</returns>
  28296. </member>
  28297. <member name="M:MailKit.AccessRight.ToString">
  28298. <summary>
  28299. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.AccessRight"/>.
  28300. </summary>
  28301. <remarks>
  28302. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.AccessRight"/>.
  28303. </remarks>
  28304. <returns>A <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.AccessRight"/>.</returns>
  28305. </member>
  28306. <member name="T:MailKit.AccessRights">
  28307. <summary>
  28308. A set of access rights.
  28309. </summary>
  28310. <remarks>
  28311. The set of access rights for a particular identity.
  28312. </remarks>
  28313. </member>
  28314. <member name="M:MailKit.AccessRights.#ctor(System.Collections.Generic.IEnumerable{MailKit.AccessRight})">
  28315. <summary>
  28316. Initializes a new instance of the <see cref="T:MailKit.AccessRights"/> class.
  28317. </summary>
  28318. <remarks>
  28319. Creates a new set of access rights.
  28320. </remarks>
  28321. <param name="rights">The access rights.</param>
  28322. <exception cref="T:System.ArgumentNullException">
  28323. <paramref name="rights"/> is <c>null</c>.
  28324. </exception>
  28325. </member>
  28326. <member name="M:MailKit.AccessRights.#ctor(System.String)">
  28327. <summary>
  28328. Initializes a new instance of the <see cref="T:MailKit.AccessRights"/> class.
  28329. </summary>
  28330. <remarks>
  28331. Creates a new set of access rights.
  28332. </remarks>
  28333. <param name="rights">The access rights.</param>
  28334. <exception cref="T:System.ArgumentNullException">
  28335. <paramref name="rights"/> is <c>null</c>.
  28336. </exception>
  28337. </member>
  28338. <member name="M:MailKit.AccessRights.#ctor">
  28339. <summary>
  28340. Initializes a new instance of the <see cref="T:MailKit.AccessRights"/> class.
  28341. </summary>
  28342. <remarks>
  28343. Creates an empty set of access rights.
  28344. </remarks>
  28345. </member>
  28346. <member name="P:MailKit.AccessRights.Count">
  28347. <summary>
  28348. Get the number of access rights in the collection.
  28349. </summary>
  28350. <remarks>
  28351. Gets the number of access rights in the collection.
  28352. </remarks>
  28353. <value>The count.</value>
  28354. </member>
  28355. <member name="P:MailKit.AccessRights.IsReadOnly">
  28356. <summary>
  28357. Get whether or not this set of access rights is read only.
  28358. </summary>
  28359. <remarks>
  28360. Gets whether or not this set of access rights is read only.
  28361. </remarks>
  28362. <value><c>true</c> if this collection is read only; otherwise, <c>false</c>.</value>
  28363. </member>
  28364. <member name="M:MailKit.AccessRights.System#Collections#Generic#ICollection{MailKit#AccessRight}#Add(MailKit.AccessRight)">
  28365. <summary>
  28366. Add the specified access right.
  28367. </summary>
  28368. <remarks>
  28369. Adds the specified access right if it is not already included.
  28370. </remarks>
  28371. <param name="right">The access right.</param>
  28372. </member>
  28373. <member name="M:MailKit.AccessRights.Add(MailKit.AccessRight)">
  28374. <summary>
  28375. Add the specified access right.
  28376. </summary>
  28377. <remarks>
  28378. Adds the specified access right if it is not already included.
  28379. </remarks>
  28380. <returns><c>true</c> if the right was added; otherwise, <c>false</c>.</returns>
  28381. <param name="right">The access right.</param>
  28382. </member>
  28383. <member name="M:MailKit.AccessRights.Add(System.Char)">
  28384. <summary>
  28385. Add the specified right.
  28386. </summary>
  28387. <remarks>
  28388. Adds the right specified by the given character.
  28389. </remarks>
  28390. <returns><c>true</c> if the right was added; otherwise, <c>false</c>.</returns>
  28391. <param name="right">The right.</param>
  28392. </member>
  28393. <member name="M:MailKit.AccessRights.AddRange(System.String)">
  28394. <summary>
  28395. Add the rights specified by the characters in the given string.
  28396. </summary>
  28397. <remarks>
  28398. Adds the rights specified by the characters in the given string.
  28399. </remarks>
  28400. <param name="rights">The rights.</param>
  28401. <exception cref="T:System.ArgumentNullException">
  28402. <paramref name="rights"/> is <c>null</c>.
  28403. </exception>
  28404. </member>
  28405. <member name="M:MailKit.AccessRights.AddRange(System.Collections.Generic.IEnumerable{MailKit.AccessRight})">
  28406. <summary>
  28407. Add the range of specified rights.
  28408. </summary>
  28409. <remarks>
  28410. Adds the range of specified rights.
  28411. </remarks>
  28412. <param name="rights">The rights.</param>
  28413. <exception cref="T:System.ArgumentNullException">
  28414. <paramref name="rights"/> is <c>null</c>.
  28415. </exception>
  28416. </member>
  28417. <member name="M:MailKit.AccessRights.Clear">
  28418. <summary>
  28419. Clears the access rights.
  28420. </summary>
  28421. <remarks>
  28422. Removes all of the access rights.
  28423. </remarks>
  28424. </member>
  28425. <member name="M:MailKit.AccessRights.Contains(MailKit.AccessRight)">
  28426. <summary>
  28427. Checks if the set of access rights contains the specified right.
  28428. </summary>
  28429. <remarks>
  28430. Determines whether or not the set of access rights already contains the specified right
  28431. </remarks>
  28432. <returns><value>true</value> if the specified right exists; otherwise <value>false</value>.</returns>
  28433. <param name="right">The access right.</param>
  28434. </member>
  28435. <member name="M:MailKit.AccessRights.CopyTo(MailKit.AccessRight[],System.Int32)">
  28436. <summary>
  28437. Copies all of the access rights to the specified array.
  28438. </summary>
  28439. <remarks>
  28440. Copies all of the access rights into the array,
  28441. starting at the specified array index.
  28442. </remarks>
  28443. <param name="array">The array.</param>
  28444. <param name="arrayIndex">The array index.</param>
  28445. <exception cref="T:System.ArgumentNullException">
  28446. <paramref name="array"/> is <c>null</c>.
  28447. </exception>
  28448. <exception cref="T:System.ArgumentOutOfRangeException">
  28449. <paramref name="arrayIndex"/> is out of range.
  28450. </exception>
  28451. </member>
  28452. <member name="M:MailKit.AccessRights.Remove(MailKit.AccessRight)">
  28453. <summary>
  28454. Removes the specified access right.
  28455. </summary>
  28456. <remarks>
  28457. Removes the specified access right.
  28458. </remarks>
  28459. <returns><value>true</value> if the access right was removed; otherwise <value>false</value>.</returns>
  28460. <param name="right">The access right.</param>
  28461. </member>
  28462. <member name="P:MailKit.AccessRights.Item(System.Int32)">
  28463. <summary>
  28464. Get the access right at the specified index.
  28465. </summary>
  28466. <remarks>
  28467. Gets the access right at the specified index.
  28468. </remarks>
  28469. <value>The access right at the specified index.</value>
  28470. <param name="index">The index.</param>
  28471. <exception cref="T:System.ArgumentOutOfRangeException">
  28472. <paramref name="index"/> is out of range.
  28473. </exception>
  28474. </member>
  28475. <member name="M:MailKit.AccessRights.GetEnumerator">
  28476. <summary>
  28477. Get the access rights enumerator.
  28478. </summary>
  28479. <remarks>
  28480. Gets the access rights enumerator.
  28481. </remarks>
  28482. <returns>The enumerator.</returns>
  28483. </member>
  28484. <member name="M:MailKit.AccessRights.System#Collections#IEnumerable#GetEnumerator">
  28485. <summary>
  28486. Get the access rights enumerator.
  28487. </summary>
  28488. <remarks>
  28489. Gets the access rights enumerator.
  28490. </remarks>
  28491. <returns>The enumerator.</returns>
  28492. </member>
  28493. <member name="M:MailKit.AccessRights.ToString">
  28494. <summary>
  28495. Return a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.AccessRights"/>.
  28496. </summary>
  28497. <remarks>
  28498. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.AccessRights"/>.
  28499. </remarks>
  28500. <returns>A <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.AccessRights"/>.</returns>
  28501. </member>
  28502. <member name="T:MailKit.AlertEventArgs">
  28503. <summary>
  28504. Alert event arguments.
  28505. </summary>
  28506. <remarks>
  28507. Some <see cref="T:MailKit.IMailStore"/> implementations, such as
  28508. <see cref="T:MailKit.Net.Imap.ImapClient"/>, will emit Alert
  28509. events when they receive alert messages from the server.
  28510. </remarks>
  28511. </member>
  28512. <member name="M:MailKit.AlertEventArgs.#ctor(System.String)">
  28513. <summary>
  28514. Initializes a new instance of the <see cref="T:MailKit.AlertEventArgs"/> class.
  28515. </summary>
  28516. <remarks>
  28517. Creates a new <see cref="T:MailKit.AlertEventArgs"/>.
  28518. </remarks>
  28519. <param name="message">The alert message.</param>
  28520. <exception cref="T:System.ArgumentNullException">
  28521. <paramref name="message"/> is <c>null</c>.
  28522. </exception>
  28523. </member>
  28524. <member name="P:MailKit.AlertEventArgs.Message">
  28525. <summary>
  28526. Gets the alert message.
  28527. </summary>
  28528. <remarks>
  28529. The alert message will be the exact message received from the server.
  28530. </remarks>
  28531. <value>The alert message.</value>
  28532. </member>
  28533. <member name="T:MailKit.Annotation">
  28534. <summary>
  28535. An annotation.
  28536. </summary>
  28537. <remarks>
  28538. <para>An annotation.</para>
  28539. <para>For more information about annotations, see
  28540. <a href="https://tools.ietf.org/html/rfc5257">rfc5257</a>.</para>
  28541. </remarks>
  28542. </member>
  28543. <member name="M:MailKit.Annotation.#ctor(MailKit.AnnotationEntry)">
  28544. <summary>
  28545. Initializes a new instance of the <see cref="T:MailKit.Annotation"/> class.
  28546. </summary>
  28547. <remarks>
  28548. Creates a new <see cref="T:MailKit.Annotation"/>.
  28549. </remarks>
  28550. <param name="entry">The annotation entry.</param>
  28551. <exception cref="T:System.ArgumentNullException">
  28552. <paramref name="entry"/> is <c>null</c>.
  28553. </exception>
  28554. </member>
  28555. <member name="P:MailKit.Annotation.Entry">
  28556. <summary>
  28557. Get the annotation tag.
  28558. </summary>
  28559. <remarks>
  28560. Gets the annotation tag.
  28561. </remarks>
  28562. <value>The annotation tag.</value>
  28563. </member>
  28564. <member name="P:MailKit.Annotation.Properties">
  28565. <summary>
  28566. Get the annotation properties.
  28567. </summary>
  28568. <remarks>
  28569. Gets the annotation properties.
  28570. </remarks>
  28571. </member>
  28572. <member name="T:MailKit.AnnotationAccess">
  28573. <summary>
  28574. An annotation access level.
  28575. </summary>
  28576. <remarks>
  28577. <para>An annotation access level.</para>
  28578. <para>For more information about annotations, see
  28579. <a href="https://tools.ietf.org/html/rfc5257">rfc5257</a>.</para>
  28580. </remarks>
  28581. </member>
  28582. <member name="F:MailKit.AnnotationAccess.None">
  28583. <summary>
  28584. Annotations are not supported.
  28585. </summary>
  28586. </member>
  28587. <member name="F:MailKit.AnnotationAccess.ReadOnly">
  28588. <summary>
  28589. Annotations are read-only.
  28590. </summary>
  28591. </member>
  28592. <member name="F:MailKit.AnnotationAccess.ReadWrite">
  28593. <summary>
  28594. Annotations are read-write.
  28595. </summary>
  28596. </member>
  28597. <member name="T:MailKit.AnnotationAttribute">
  28598. <summary>
  28599. An annotation attribute.
  28600. </summary>
  28601. <remarks>
  28602. <para>An annotation attribute.</para>
  28603. <para>For more information about annotations, see
  28604. <a href="https://tools.ietf.org/html/rfc5257">rfc5257</a>.</para>
  28605. </remarks>
  28606. </member>
  28607. <member name="F:MailKit.AnnotationAttribute.Value">
  28608. <summary>
  28609. The annotation value.
  28610. </summary>
  28611. <remarks>
  28612. Used to get or set both the private and shared values of an annotation.
  28613. </remarks>
  28614. </member>
  28615. <member name="F:MailKit.AnnotationAttribute.SharedValue">
  28616. <summary>
  28617. The shared annotation value.
  28618. </summary>
  28619. <remarks>
  28620. Used to get or set the shared value of an annotation.
  28621. </remarks>
  28622. </member>
  28623. <member name="F:MailKit.AnnotationAttribute.PrivateValue">
  28624. <summary>
  28625. The private annotation value.
  28626. </summary>
  28627. <remarks>
  28628. Used to get or set the private value of an annotation.
  28629. </remarks>
  28630. </member>
  28631. <member name="F:MailKit.AnnotationAttribute.Size">
  28632. <summary>
  28633. The size of an annotation value.
  28634. </summary>
  28635. <remarks>
  28636. Used to get the size of the both the private and shared annotation values.
  28637. </remarks>
  28638. </member>
  28639. <member name="F:MailKit.AnnotationAttribute.SharedSize">
  28640. <summary>
  28641. The size of a shared annotation value.
  28642. </summary>
  28643. <remarks>
  28644. Used to get the size of a shared annotation value.
  28645. </remarks>
  28646. </member>
  28647. <member name="F:MailKit.AnnotationAttribute.PrivateSize">
  28648. <summary>
  28649. The size of a private annotation value.
  28650. </summary>
  28651. <remarks>
  28652. Used to get the size of a private annotation value.
  28653. </remarks>
  28654. </member>
  28655. <member name="M:MailKit.AnnotationAttribute.#ctor(System.String)">
  28656. <summary>
  28657. Initializes a new instance of the <see cref="T:MailKit.AnnotationAttribute"/> class.
  28658. </summary>
  28659. <param name="specifier">The annotation attribute specifier.</param>
  28660. <exception cref="T:System.ArgumentNullException">
  28661. <paramref name="specifier"/> is <c>null</c>.
  28662. </exception>
  28663. <exception cref="T:System.ArgumentException">
  28664. <paramref name="specifier"/> contains illegal characters.
  28665. </exception>
  28666. </member>
  28667. <member name="P:MailKit.AnnotationAttribute.Name">
  28668. <summary>
  28669. Get the name of the annotation attribute.
  28670. </summary>
  28671. <remarks>
  28672. Gets the name of the annotation attribute.
  28673. </remarks>
  28674. </member>
  28675. <member name="P:MailKit.AnnotationAttribute.Scope">
  28676. <summary>
  28677. Get the scope of the annotation attribute.
  28678. </summary>
  28679. <remarks>
  28680. Gets the scope of the annotation attribute.
  28681. </remarks>
  28682. </member>
  28683. <member name="P:MailKit.AnnotationAttribute.Specifier">
  28684. <summary>
  28685. Get the annotation attribute specifier.
  28686. </summary>
  28687. <remarks>
  28688. Gets the annotation attribute specifier.
  28689. </remarks>
  28690. </member>
  28691. <member name="M:MailKit.AnnotationAttribute.Equals(MailKit.AnnotationAttribute)">
  28692. <summary>
  28693. Determines whether the specified <see cref="T:MailKit.AnnotationAttribute"/> is equal to the current <see cref="T:MailKit.AnnotationAttribute"/>.
  28694. </summary>
  28695. <remarks>
  28696. Determines whether the specified <see cref="T:MailKit.AnnotationAttribute"/> is equal to the current <see cref="T:MailKit.AnnotationAttribute"/>.
  28697. </remarks>
  28698. <param name="other">The <see cref="T:MailKit.AnnotationAttribute"/> to compare with the current <see cref="T:MailKit.AnnotationAttribute"/>.</param>
  28699. <returns><c>true</c> if the specified <see cref="T:MailKit.AnnotationAttribute"/> is equal to the current
  28700. <see cref="T:MailKit.AnnotationAttribute"/>; otherwise, <c>false</c>.</returns>
  28701. </member>
  28702. <member name="M:MailKit.AnnotationAttribute.op_Equality(MailKit.AnnotationAttribute,MailKit.AnnotationAttribute)">
  28703. <summary>
  28704. Determines whether two annotation attributes are equal.
  28705. </summary>
  28706. <remarks>
  28707. Determines whether two annotation attributes are equal.
  28708. </remarks>
  28709. <returns><c>true</c> if <paramref name="attr1"/> and <paramref name="attr2"/> are equal; otherwise, <c>false</c>.</returns>
  28710. <param name="attr1">The first annotation attribute to compare.</param>
  28711. <param name="attr2">The second annotation attribute to compare.</param>
  28712. </member>
  28713. <member name="M:MailKit.AnnotationAttribute.op_Inequality(MailKit.AnnotationAttribute,MailKit.AnnotationAttribute)">
  28714. <summary>
  28715. Determines whether two annotation attributes are not equal.
  28716. </summary>
  28717. <remarks>
  28718. Determines whether two annotation attributes are not equal.
  28719. </remarks>
  28720. <returns><c>true</c> if <paramref name="attr1"/> and <paramref name="attr2"/> are not equal; otherwise, <c>false</c>.</returns>
  28721. <param name="attr1">The first annotation attribute to compare.</param>
  28722. <param name="attr2">The second annotation attribute to compare.</param>
  28723. </member>
  28724. <member name="M:MailKit.AnnotationAttribute.Equals(System.Object)">
  28725. <summary>
  28726. Determine whether the specified <see cref="T:System.Object"/> is equal to the current <see cref="T:MailKit.AnnotationAttribute"/>.
  28727. </summary>
  28728. <remarks>
  28729. Determines whether the specified <see cref="T:System.Object"/> is equal to the current <see cref="T:MailKit.AnnotationAttribute"/>.
  28730. </remarks>
  28731. <param name="obj">The <see cref="T:System.Object"/> to compare with the current <see cref="T:MailKit.AnnotationAttribute"/>.</param>
  28732. <returns><c>true</c> if the specified <see cref="T:System.Object"/> is equal to the current
  28733. <see cref="T:MailKit.AnnotationAttribute"/>; otherwise, <c>false</c>.</returns>
  28734. </member>
  28735. <member name="M:MailKit.AnnotationAttribute.GetHashCode">
  28736. <summary>
  28737. Serves as a hash function for a <see cref="T:MailKit.AnnotationAttribute"/> object.
  28738. </summary>
  28739. <remarks>
  28740. Serves as a hash function for a <see cref="T:MailKit.AnnotationAttribute"/> object.
  28741. </remarks>
  28742. <returns>A hash code for this instance that is suitable for use in hashing algorithms and data structures such as a hash table.</returns>
  28743. </member>
  28744. <member name="M:MailKit.AnnotationAttribute.ToString">
  28745. <summary>
  28746. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.AnnotationAttribute"/>.
  28747. </summary>
  28748. <remarks>
  28749. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.AnnotationAttribute"/>.
  28750. </remarks>
  28751. <returns>A <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.AnnotationAttribute"/>.</returns>
  28752. </member>
  28753. <member name="T:MailKit.AnnotationEntry">
  28754. <summary>
  28755. An annotation entry.
  28756. </summary>
  28757. <remarks>
  28758. <para>An annotation entry.</para>
  28759. <para>For more information about annotations, see
  28760. <a href="https://tools.ietf.org/html/rfc5257">rfc5257</a>.</para>
  28761. </remarks>
  28762. </member>
  28763. <member name="F:MailKit.AnnotationEntry.Comment">
  28764. <summary>
  28765. An annotation entry for a comment on a message.
  28766. </summary>
  28767. <remarks>
  28768. Used to get or set a comment on a message.
  28769. </remarks>
  28770. </member>
  28771. <member name="F:MailKit.AnnotationEntry.PrivateComment">
  28772. <summary>
  28773. An annotation entry for a private comment on a message.
  28774. </summary>
  28775. <remarks>
  28776. Used to get or set a private comment on a message.
  28777. </remarks>
  28778. </member>
  28779. <member name="F:MailKit.AnnotationEntry.SharedComment">
  28780. <summary>
  28781. An annotation entry for a shared comment on a message.
  28782. </summary>
  28783. <remarks>
  28784. Used to get or set a shared comment on a message.
  28785. </remarks>
  28786. </member>
  28787. <member name="F:MailKit.AnnotationEntry.Flags">
  28788. <summary>
  28789. An annotation entry for flags on a message.
  28790. </summary>
  28791. <remarks>
  28792. Used to get or set flags on a message.
  28793. </remarks>
  28794. </member>
  28795. <member name="F:MailKit.AnnotationEntry.PrivateFlags">
  28796. <summary>
  28797. An annotation entry for private flags on a message.
  28798. </summary>
  28799. <remarks>
  28800. Used to get or set private flags on a message.
  28801. </remarks>
  28802. </member>
  28803. <member name="F:MailKit.AnnotationEntry.SharedFlags">
  28804. <summary>
  28805. Aa annotation entry for shared flags on a message.
  28806. </summary>
  28807. <remarks>
  28808. Used to get or set shared flags on a message.
  28809. </remarks>
  28810. </member>
  28811. <member name="F:MailKit.AnnotationEntry.AltSubject">
  28812. <summary>
  28813. An annotation entry for an alternate subject on a message.
  28814. </summary>
  28815. <remarks>
  28816. Used to get or set an alternate subject on a message.
  28817. </remarks>
  28818. </member>
  28819. <member name="F:MailKit.AnnotationEntry.PrivateAltSubject">
  28820. <summary>
  28821. An annotation entry for a private alternate subject on a message.
  28822. </summary>
  28823. <remarks>
  28824. Used to get or set a private alternate subject on a message.
  28825. </remarks>
  28826. </member>
  28827. <member name="F:MailKit.AnnotationEntry.SharedAltSubject">
  28828. <summary>
  28829. An annotation entry for a shared alternate subject on a message.
  28830. </summary>
  28831. <remarks>
  28832. Used to get or set a shared alternate subject on a message.
  28833. </remarks>
  28834. </member>
  28835. <member name="M:MailKit.AnnotationEntry.#ctor(System.String,MailKit.AnnotationScope)">
  28836. <summary>
  28837. Initializes a new instance of the <see cref="T:MailKit.AnnotationEntry"/> struct.
  28838. </summary>
  28839. <remarks>
  28840. Creates a new <see cref="T:MailKit.AnnotationEntry"/>.
  28841. </remarks>
  28842. <param name="path">The annotation entry path.</param>
  28843. <param name="scope">The scope of the annotation.</param>
  28844. <exception cref="T:System.ArgumentNullException">
  28845. <paramref name="path"/> is <c>null</c>.
  28846. </exception>
  28847. <exception cref="T:System.ArgumentException">
  28848. <paramref name="path"/> is invalid.
  28849. </exception>
  28850. </member>
  28851. <member name="M:MailKit.AnnotationEntry.#ctor(System.String,System.String,MailKit.AnnotationScope)">
  28852. <summary>
  28853. Initializes a new instance of the <see cref="T:MailKit.AnnotationEntry"/> struct.
  28854. </summary>
  28855. <remarks>
  28856. Creates a new <see cref="T:MailKit.AnnotationEntry"/> for an individual body part of a message.
  28857. </remarks>
  28858. <param name="partSpecifier">The part-specifier of the body part of the message.</param>
  28859. <param name="path">The annotation entry path.</param>
  28860. <param name="scope">The scope of the annotation.</param>
  28861. <exception cref="T:System.ArgumentNullException">
  28862. <para><paramref name="partSpecifier"/> is <c>null</c>.</para>
  28863. <para>-or-</para>
  28864. <para><paramref name="path"/> is <c>null</c>.</para>
  28865. </exception>
  28866. <exception cref="T:System.ArgumentException">
  28867. <para><paramref name="partSpecifier"/> is invalid.</para>
  28868. <para>-or-</para>
  28869. <para><paramref name="path"/> is invalid.</para>
  28870. </exception>
  28871. </member>
  28872. <member name="M:MailKit.AnnotationEntry.#ctor(MailKit.BodyPart,System.String,MailKit.AnnotationScope)">
  28873. <summary>
  28874. Initializes a new instance of the <see cref="T:MailKit.AnnotationEntry"/> struct.
  28875. </summary>
  28876. <remarks>
  28877. Creates a new <see cref="T:MailKit.AnnotationEntry"/> for an individual body part of a message.
  28878. </remarks>
  28879. <param name="part">The body part of the message.</param>
  28880. <param name="path">The annotation entry path.</param>
  28881. <param name="scope">The scope of the annotation.</param>
  28882. <exception cref="T:System.ArgumentNullException">
  28883. <para><paramref name="part"/> is <c>null</c>.</para>
  28884. <para>-or-</para>
  28885. <para><paramref name="path"/> is <c>null</c>.</para>
  28886. </exception>
  28887. <exception cref="T:System.ArgumentException">
  28888. <paramref name="path"/> is invalid.
  28889. </exception>
  28890. </member>
  28891. <member name="P:MailKit.AnnotationEntry.Entry">
  28892. <summary>
  28893. Get the annotation entry specifier.
  28894. </summary>
  28895. <remarks>
  28896. Gets the annotation entry specifier.
  28897. </remarks>
  28898. <value>The annotation entry specifier.</value>
  28899. </member>
  28900. <member name="P:MailKit.AnnotationEntry.PartSpecifier">
  28901. <summary>
  28902. Get the part-specifier component of the annotation entry.
  28903. </summary>
  28904. <remarks>
  28905. Gets the part-specifier component of the annotation entry.
  28906. </remarks>
  28907. </member>
  28908. <member name="P:MailKit.AnnotationEntry.Path">
  28909. <summary>
  28910. Get the path component of the annotation entry.
  28911. </summary>
  28912. <remarks>
  28913. Gets the path component of the annotation entry.
  28914. </remarks>
  28915. </member>
  28916. <member name="P:MailKit.AnnotationEntry.Scope">
  28917. <summary>
  28918. Get the scope of the annotation.
  28919. </summary>
  28920. <remarks>
  28921. Gets the scope of the annotation.
  28922. </remarks>
  28923. </member>
  28924. <member name="M:MailKit.AnnotationEntry.Equals(MailKit.AnnotationEntry)">
  28925. <summary>
  28926. Determines whether the specified <see cref="T:MailKit.AnnotationEntry"/> is equal to the current <see cref="T:MailKit.AnnotationEntry"/>.
  28927. </summary>
  28928. <remarks>
  28929. Determines whether the specified <see cref="T:MailKit.AnnotationEntry"/> is equal to the current <see cref="T:MailKit.AnnotationEntry"/>.
  28930. </remarks>
  28931. <param name="other">The <see cref="T:MailKit.AnnotationEntry"/> to compare with the current <see cref="T:MailKit.AnnotationEntry"/>.</param>
  28932. <returns><c>true</c> if the specified <see cref="T:MailKit.AnnotationEntry"/> is equal to the current
  28933. <see cref="T:MailKit.AnnotationEntry"/>; otherwise, <c>false</c>.</returns>
  28934. </member>
  28935. <member name="M:MailKit.AnnotationEntry.op_Equality(MailKit.AnnotationEntry,MailKit.AnnotationEntry)">
  28936. <summary>
  28937. Determines whether two annotation entries are equal.
  28938. </summary>
  28939. <remarks>
  28940. Determines whether two annotation entries are equal.
  28941. </remarks>
  28942. <returns><c>true</c> if <paramref name="entry1"/> and <paramref name="entry2"/> are equal; otherwise, <c>false</c>.</returns>
  28943. <param name="entry1">The first annotation entry to compare.</param>
  28944. <param name="entry2">The second annotation entry to compare.</param>
  28945. </member>
  28946. <member name="M:MailKit.AnnotationEntry.op_Inequality(MailKit.AnnotationEntry,MailKit.AnnotationEntry)">
  28947. <summary>
  28948. Determines whether two annotation entries are not equal.
  28949. </summary>
  28950. <remarks>
  28951. Determines whether two annotation entries are not equal.
  28952. </remarks>
  28953. <returns><c>true</c> if <paramref name="entry1"/> and <paramref name="entry2"/> are not equal; otherwise, <c>false</c>.</returns>
  28954. <param name="entry1">The first annotation entry to compare.</param>
  28955. <param name="entry2">The second annotation entry to compare.</param>
  28956. </member>
  28957. <member name="M:MailKit.AnnotationEntry.Equals(System.Object)">
  28958. <summary>
  28959. Determine whether the specified <see cref="T:System.Object"/> is equal to the current <see cref="T:MailKit.AnnotationEntry"/>.
  28960. </summary>
  28961. <remarks>
  28962. Determines whether the specified <see cref="T:System.Object"/> is equal to the current <see cref="T:MailKit.AnnotationEntry"/>.
  28963. </remarks>
  28964. <param name="obj">The <see cref="T:System.Object"/> to compare with the current <see cref="T:MailKit.AnnotationEntry"/>.</param>
  28965. <returns><c>true</c> if the specified <see cref="T:System.Object"/> is equal to the current
  28966. <see cref="T:MailKit.AnnotationEntry"/>; otherwise, <c>false</c>.</returns>
  28967. </member>
  28968. <member name="M:MailKit.AnnotationEntry.GetHashCode">
  28969. <summary>
  28970. Serves as a hash function for a <see cref="T:MailKit.AnnotationEntry"/> object.
  28971. </summary>
  28972. <remarks>
  28973. Serves as a hash function for a <see cref="T:MailKit.AnnotationEntry"/> object.
  28974. </remarks>
  28975. <returns>A hash code for this instance that is suitable for use in hashing algorithms and data structures such as a hash table.</returns>
  28976. </member>
  28977. <member name="M:MailKit.AnnotationEntry.ToString">
  28978. <summary>
  28979. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.AnnotationEntry"/>.
  28980. </summary>
  28981. <remarks>
  28982. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.AnnotationEntry"/>.
  28983. </remarks>
  28984. <returns>A <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.AnnotationEntry"/>.</returns>
  28985. </member>
  28986. <member name="M:MailKit.AnnotationEntry.Parse(System.String)">
  28987. <summary>
  28988. Parse an annotation entry.
  28989. </summary>
  28990. <remarks>
  28991. Parses an annotation entry.
  28992. </remarks>
  28993. <param name="entry">The annotation entry.</param>
  28994. <returns>The parsed annotation entry.</returns>
  28995. <exception cref="T:System.ArgumentNullException">
  28996. <paramref name="entry"/> is <c>null</c>.
  28997. </exception>
  28998. <exception cref="T:System.FormatException">
  28999. <paramref name="entry"/> does not conform to the annotation entry syntax.
  29000. </exception>
  29001. </member>
  29002. <member name="T:MailKit.AnnotationsChangedEventArgs">
  29003. <summary>
  29004. Event args used when an annotation changes.
  29005. </summary>
  29006. <remarks>
  29007. Event args used when an annotation changes.
  29008. </remarks>
  29009. </member>
  29010. <member name="M:MailKit.AnnotationsChangedEventArgs.#ctor(System.Int32)">
  29011. <summary>
  29012. Initializes a new instance of the <see cref="T:MailKit.AnnotationsChangedEventArgs"/> class.
  29013. </summary>
  29014. <remarks>
  29015. Creates a new <see cref="T:MailKit.AnnotationsChangedEventArgs"/>.
  29016. </remarks>
  29017. <param name="index">The message index.</param>
  29018. </member>
  29019. <member name="M:MailKit.AnnotationsChangedEventArgs.#ctor(System.Int32,System.Collections.Generic.IEnumerable{MailKit.Annotation})">
  29020. <summary>
  29021. Initializes a new instance of the <see cref="T:MailKit.AnnotationsChangedEventArgs"/> class.
  29022. </summary>
  29023. <remarks>
  29024. Creates a new <see cref="T:MailKit.AnnotationsChangedEventArgs"/>.
  29025. </remarks>
  29026. <param name="index">The message index.</param>
  29027. <param name="annotations">The annotations that changed.</param>
  29028. <exception cref="T:System.ArgumentNullException">
  29029. <paramref name="annotations"/> is <c>null</c>.
  29030. </exception>
  29031. </member>
  29032. <member name="P:MailKit.AnnotationsChangedEventArgs.Annotations">
  29033. <summary>
  29034. Get the annotations that changed.
  29035. </summary>
  29036. <remarks>
  29037. Gets the annotations that changed.
  29038. </remarks>
  29039. <value>The annotation.</value>
  29040. </member>
  29041. <member name="P:MailKit.AnnotationsChangedEventArgs.ModSeq">
  29042. <summary>
  29043. Gets the updated mod-sequence value of the message, if available.
  29044. </summary>
  29045. <remarks>
  29046. Gets the updated mod-sequence value of the message, if available.
  29047. </remarks>
  29048. <value>The mod-sequence value.</value>
  29049. </member>
  29050. <member name="T:MailKit.AnnotationScope">
  29051. <summary>
  29052. The scope of an annotation.
  29053. </summary>
  29054. <remarks>
  29055. <para>Represents the scope of an annotation.</para>
  29056. <para>For more information about annotations, see
  29057. <a href="https://tools.ietf.org/html/rfc5257">rfc5257</a>.</para>
  29058. </remarks>
  29059. </member>
  29060. <member name="F:MailKit.AnnotationScope.None">
  29061. <summary>
  29062. No scopes.
  29063. </summary>
  29064. </member>
  29065. <member name="F:MailKit.AnnotationScope.Private">
  29066. <summary>
  29067. The private annotation scope.
  29068. </summary>
  29069. </member>
  29070. <member name="F:MailKit.AnnotationScope.Shared">
  29071. <summary>
  29072. The shared annotation scope.
  29073. </summary>
  29074. </member>
  29075. <member name="F:MailKit.AnnotationScope.Both">
  29076. <summary>
  29077. Both private and shared scopes.
  29078. </summary>
  29079. </member>
  29080. <member name="T:MailKit.AuthenticatedEventArgs">
  29081. <summary>
  29082. Authenticated event arguments.
  29083. </summary>
  29084. <remarks>
  29085. Some servers, such as GMail IMAP, will send some free-form text in
  29086. the response to a successful login.
  29087. </remarks>
  29088. </member>
  29089. <member name="M:MailKit.AuthenticatedEventArgs.#ctor(System.String)">
  29090. <summary>
  29091. Initializes a new instance of the <see cref="T:MailKit.AuthenticatedEventArgs"/> class.
  29092. </summary>
  29093. <remarks>
  29094. Creates a new <see cref="T:MailKit.AuthenticatedEventArgs"/>.
  29095. </remarks>
  29096. <param name="message">The free-form text.</param>
  29097. <exception cref="T:System.ArgumentNullException">
  29098. <paramref name="message"/> is <c>null</c>.
  29099. </exception>
  29100. </member>
  29101. <member name="P:MailKit.AuthenticatedEventArgs.Message">
  29102. <summary>
  29103. Get the free-form text sent by the server.
  29104. </summary>
  29105. <remarks>
  29106. Gets the free-form text sent by the server.
  29107. </remarks>
  29108. <value>The free-form text sent by the server.</value>
  29109. </member>
  29110. <member name="T:MailKit.BodyPart">
  29111. <summary>
  29112. An abstract body part of a message.
  29113. </summary>
  29114. <remarks>
  29115. Each body part will actually be a <see cref="T:MailKit.BodyPartBasic"/>,
  29116. <see cref="T:MailKit.BodyPartText"/>, <see cref="T:MailKit.BodyPartMessage"/>, or
  29117. <see cref="T:MailKit.BodyPartMultipart"/>.
  29118. </remarks>
  29119. <example>
  29120. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  29121. </example>
  29122. </member>
  29123. <member name="M:MailKit.BodyPart.#ctor">
  29124. <summary>
  29125. Initializes a new instance of the <see cref="T:MailKit.BodyPart"/> class.
  29126. </summary>
  29127. <remarks>
  29128. Creates a new <see cref="T:MailKit.BodyPart"/>.
  29129. </remarks>
  29130. </member>
  29131. <member name="P:MailKit.BodyPart.ContentType">
  29132. <summary>
  29133. Gets the Content-Type of the body part.
  29134. </summary>
  29135. <remarks>
  29136. Gets the Content-Type of the body part.
  29137. </remarks>
  29138. <value>The content type.</value>
  29139. </member>
  29140. <member name="P:MailKit.BodyPart.PartSpecifier">
  29141. <summary>
  29142. Gets the part specifier.
  29143. </summary>
  29144. <remarks>
  29145. Gets the part specifier.
  29146. </remarks>
  29147. <example>
  29148. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  29149. </example>
  29150. <value>The part specifier.</value>
  29151. </member>
  29152. <member name="M:MailKit.BodyPart.Accept(MailKit.BodyPartVisitor)">
  29153. <summary>
  29154. Dispatches to the specific visit method for this MIME body part.
  29155. </summary>
  29156. <remarks>
  29157. This default implementation for <see cref="T:MailKit.BodyPart"/> nodes
  29158. calls <see cref="M:MailKit.BodyPartVisitor.VisitBodyPart(MailKit.BodyPart)"/>. Override this
  29159. method to call into a more specific method on a derived visitor class
  29160. of the <see cref="T:MailKit.BodyPartVisitor"/> class. However, it should still
  29161. support unknown visitors by calling
  29162. <see cref="M:MailKit.BodyPartVisitor.VisitBodyPart(MailKit.BodyPart)"/>.
  29163. </remarks>
  29164. <param name="visitor">The visitor.</param>
  29165. <exception cref="T:System.ArgumentNullException">
  29166. <paramref name="visitor"/> is <c>null</c>.
  29167. </exception>
  29168. </member>
  29169. <member name="M:MailKit.BodyPart.Encode(System.Text.StringBuilder)">
  29170. <summary>
  29171. Encodes the <see cref="T:MailKit.BodyPart"/> into the <see cref="T:System.Text.StringBuilder"/>.
  29172. </summary>
  29173. <remarks>
  29174. Encodes the <see cref="T:MailKit.BodyPart"/> into the <see cref="T:System.Text.StringBuilder"/>.
  29175. </remarks>
  29176. <param name="builder">The string builder.</param>
  29177. </member>
  29178. <member name="M:MailKit.BodyPart.ToString">
  29179. <summary>
  29180. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.BodyPart"/>.
  29181. </summary>
  29182. <remarks>
  29183. <para>Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.BodyPart"/>.</para>
  29184. <note type="note">The syntax of the string returned, while similar to IMAP's BODYSTRUCTURE syntax,
  29185. is not completely compatible.</note>
  29186. </remarks>
  29187. <returns>A <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.BodyPart"/>.</returns>
  29188. </member>
  29189. <member name="M:MailKit.BodyPart.TryParse(System.String,MailKit.BodyPart@)">
  29190. <summary>
  29191. Tries to parse the given text into a new <see cref="T:MailKit.BodyPart"/> instance.
  29192. </summary>
  29193. <remarks>
  29194. <para>Parses a body part from the specified text.</para>
  29195. <note type="note">This syntax, while similar to IMAP's BODYSTRUCTURE syntax, is not completely
  29196. compatible.</note>
  29197. </remarks>
  29198. <returns><c>true</c>, if the body part was successfully parsed, <c>false</c> otherwise.</returns>
  29199. <param name="text">The text to parse.</param>
  29200. <param name="part">The parsed body part.</param>
  29201. <exception cref="T:System.ArgumentNullException">
  29202. <paramref name="text"/> is <c>null</c>.
  29203. </exception>
  29204. </member>
  29205. <member name="T:MailKit.BodyPartBasic">
  29206. <summary>
  29207. A basic message body part.
  29208. </summary>
  29209. <remarks>
  29210. Represents any message body part that is not a multipart,
  29211. message/rfc822 part, or a text part.
  29212. </remarks>
  29213. <example>
  29214. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  29215. </example>
  29216. </member>
  29217. <member name="M:MailKit.BodyPartBasic.#ctor">
  29218. <summary>
  29219. Initializes a new instance of the <see cref="T:MailKit.BodyPartBasic"/> class.
  29220. </summary>
  29221. <remarks>
  29222. Creates a new <see cref="T:MailKit.BodyPartBasic"/>.
  29223. </remarks>
  29224. </member>
  29225. <member name="P:MailKit.BodyPartBasic.ContentId">
  29226. <summary>
  29227. Gets the Content-Id of the body part, if available.
  29228. </summary>
  29229. <remarks>
  29230. Gets the Content-Id of the body part, if available.
  29231. </remarks>
  29232. <value>The content identifier.</value>
  29233. </member>
  29234. <member name="P:MailKit.BodyPartBasic.ContentDescription">
  29235. <summary>
  29236. Gets the Content-Description of the body part, if available.
  29237. </summary>
  29238. <remarks>
  29239. Gets the Content-Description of the body part, if available.
  29240. </remarks>
  29241. <value>The content description.</value>
  29242. </member>
  29243. <member name="P:MailKit.BodyPartBasic.ContentTransferEncoding">
  29244. <summary>
  29245. Gets the Content-Transfer-Encoding of the body part.
  29246. </summary>
  29247. <remarks>
  29248. <para>Gets the Content-Transfer-Encoding of the body part.</para>
  29249. <para>Hint: Use the <a href="M_MimeKit_Utils_MimeUtils_TryParse_1.htm">MimeUtils.TryParse</a>
  29250. method to parse this value into a usable <see cref="T:MimeKit.ContentEncoding"/>.</para>
  29251. </remarks>
  29252. <value>The content transfer encoding.</value>
  29253. </member>
  29254. <member name="P:MailKit.BodyPartBasic.Octets">
  29255. <summary>
  29256. Gets the size of the body part, in bytes.
  29257. </summary>
  29258. <remarks>
  29259. Gets the size of the body part, in bytes.
  29260. </remarks>
  29261. <value>The number of octets.</value>
  29262. </member>
  29263. <member name="P:MailKit.BodyPartBasic.ContentMd5">
  29264. <summary>
  29265. Gets the MD5 hash of the content, if available.
  29266. </summary>
  29267. <remarks>
  29268. Gets the MD5 hash of the content, if available.
  29269. </remarks>
  29270. <value>The content md5.</value>
  29271. </member>
  29272. <member name="P:MailKit.BodyPartBasic.ContentDisposition">
  29273. <summary>
  29274. Gets the Content-Disposition of the body part, if available.
  29275. </summary>
  29276. <remarks>
  29277. <para>Gets the Content-Disposition of the body part, if available.</para>
  29278. <note type="note">The Content-Disposition value is only retrieved if the
  29279. <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/> flag is used when fetching
  29280. summary information from an <see cref="T:MailKit.IMailFolder"/>.</note>
  29281. </remarks>
  29282. <value>The content disposition.</value>
  29283. </member>
  29284. <member name="P:MailKit.BodyPartBasic.ContentLanguage">
  29285. <summary>
  29286. Gets the Content-Language of the body part, if available.
  29287. </summary>
  29288. <remarks>
  29289. <para>Gets the Content-Language of the body part, if available.</para>
  29290. <para>The Content-Language value is only retrieved if the
  29291. <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/> flag is used when fetching
  29292. summary information from an <see cref="T:MailKit.IMailFolder"/>.</para>
  29293. </remarks>
  29294. <value>The content language.</value>
  29295. </member>
  29296. <member name="P:MailKit.BodyPartBasic.ContentLocation">
  29297. <summary>
  29298. Gets the Content-Location of the body part, if available.
  29299. </summary>
  29300. <remarks>
  29301. <para>Gets the Content-Location of the body part, if available.</para>
  29302. <para>The Content-Location value is only retrieved if the
  29303. <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/> flag is used when fetching
  29304. summary information from an <see cref="T:MailKit.IMailFolder"/>.</para>
  29305. </remarks>
  29306. <value>The content location.</value>
  29307. </member>
  29308. <member name="P:MailKit.BodyPartBasic.IsAttachment">
  29309. <summary>
  29310. Determines whether or not the body part is an attachment.
  29311. </summary>
  29312. <remarks>
  29313. <para>Determines whether or not the body part is an attachment based on the value of
  29314. the Content-Disposition.</para>
  29315. <note type="note">Since the value of the Content-Disposition header is needed, it
  29316. is necessary to include the <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/> flag when
  29317. fetching summary information from an <see cref="T:MailKit.IMailFolder"/>.</note>
  29318. </remarks>
  29319. <value><c>true</c> if this part is an attachment; otherwise, <c>false</c>.</value>
  29320. </member>
  29321. <member name="P:MailKit.BodyPartBasic.FileName">
  29322. <summary>
  29323. Get the name of the file.
  29324. </summary>
  29325. <remarks>
  29326. <para>First checks for the "filename" parameter on the Content-Disposition header. If
  29327. that does not exist, then the "name" parameter on the Content-Type header is used.</para>
  29328. <note type="note">Since the value of the Content-Disposition header is needed, it is
  29329. necessary to include the <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/> flag when
  29330. fetching summary information from an <see cref="T:MailKit.IMailFolder"/>.</note>
  29331. </remarks>
  29332. <value>The name of the file.</value>
  29333. </member>
  29334. <member name="M:MailKit.BodyPartBasic.Accept(MailKit.BodyPartVisitor)">
  29335. <summary>
  29336. Dispatches to the specific visit method for this MIME body part.
  29337. </summary>
  29338. <remarks>
  29339. This default implementation for <see cref="T:MailKit.BodyPart"/> nodes
  29340. calls <see cref="M:MailKit.BodyPartVisitor.VisitBodyPart(MailKit.BodyPart)"/>. Override this
  29341. method to call into a more specific method on a derived visitor class
  29342. of the <see cref="T:MailKit.BodyPartVisitor"/> class. However, it should still
  29343. support unknown visitors by calling
  29344. <see cref="M:MailKit.BodyPartVisitor.VisitBodyPart(MailKit.BodyPart)"/>.
  29345. </remarks>
  29346. <param name="visitor">The visitor.</param>
  29347. <exception cref="T:System.ArgumentNullException">
  29348. <paramref name="visitor"/> is <c>null</c>.
  29349. </exception>
  29350. </member>
  29351. <member name="M:MailKit.BodyPartBasic.Encode(System.Text.StringBuilder)">
  29352. <summary>
  29353. Encodes the <see cref="T:MailKit.BodyPart"/> into the <see cref="T:System.Text.StringBuilder"/>.
  29354. </summary>
  29355. <remarks>
  29356. Encodes the <see cref="T:MailKit.BodyPart"/> into the <see cref="T:System.Text.StringBuilder"/>.
  29357. </remarks>
  29358. <param name="builder">The string builder.</param>
  29359. </member>
  29360. <member name="T:MailKit.BodyPartCollection">
  29361. <summary>
  29362. A <see cref="T:MailKit.BodyPart"/> collection.
  29363. </summary>
  29364. <remarks>
  29365. A <see cref="T:MailKit.BodyPart"/> collection.
  29366. </remarks>
  29367. </member>
  29368. <member name="M:MailKit.BodyPartCollection.#ctor">
  29369. <summary>
  29370. Initializes a new instance of the <see cref="T:MailKit.BodyPartCollection"/> class.
  29371. </summary>
  29372. <remarks>
  29373. Creates a new <see cref="T:MailKit.BodyPartCollection"/>.
  29374. </remarks>
  29375. </member>
  29376. <member name="P:MailKit.BodyPartCollection.Count">
  29377. <summary>
  29378. Get the number of body parts in the collection.
  29379. </summary>
  29380. <remarks>
  29381. Gets the number of body parts in the collection.
  29382. </remarks>
  29383. <value>The count.</value>
  29384. </member>
  29385. <member name="P:MailKit.BodyPartCollection.IsReadOnly">
  29386. <summary>
  29387. Get whether or not this body part collection is read only.
  29388. </summary>
  29389. <remarks>
  29390. Gets whether or not this body part collection is read only.
  29391. </remarks>
  29392. <value><c>true</c> if this collection is read only; otherwise, <c>false</c>.</value>
  29393. </member>
  29394. <member name="M:MailKit.BodyPartCollection.Add(MailKit.BodyPart)">
  29395. <summary>
  29396. Add the specified body part to the collection.
  29397. </summary>
  29398. <remarks>
  29399. Adds the specified body part to the collection.
  29400. </remarks>
  29401. <param name="part">The body part.</param>
  29402. <exception cref="T:System.ArgumentNullException">
  29403. <paramref name="part"/> is <c>null</c>.
  29404. </exception>
  29405. </member>
  29406. <member name="M:MailKit.BodyPartCollection.Clear">
  29407. <summary>
  29408. Clears the body part collection.
  29409. </summary>
  29410. <remarks>
  29411. Removes all of the body parts from the collection.
  29412. </remarks>
  29413. </member>
  29414. <member name="M:MailKit.BodyPartCollection.Contains(MailKit.BodyPart)">
  29415. <summary>
  29416. Checks if the collection contains the specified body part.
  29417. </summary>
  29418. <remarks>
  29419. Determines whether or not the collection contains the specified body part.
  29420. </remarks>
  29421. <returns><value>true</value> if the specified body part exists; otherwise <value>false</value>.</returns>
  29422. <param name="part">The body part.</param>
  29423. <exception cref="T:System.ArgumentNullException">
  29424. <paramref name="part"/> is <c>null</c>.
  29425. </exception>
  29426. </member>
  29427. <member name="M:MailKit.BodyPartCollection.CopyTo(MailKit.BodyPart[],System.Int32)">
  29428. <summary>
  29429. Copies all of the body parts in the collection to the specified array.
  29430. </summary>
  29431. <remarks>
  29432. Copies all of the body parts within the collection into the array,
  29433. starting at the specified array index.
  29434. </remarks>
  29435. <param name="array">The array.</param>
  29436. <param name="arrayIndex">The array index.</param>
  29437. <exception cref="T:System.ArgumentNullException">
  29438. <paramref name="array"/> is <c>null</c>.
  29439. </exception>
  29440. <exception cref="T:System.ArgumentOutOfRangeException">
  29441. <paramref name="arrayIndex"/> is out of range.
  29442. </exception>
  29443. </member>
  29444. <member name="M:MailKit.BodyPartCollection.Remove(MailKit.BodyPart)">
  29445. <summary>
  29446. Removes the specified body part.
  29447. </summary>
  29448. <remarks>
  29449. Removes the specified body part.
  29450. </remarks>
  29451. <returns><value>true</value> if the body part was removed; otherwise <value>false</value>.</returns>
  29452. <param name="part">The body part.</param>
  29453. <exception cref="T:System.ArgumentNullException">
  29454. <paramref name="part"/> is <c>null</c>.
  29455. </exception>
  29456. </member>
  29457. <member name="P:MailKit.BodyPartCollection.Item(System.Int32)">
  29458. <summary>
  29459. Get the body part at the specified index.
  29460. </summary>
  29461. <remarks>
  29462. Gets the body part at the specified index.
  29463. </remarks>
  29464. <value>The body part at the specified index.</value>
  29465. <param name="index">The index.</param>
  29466. <exception cref="T:System.ArgumentOutOfRangeException">
  29467. <paramref name="index"/> is out of range.
  29468. </exception>
  29469. </member>
  29470. <member name="M:MailKit.BodyPartCollection.IndexOf(System.Uri)">
  29471. <summary>
  29472. Gets the index of the body part matching the specified URI.
  29473. </summary>
  29474. <remarks>
  29475. <para>Finds the index of the body part matching the specified URI, if it exists.</para>
  29476. <para>If the URI scheme is <c>"cid"</c>, then matching is performed based on the Content-Id header
  29477. values, otherwise the Content-Location headers are used. If the provided URI is absolute and a child
  29478. part's Content-Location is relative, then then the child part's Content-Location URI will be combined
  29479. with the value of its Content-Base header, if available, otherwise it will be combined with the
  29480. multipart/related part's Content-Base header in order to produce an absolute URI that can be
  29481. compared with the provided absolute URI.</para>
  29482. </remarks>
  29483. <returns>The index of the part matching the specified URI if found; otherwise <c>-1</c>.</returns>
  29484. <param name="uri">The URI of the body part.</param>
  29485. <exception cref="T:System.ArgumentNullException">
  29486. <paramref name="uri"/> is <c>null</c>.
  29487. </exception>
  29488. </member>
  29489. <member name="M:MailKit.BodyPartCollection.GetEnumerator">
  29490. <summary>
  29491. Get the body part enumerator.
  29492. </summary>
  29493. <remarks>
  29494. Gets the body part enumerator.
  29495. </remarks>
  29496. <returns>The enumerator.</returns>
  29497. </member>
  29498. <member name="M:MailKit.BodyPartCollection.System#Collections#IEnumerable#GetEnumerator">
  29499. <summary>
  29500. Get the body part enumerator.
  29501. </summary>
  29502. <remarks>
  29503. Gets the body part enumerator.
  29504. </remarks>
  29505. <returns>The enumerator.</returns>
  29506. </member>
  29507. <member name="T:MailKit.BodyPartMessage">
  29508. <summary>
  29509. A message/rfc822 body part.
  29510. </summary>
  29511. <remarks>
  29512. Represents a message/rfc822 body part.
  29513. </remarks>
  29514. </member>
  29515. <member name="M:MailKit.BodyPartMessage.#ctor">
  29516. <summary>
  29517. Initializes a new instance of the <see cref="T:MailKit.BodyPartMessage"/> class.
  29518. </summary>
  29519. <remarks>
  29520. Creates a new <see cref="T:MailKit.BodyPartMessage"/>.
  29521. </remarks>
  29522. </member>
  29523. <member name="P:MailKit.BodyPartMessage.Envelope">
  29524. <summary>
  29525. Gets the envelope of the message, if available.
  29526. </summary>
  29527. <remarks>
  29528. Gets the envelope of the message, if available.
  29529. </remarks>
  29530. <value>The envelope.</value>
  29531. </member>
  29532. <member name="P:MailKit.BodyPartMessage.Body">
  29533. <summary>
  29534. Gets the body structure of the message.
  29535. </summary>
  29536. <remarks>
  29537. Gets the body structure of the message.
  29538. </remarks>
  29539. <value>The body structure.</value>
  29540. </member>
  29541. <member name="P:MailKit.BodyPartMessage.Lines">
  29542. <summary>
  29543. Gets the length of the message, in lines.
  29544. </summary>
  29545. <remarks>
  29546. Gets the length of the message, in lines.
  29547. </remarks>
  29548. <value>The number of lines.</value>
  29549. </member>
  29550. <member name="M:MailKit.BodyPartMessage.Accept(MailKit.BodyPartVisitor)">
  29551. <summary>
  29552. Dispatches to the specific visit method for this MIME body part.
  29553. </summary>
  29554. <remarks>
  29555. This default implementation for <see cref="T:MailKit.BodyPart"/> nodes
  29556. calls <see cref="M:MailKit.BodyPartVisitor.VisitBodyPart(MailKit.BodyPart)"/>. Override this
  29557. method to call into a more specific method on a derived visitor class
  29558. of the <see cref="T:MailKit.BodyPartVisitor"/> class. However, it should still
  29559. support unknown visitors by calling
  29560. <see cref="M:MailKit.BodyPartVisitor.VisitBodyPart(MailKit.BodyPart)"/>.
  29561. </remarks>
  29562. <param name="visitor">The visitor.</param>
  29563. <exception cref="T:System.ArgumentNullException">
  29564. <paramref name="visitor"/> is <c>null</c>.
  29565. </exception>
  29566. </member>
  29567. <member name="M:MailKit.BodyPartMessage.Encode(System.Text.StringBuilder)">
  29568. <summary>
  29569. Encodes the <see cref="T:MailKit.BodyPart"/> into the <see cref="T:System.Text.StringBuilder"/>.
  29570. </summary>
  29571. <remarks>
  29572. Encodes the <see cref="T:MailKit.BodyPart"/> into the <see cref="T:System.Text.StringBuilder"/>.
  29573. </remarks>
  29574. <param name="builder">The string builder.</param>
  29575. </member>
  29576. <member name="T:MailKit.BodyPartMultipart">
  29577. <summary>
  29578. A multipart body part.
  29579. </summary>
  29580. <remarks>
  29581. A multipart body part.
  29582. </remarks>
  29583. </member>
  29584. <member name="M:MailKit.BodyPartMultipart.#ctor">
  29585. <summary>
  29586. Initializes a new instance of the <see cref="T:MailKit.BodyPartMultipart"/> class.
  29587. </summary>
  29588. <remarks>
  29589. Creates a new <see cref="T:MailKit.BodyPartMultipart"/>.
  29590. </remarks>
  29591. </member>
  29592. <member name="P:MailKit.BodyPartMultipart.BodyParts">
  29593. <summary>
  29594. Gets the child body parts.
  29595. </summary>
  29596. <remarks>
  29597. Gets the child body parts.
  29598. </remarks>
  29599. <value>The child body parts.</value>
  29600. </member>
  29601. <member name="P:MailKit.BodyPartMultipart.ContentDisposition">
  29602. <summary>
  29603. Gets the Content-Disposition of the body part, if available.
  29604. </summary>
  29605. <remarks>
  29606. Gets the Content-Disposition of the body part, if available.
  29607. </remarks>
  29608. <value>The content disposition.</value>
  29609. </member>
  29610. <member name="P:MailKit.BodyPartMultipart.ContentLanguage">
  29611. <summary>
  29612. Gets the Content-Language of the body part, if available.
  29613. </summary>
  29614. <remarks>
  29615. Gets the Content-Language of the body part, if available.
  29616. </remarks>
  29617. <value>The content language.</value>
  29618. </member>
  29619. <member name="P:MailKit.BodyPartMultipart.ContentLocation">
  29620. <summary>
  29621. Gets the Content-Location of the body part, if available.
  29622. </summary>
  29623. <remarks>
  29624. Gets the Content-Location of the body part, if available.
  29625. </remarks>
  29626. <value>The content location.</value>
  29627. </member>
  29628. <member name="M:MailKit.BodyPartMultipart.Accept(MailKit.BodyPartVisitor)">
  29629. <summary>
  29630. Dispatches to the specific visit method for this MIME body part.
  29631. </summary>
  29632. <remarks>
  29633. This default implementation for <see cref="T:MailKit.BodyPart"/> nodes
  29634. calls <see cref="M:MailKit.BodyPartVisitor.VisitBodyPart(MailKit.BodyPart)"/>. Override this
  29635. method to call into a more specific method on a derived visitor class
  29636. of the <see cref="T:MailKit.BodyPartVisitor"/> class. However, it should still
  29637. support unknown visitors by calling
  29638. <see cref="M:MailKit.BodyPartVisitor.VisitBodyPart(MailKit.BodyPart)"/>.
  29639. </remarks>
  29640. <param name="visitor">The visitor.</param>
  29641. <exception cref="T:System.ArgumentNullException">
  29642. <paramref name="visitor"/> is <c>null</c>.
  29643. </exception>
  29644. </member>
  29645. <member name="M:MailKit.BodyPartMultipart.Encode(System.Text.StringBuilder)">
  29646. <summary>
  29647. Encodes the <see cref="T:MailKit.BodyPart"/> into the <see cref="T:System.Text.StringBuilder"/>.
  29648. </summary>
  29649. <remarks>
  29650. Encodes the <see cref="T:MailKit.BodyPart"/> into the <see cref="T:System.Text.StringBuilder"/>.
  29651. </remarks>
  29652. <param name="builder">The string builder.</param>
  29653. </member>
  29654. <member name="T:MailKit.BodyPartText">
  29655. <summary>
  29656. A textual body part.
  29657. </summary>
  29658. <remarks>
  29659. Represents any body part with a media type of "text".
  29660. </remarks>
  29661. <example>
  29662. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  29663. </example>
  29664. </member>
  29665. <member name="M:MailKit.BodyPartText.#ctor">
  29666. <summary>
  29667. Initializes a new instance of the <see cref="T:MailKit.BodyPartText"/> class.
  29668. </summary>
  29669. <remarks>
  29670. Creates a new <see cref="T:MailKit.BodyPartText"/>.
  29671. </remarks>
  29672. </member>
  29673. <member name="P:MailKit.BodyPartText.IsPlain">
  29674. <summary>
  29675. Gets whether or not this text part contains plain text.
  29676. </summary>
  29677. <remarks>
  29678. Checks whether or not the text part's Content-Type is text/plain.
  29679. </remarks>
  29680. <value><c>true</c> if the text is html; otherwise, <c>false</c>.</value>
  29681. </member>
  29682. <member name="P:MailKit.BodyPartText.IsHtml">
  29683. <summary>
  29684. Gets whether or not this text part contains HTML.
  29685. </summary>
  29686. <remarks>
  29687. Checks whether or not the text part's Content-Type is text/html.
  29688. </remarks>
  29689. <value><c>true</c> if the text is html; otherwise, <c>false</c>.</value>
  29690. </member>
  29691. <member name="P:MailKit.BodyPartText.Lines">
  29692. <summary>
  29693. Gets the length of the text, in lines.
  29694. </summary>
  29695. <remarks>
  29696. Gets the length of the text, in lines.
  29697. </remarks>
  29698. <value>The number of lines.</value>
  29699. </member>
  29700. <member name="M:MailKit.BodyPartText.Accept(MailKit.BodyPartVisitor)">
  29701. <summary>
  29702. Dispatches to the specific visit method for this MIME body part.
  29703. </summary>
  29704. <remarks>
  29705. This default implementation for <see cref="T:MailKit.BodyPart"/> nodes
  29706. calls <see cref="M:MailKit.BodyPartVisitor.VisitBodyPart(MailKit.BodyPart)"/>. Override this
  29707. method to call into a more specific method on a derived visitor class
  29708. of the <see cref="T:MailKit.BodyPartVisitor"/> class. However, it should still
  29709. support unknown visitors by calling
  29710. <see cref="M:MailKit.BodyPartVisitor.VisitBodyPart(MailKit.BodyPart)"/>.
  29711. </remarks>
  29712. <param name="visitor">The visitor.</param>
  29713. <exception cref="T:System.ArgumentNullException">
  29714. <paramref name="visitor"/> is <c>null</c>.
  29715. </exception>
  29716. </member>
  29717. <member name="M:MailKit.BodyPartText.Encode(System.Text.StringBuilder)">
  29718. <summary>
  29719. Encodes the <see cref="T:MailKit.BodyPart"/> into the <see cref="T:System.Text.StringBuilder"/>.
  29720. </summary>
  29721. <remarks>
  29722. Encodes the <see cref="T:MailKit.BodyPart"/> into the <see cref="T:System.Text.StringBuilder"/>.
  29723. </remarks>
  29724. <param name="builder">The string builder.</param>
  29725. </member>
  29726. <member name="T:MailKit.BodyPartVisitor">
  29727. <summary>
  29728. Represents a visitor for a tree of MIME body parts.
  29729. </summary>
  29730. <remarks>
  29731. This class is designed to be inherited to create more specialized classes whose
  29732. functionality requires traversing, examining or copying a tree of MIME body parts.
  29733. </remarks>
  29734. </member>
  29735. <member name="M:MailKit.BodyPartVisitor.Visit(MailKit.BodyPart)">
  29736. <summary>
  29737. Dispatches the entity to one of the more specialized visit methods in this class.
  29738. </summary>
  29739. <remarks>
  29740. Dispatches the entity to one of the more specialized visit methods in this class.
  29741. </remarks>
  29742. <param name="body">The MIME body part.</param>
  29743. </member>
  29744. <member name="M:MailKit.BodyPartVisitor.VisitBodyPart(MailKit.BodyPart)">
  29745. <summary>
  29746. Visit the abstract MIME body part.
  29747. </summary>
  29748. <remarks>
  29749. Visits the abstract MIME body part.
  29750. </remarks>
  29751. <param name="entity">The MIME body part.</param>
  29752. </member>
  29753. <member name="M:MailKit.BodyPartVisitor.VisitBodyPartBasic(MailKit.BodyPartBasic)">
  29754. <summary>
  29755. Visit the basic MIME body part.
  29756. </summary>
  29757. <remarks>
  29758. Visits the basic MIME body part.
  29759. </remarks>
  29760. <param name="entity">The basic MIME body part.</param>
  29761. </member>
  29762. <member name="M:MailKit.BodyPartVisitor.VisitMessage(MailKit.BodyPart)">
  29763. <summary>
  29764. Visit the message contained within a message/rfc822 or message/news MIME entity.
  29765. </summary>
  29766. <remarks>
  29767. Visits the message contained within a message/rfc822 or message/news MIME entity.
  29768. </remarks>
  29769. <param name="message">The body part representing the message/rfc822 message.</param>
  29770. </member>
  29771. <member name="M:MailKit.BodyPartVisitor.VisitBodyPartMessage(MailKit.BodyPartMessage)">
  29772. <summary>
  29773. Visit the message/rfc822 or message/news MIME entity.
  29774. </summary>
  29775. <remarks>
  29776. Visits the message/rfc822 or message/news MIME entity.
  29777. </remarks>
  29778. <param name="entity">The message/rfc822 or message/news body part.</param>
  29779. </member>
  29780. <member name="M:MailKit.BodyPartVisitor.VisitChildren(MailKit.BodyPartMultipart)">
  29781. <summary>
  29782. Visit the children of a <see cref="T:MailKit.BodyPartMultipart"/>.
  29783. </summary>
  29784. <remarks>
  29785. Visits the children of a <see cref="T:MailKit.BodyPartMultipart"/>.
  29786. </remarks>
  29787. <param name="multipart">The multipart.</param>
  29788. </member>
  29789. <member name="M:MailKit.BodyPartVisitor.VisitBodyPartMultipart(MailKit.BodyPartMultipart)">
  29790. <summary>
  29791. Visit the abstract multipart MIME entity.
  29792. </summary>
  29793. <remarks>
  29794. Visits the abstract multipart MIME entity.
  29795. </remarks>
  29796. <param name="multipart">The multipart body part.</param>
  29797. </member>
  29798. <member name="M:MailKit.BodyPartVisitor.VisitBodyPartText(MailKit.BodyPartText)">
  29799. <summary>
  29800. Visit the text-based MIME part entity.
  29801. </summary>
  29802. <remarks>
  29803. Visits the text-based MIME part entity.
  29804. </remarks>
  29805. <param name="entity">The text-based body part.</param>
  29806. </member>
  29807. <member name="T:MailKit.CommandException">
  29808. <summary>
  29809. The exception that is thrown when there is a command error.
  29810. </summary>
  29811. <remarks>
  29812. A <see cref="T:MailKit.CommandException"/> can be thrown by any of the various client
  29813. methods in MailKit. Unlike a <see cref="T:MailKit.ProtocolException"/>, a
  29814. <see cref="T:MailKit.CommandException"/> is typically non-fatal (meaning that it does
  29815. not force the client to disconnect).
  29816. </remarks>
  29817. </member>
  29818. <member name="M:MailKit.CommandException.#ctor(System.String,System.Exception)">
  29819. <summary>
  29820. Initializes a new instance of the <see cref="T:MailKit.CommandException"/> class.
  29821. </summary>
  29822. <remarks>
  29823. Creates a new <see cref="T:MailKit.CommandException"/>.
  29824. </remarks>
  29825. <param name="message">The error message.</param>
  29826. <param name="innerException">An inner exception.</param>
  29827. </member>
  29828. <member name="M:MailKit.CommandException.#ctor(System.String)">
  29829. <summary>
  29830. Initializes a new instance of the <see cref="T:MailKit.CommandException"/> class.
  29831. </summary>
  29832. <remarks>
  29833. Creates a new <see cref="T:MailKit.CommandException"/>.
  29834. </remarks>
  29835. <param name="message">The error message.</param>
  29836. </member>
  29837. <member name="M:MailKit.CommandException.#ctor">
  29838. <summary>
  29839. Initializes a new instance of the <see cref="T:MailKit.CommandException"/> class.
  29840. </summary>
  29841. <remarks>
  29842. Creates a new <see cref="T:MailKit.CommandException"/>.
  29843. </remarks>
  29844. </member>
  29845. <member name="T:MailKit.CompressedStream">
  29846. <summary>
  29847. A compressed stream.
  29848. </summary>
  29849. </member>
  29850. <member name="P:MailKit.CompressedStream.InnerStream">
  29851. <summary>
  29852. Gets the inner stream.
  29853. </summary>
  29854. <value>The inner stream.</value>
  29855. </member>
  29856. <member name="P:MailKit.CompressedStream.CanRead">
  29857. <summary>
  29858. Gets whether the stream supports reading.
  29859. </summary>
  29860. <value><c>true</c> if the stream supports reading; otherwise, <c>false</c>.</value>
  29861. </member>
  29862. <member name="P:MailKit.CompressedStream.CanWrite">
  29863. <summary>
  29864. Gets whether the stream supports writing.
  29865. </summary>
  29866. <value><c>true</c> if the stream supports writing; otherwise, <c>false</c>.</value>
  29867. </member>
  29868. <member name="P:MailKit.CompressedStream.CanSeek">
  29869. <summary>
  29870. Gets whether the stream supports seeking.
  29871. </summary>
  29872. <value><c>true</c> if the stream supports seeking; otherwise, <c>false</c>.</value>
  29873. </member>
  29874. <member name="P:MailKit.CompressedStream.CanTimeout">
  29875. <summary>
  29876. Gets whether the stream supports I/O timeouts.
  29877. </summary>
  29878. <value><c>true</c> if the stream supports I/O timeouts; otherwise, <c>false</c>.</value>
  29879. </member>
  29880. <member name="P:MailKit.CompressedStream.ReadTimeout">
  29881. <summary>
  29882. Gets or sets a value, in miliseconds, that determines how long the stream will attempt to read before timing out.
  29883. </summary>
  29884. <returns>A value, in miliseconds, that determines how long the stream will attempt to read before timing out.</returns>
  29885. <value>The read timeout.</value>
  29886. </member>
  29887. <member name="P:MailKit.CompressedStream.WriteTimeout">
  29888. <summary>
  29889. Gets or sets a value, in miliseconds, that determines how long the stream will attempt to write before timing out.
  29890. </summary>
  29891. <returns>A value, in miliseconds, that determines how long the stream will attempt to write before timing out.</returns>
  29892. <value>The write timeout.</value>
  29893. </member>
  29894. <member name="P:MailKit.CompressedStream.Position">
  29895. <summary>
  29896. Gets or sets the position within the current stream.
  29897. </summary>
  29898. <returns>The current position within the stream.</returns>
  29899. <value>The position of the stream.</value>
  29900. <exception cref="T:System.NotSupportedException">
  29901. The stream does not support seeking.
  29902. </exception>
  29903. </member>
  29904. <member name="P:MailKit.CompressedStream.Length">
  29905. <summary>
  29906. Gets the length in bytes of the stream.
  29907. </summary>
  29908. <returns>A long value representing the length of the stream in bytes.</returns>
  29909. <value>The length of the stream.</value>
  29910. <exception cref="T:System.NotSupportedException">
  29911. The stream does not support seeking.
  29912. </exception>
  29913. </member>
  29914. <member name="M:MailKit.CompressedStream.Read(System.Byte[],System.Int32,System.Int32)">
  29915. <summary>
  29916. Reads a sequence of bytes from the stream and advances the position
  29917. within the stream by the number of bytes read.
  29918. </summary>
  29919. <returns>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many
  29920. bytes are not currently available, or zero (0) if the end of the stream has been reached.</returns>
  29921. <param name="buffer">The buffer.</param>
  29922. <param name="offset">The buffer offset.</param>
  29923. <param name="count">The number of bytes to read.</param>
  29924. <exception cref="T:System.ArgumentNullException">
  29925. <paramref name="buffer"/> is <c>null</c>.
  29926. </exception>
  29927. <exception cref="T:System.ArgumentOutOfRangeException">
  29928. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  29929. <para>-or-</para>
  29930. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  29931. at the specified <paramref name="offset"/>.</para>
  29932. </exception>
  29933. <exception cref="T:System.ObjectDisposedException">
  29934. The stream has been disposed.
  29935. </exception>
  29936. <exception cref="T:System.IO.IOException">
  29937. An I/O error occurred.
  29938. </exception>
  29939. </member>
  29940. <member name="M:MailKit.CompressedStream.ReadAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  29941. <summary>
  29942. Reads a sequence of bytes from the stream and advances the position
  29943. within the stream by the number of bytes read.
  29944. </summary>
  29945. <returns>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many
  29946. bytes are not currently available, or zero (0) if the end of the stream has been reached.</returns>
  29947. <param name="buffer">The buffer.</param>
  29948. <param name="offset">The buffer offset.</param>
  29949. <param name="count">The number of bytes to read.</param>
  29950. <param name="cancellationToken">The cancellation token.</param>
  29951. <exception cref="T:System.ArgumentNullException">
  29952. <paramref name="buffer"/> is <c>null</c>.
  29953. </exception>
  29954. <exception cref="T:System.ArgumentOutOfRangeException">
  29955. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  29956. <para>-or-</para>
  29957. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  29958. at the specified <paramref name="offset"/>.</para>
  29959. </exception>
  29960. <exception cref="T:System.ObjectDisposedException">
  29961. The stream has been disposed.
  29962. </exception>
  29963. <exception cref="T:System.IO.IOException">
  29964. An I/O error occurred.
  29965. </exception>
  29966. </member>
  29967. <member name="M:MailKit.CompressedStream.Write(System.Byte[],System.Int32,System.Int32)">
  29968. <summary>
  29969. Writes a sequence of bytes to the stream and advances the current
  29970. position within this stream by the number of bytes written.
  29971. </summary>
  29972. <param name="buffer">The buffer to write.</param>
  29973. <param name="offset">The offset of the first byte to write.</param>
  29974. <param name="count">The number of bytes to write.</param>
  29975. <exception cref="T:System.ArgumentNullException">
  29976. <paramref name="buffer"/> is <c>null</c>.
  29977. </exception>
  29978. <exception cref="T:System.ArgumentOutOfRangeException">
  29979. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  29980. <para>-or-</para>
  29981. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  29982. at the specified <paramref name="offset"/>.</para>
  29983. </exception>
  29984. <exception cref="T:System.ObjectDisposedException">
  29985. The stream has been disposed.
  29986. </exception>
  29987. <exception cref="T:System.NotSupportedException">
  29988. The stream does not support writing.
  29989. </exception>
  29990. <exception cref="T:System.IO.IOException">
  29991. An I/O error occurred.
  29992. </exception>
  29993. </member>
  29994. <member name="M:MailKit.CompressedStream.WriteAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  29995. <summary>
  29996. Writes a sequence of bytes to the stream and advances the current
  29997. position within this stream by the number of bytes written.
  29998. </summary>
  29999. <returns>A task that represents the asynchronous write operation.</returns>
  30000. <param name="buffer">The buffer to write.</param>
  30001. <param name="offset">The offset of the first byte to write.</param>
  30002. <param name="count">The number of bytes to write.</param>
  30003. <param name="cancellationToken">The cancellation token.</param>
  30004. <exception cref="T:System.ArgumentNullException">
  30005. <paramref name="buffer"/> is <c>null</c>.
  30006. </exception>
  30007. <exception cref="T:System.ArgumentOutOfRangeException">
  30008. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  30009. <para>-or-</para>
  30010. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  30011. at the specified <paramref name="offset"/>.</para>
  30012. </exception>
  30013. <exception cref="T:System.ObjectDisposedException">
  30014. The stream has been disposed.
  30015. </exception>
  30016. <exception cref="T:System.NotSupportedException">
  30017. The stream does not support writing.
  30018. </exception>
  30019. <exception cref="T:System.IO.IOException">
  30020. An I/O error occurred.
  30021. </exception>
  30022. </member>
  30023. <member name="M:MailKit.CompressedStream.Flush">
  30024. <summary>
  30025. Clears all output buffers for this stream and causes any buffered data to be written
  30026. to the underlying device.
  30027. </summary>
  30028. <exception cref="T:System.ObjectDisposedException">
  30029. The stream has been disposed.
  30030. </exception>
  30031. <exception cref="T:System.NotSupportedException">
  30032. The stream does not support writing.
  30033. </exception>
  30034. <exception cref="T:System.IO.IOException">
  30035. An I/O error occurred.
  30036. </exception>
  30037. </member>
  30038. <member name="M:MailKit.CompressedStream.FlushAsync(System.Threading.CancellationToken)">
  30039. <summary>
  30040. Clears all output buffers for this stream and causes any buffered data to be written
  30041. to the underlying device.
  30042. </summary>
  30043. <returns>A task that represents the asynchronous flush operation.</returns>
  30044. <exception cref="T:System.ObjectDisposedException">
  30045. The stream has been disposed.
  30046. </exception>
  30047. <exception cref="T:System.NotSupportedException">
  30048. The stream does not support writing.
  30049. </exception>
  30050. <exception cref="T:System.IO.IOException">
  30051. An I/O error occurred.
  30052. </exception>
  30053. </member>
  30054. <member name="M:MailKit.CompressedStream.Seek(System.Int64,System.IO.SeekOrigin)">
  30055. <summary>
  30056. Sets the position within the current stream.
  30057. </summary>
  30058. <returns>The new position within the stream.</returns>
  30059. <param name="offset">The offset into the stream relative to the <paramref name="origin"/>.</param>
  30060. <param name="origin">The origin to seek from.</param>
  30061. <exception cref="T:System.NotSupportedException">
  30062. The stream does not support seeking.
  30063. </exception>
  30064. </member>
  30065. <member name="M:MailKit.CompressedStream.SetLength(System.Int64)">
  30066. <summary>
  30067. Sets the length of the stream.
  30068. </summary>
  30069. <param name="value">The desired length of the stream in bytes.</param>
  30070. <exception cref="T:System.NotSupportedException">
  30071. The stream does not support setting the length.
  30072. </exception>
  30073. </member>
  30074. <member name="M:MailKit.CompressedStream.Dispose(System.Boolean)">
  30075. <summary>
  30076. Releases the unmanaged resources used by the <see cref="T:MailKit.CompressedStream"/> and
  30077. optionally releases the managed resources.
  30078. </summary>
  30079. <param name="disposing"><c>true</c> to release both managed and unmanaged resources;
  30080. <c>false</c> to release only the unmanaged resources.</param>
  30081. </member>
  30082. <member name="T:MailKit.ConnectedEventArgs">
  30083. <summary>
  30084. Connected event arguments.
  30085. </summary>
  30086. <remarks>
  30087. When a <see cref="T:MailKit.IMailService"/> is connected, it will emit a
  30088. <see cref="E:MailKit.IMailService.Connected"/> event.
  30089. </remarks>
  30090. </member>
  30091. <member name="M:MailKit.ConnectedEventArgs.#ctor(System.String,System.Int32,MailKit.Security.SecureSocketOptions)">
  30092. <summary>
  30093. Initializes a new instance of the <see cref="T:MailKit.ConnectedEventArgs"/> class.
  30094. </summary>
  30095. <param name="host">The name of the host that the client connected to.</param>
  30096. <param name="port">The port that the client connected to on the remote host.</param>
  30097. <param name="options">The SSL/TLS options that were used when connecting to the remote host.</param>
  30098. </member>
  30099. <member name="P:MailKit.ConnectedEventArgs.Host">
  30100. <summary>
  30101. Get the name of the remote host.
  30102. </summary>
  30103. <remarks>
  30104. Gets the name of the remote host.
  30105. </remarks>
  30106. <value>The host name of the server.</value>
  30107. </member>
  30108. <member name="P:MailKit.ConnectedEventArgs.Port">
  30109. <summary>
  30110. Get the port.
  30111. </summary>
  30112. <remarks>
  30113. Gets the port.
  30114. </remarks>
  30115. <value>The port.</value>
  30116. </member>
  30117. <member name="P:MailKit.ConnectedEventArgs.Options">
  30118. <summary>
  30119. Get the SSL/TLS options.
  30120. </summary>
  30121. <remarks>
  30122. Gets the SSL/TLS options.
  30123. </remarks>
  30124. <value>The SSL/TLS options.</value>
  30125. </member>
  30126. <member name="T:MailKit.DeliveryStatusNotification">
  30127. <summary>
  30128. Delivery status notification types.
  30129. </summary>
  30130. <remarks>
  30131. A set of flags that may be bitwise-or'd together to specify
  30132. when a delivery status notification should be sent for a
  30133. particlar recipient.
  30134. </remarks>
  30135. </member>
  30136. <member name="F:MailKit.DeliveryStatusNotification.Never">
  30137. <summary>
  30138. Never send delivery status notifications.
  30139. </summary>
  30140. </member>
  30141. <member name="F:MailKit.DeliveryStatusNotification.Success">
  30142. <summary>
  30143. Send a notification on successful delivery to the recipient.
  30144. </summary>
  30145. </member>
  30146. <member name="F:MailKit.DeliveryStatusNotification.Failure">
  30147. <summary>
  30148. Send a notification on failure to deliver to the recipient.
  30149. </summary>
  30150. </member>
  30151. <member name="F:MailKit.DeliveryStatusNotification.Delay">
  30152. <summary>
  30153. Send a notification when the delivery to the recipient has
  30154. been delayed for an unusual amount of time.
  30155. </summary>
  30156. </member>
  30157. <member name="T:MailKit.DisconnectedEventArgs">
  30158. <summary>
  30159. Disconnected event arguments.
  30160. </summary>
  30161. <remarks>
  30162. When a <see cref="T:MailKit.IMailService"/> gets disconnected, it will emit a
  30163. <see cref="E:MailKit.IMailService.Disconnected"/> event.
  30164. </remarks>
  30165. </member>
  30166. <member name="M:MailKit.DisconnectedEventArgs.#ctor(System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Boolean)">
  30167. <summary>
  30168. Initializes a new instance of the <see cref="T:MailKit.DisconnectedEventArgs"/> class.
  30169. </summary>
  30170. <remarks>
  30171. Initializes a new instance of the <see cref="T:MailKit.DisconnectedEventArgs"/> class.
  30172. </remarks>
  30173. <param name="host">The name of the host that the client was connected to.</param>
  30174. <param name="port">The port that the client was connected to.</param>
  30175. <param name="options">The SSL/TLS options that were used by the client.</param>
  30176. <param name="requested">If <c>true</c>, the <see cref="T:MailKit.IMailService"/> was disconnected via the
  30177. <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/> method.</param>
  30178. </member>
  30179. <member name="P:MailKit.DisconnectedEventArgs.IsRequested">
  30180. <summary>
  30181. Get whether or not the service was explicitly asked to disconnect.
  30182. </summary>
  30183. <remarks>
  30184. If the <see cref="T:MailKit.IMailService"/> was disconnected via the
  30185. <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/> method, then
  30186. the value of <see cref="P:MailKit.DisconnectedEventArgs.IsRequested"/> will be <c>true</c>. If the connection was unexpectedly
  30187. dropped, then the value will be <c>false</c>.
  30188. </remarks>
  30189. <value><c>true</c> if the disconnect was explicitly requested; otherwise, <c>false</c>.</value>
  30190. </member>
  30191. <member name="T:MailKit.DuplexStream">
  30192. <summary>
  30193. A duplex stream.
  30194. </summary>
  30195. </member>
  30196. <member name="M:MailKit.DuplexStream.#ctor(System.IO.Stream,System.IO.Stream)">
  30197. <summary>
  30198. Initializes a new instance of the <see cref="T:MailKit.DuplexStream"/> class.
  30199. </summary>
  30200. <param name="istream">The stream to use for input.</param>
  30201. <param name="ostream">The stream to use for output.</param>
  30202. <exception cref="T:System.ArgumentNullException">
  30203. <para><paramref name="istream"/> is <c>null</c>.</para>
  30204. <para>-or-</para>
  30205. <para><paramref name="ostream"/> is <c>null</c>.</para>
  30206. </exception>
  30207. </member>
  30208. <member name="P:MailKit.DuplexStream.InputStream">
  30209. <summary>
  30210. Gets the input stream.
  30211. </summary>
  30212. <value>The input stream.</value>
  30213. </member>
  30214. <member name="P:MailKit.DuplexStream.OutputStream">
  30215. <summary>
  30216. Gets the output stream.
  30217. </summary>
  30218. <value>The output stream.</value>
  30219. </member>
  30220. <member name="P:MailKit.DuplexStream.CanRead">
  30221. <summary>
  30222. Gets whether the stream supports reading.
  30223. </summary>
  30224. <value><c>true</c> if the stream supports reading; otherwise, <c>false</c>.</value>
  30225. </member>
  30226. <member name="P:MailKit.DuplexStream.CanWrite">
  30227. <summary>
  30228. Gets whether the stream supports writing.
  30229. </summary>
  30230. <value><c>true</c> if the stream supports writing; otherwise, <c>false</c>.</value>
  30231. </member>
  30232. <member name="P:MailKit.DuplexStream.CanSeek">
  30233. <summary>
  30234. Gets whether the stream supports seeking.
  30235. </summary>
  30236. <value><c>true</c> if the stream supports seeking; otherwise, <c>false</c>.</value>
  30237. </member>
  30238. <member name="P:MailKit.DuplexStream.CanTimeout">
  30239. <summary>
  30240. Gets whether the stream supports I/O timeouts.
  30241. </summary>
  30242. <value><c>true</c> if the stream supports I/O timeouts; otherwise, <c>false</c>.</value>
  30243. </member>
  30244. <member name="P:MailKit.DuplexStream.ReadTimeout">
  30245. <summary>
  30246. Gets or sets a value, in miliseconds, that determines how long the stream will attempt to read before timing out.
  30247. </summary>
  30248. <returns>A value, in miliseconds, that determines how long the stream will attempt to read before timing out.</returns>
  30249. <value>The read timeout.</value>
  30250. </member>
  30251. <member name="P:MailKit.DuplexStream.WriteTimeout">
  30252. <summary>
  30253. Gets or sets a value, in miliseconds, that determines how long the stream will attempt to write before timing out.
  30254. </summary>
  30255. <returns>A value, in miliseconds, that determines how long the stream will attempt to write before timing out.</returns>
  30256. <value>The write timeout.</value>
  30257. </member>
  30258. <member name="P:MailKit.DuplexStream.Position">
  30259. <summary>
  30260. Gets or sets the position within the current stream.
  30261. </summary>
  30262. <returns>The current position within the stream.</returns>
  30263. <value>The position of the stream.</value>
  30264. <exception cref="T:System.NotSupportedException">
  30265. The stream does not support seeking.
  30266. </exception>
  30267. </member>
  30268. <member name="P:MailKit.DuplexStream.Length">
  30269. <summary>
  30270. Gets the length in bytes of the stream.
  30271. </summary>
  30272. <returns>A long value representing the length of the stream in bytes.</returns>
  30273. <value>The length of the stream.</value>
  30274. <exception cref="T:System.NotSupportedException">
  30275. The stream does not support seeking.
  30276. </exception>
  30277. </member>
  30278. <member name="M:MailKit.DuplexStream.Read(System.Byte[],System.Int32,System.Int32)">
  30279. <summary>
  30280. Reads a sequence of bytes from the stream and advances the position
  30281. within the stream by the number of bytes read.
  30282. </summary>
  30283. <returns>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many
  30284. bytes are not currently available, or zero (0) if the end of the stream has been reached.</returns>
  30285. <param name="buffer">The buffer.</param>
  30286. <param name="offset">The buffer offset.</param>
  30287. <param name="count">The number of bytes to read.</param>
  30288. <exception cref="T:System.ArgumentNullException">
  30289. <paramref name="buffer"/> is <c>null</c>.
  30290. </exception>
  30291. <exception cref="T:System.ArgumentOutOfRangeException">
  30292. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  30293. <para>-or-</para>
  30294. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  30295. at the specified <paramref name="offset"/>.</para>
  30296. </exception>
  30297. <exception cref="T:System.ObjectDisposedException">
  30298. The stream has been disposed.
  30299. </exception>
  30300. <exception cref="T:System.IO.IOException">
  30301. An I/O error occurred.
  30302. </exception>
  30303. </member>
  30304. <member name="M:MailKit.DuplexStream.ReadAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  30305. <summary>
  30306. Reads a sequence of bytes from the stream and advances the position
  30307. within the stream by the number of bytes read.
  30308. </summary>
  30309. <returns>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many
  30310. bytes are not currently available, or zero (0) if the end of the stream has been reached.</returns>
  30311. <param name="buffer">The buffer.</param>
  30312. <param name="offset">The buffer offset.</param>
  30313. <param name="count">The number of bytes to read.</param>
  30314. <param name="cancellationToken">The cancellation token.</param>
  30315. <exception cref="T:System.ArgumentNullException">
  30316. <paramref name="buffer"/> is <c>null</c>.
  30317. </exception>
  30318. <exception cref="T:System.ArgumentOutOfRangeException">
  30319. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  30320. <para>-or-</para>
  30321. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  30322. at the specified <paramref name="offset"/>.</para>
  30323. </exception>
  30324. <exception cref="T:System.ObjectDisposedException">
  30325. The stream has been disposed.
  30326. </exception>
  30327. <exception cref="T:System.IO.IOException">
  30328. An I/O error occurred.
  30329. </exception>
  30330. </member>
  30331. <member name="M:MailKit.DuplexStream.Write(System.Byte[],System.Int32,System.Int32)">
  30332. <summary>
  30333. Writes a sequence of bytes to the stream and advances the current
  30334. position within this stream by the number of bytes written.
  30335. </summary>
  30336. <param name="buffer">The buffer to write.</param>
  30337. <param name="offset">The offset of the first byte to write.</param>
  30338. <param name="count">The number of bytes to write.</param>
  30339. <exception cref="T:System.ArgumentNullException">
  30340. <paramref name="buffer"/> is <c>null</c>.
  30341. </exception>
  30342. <exception cref="T:System.ArgumentOutOfRangeException">
  30343. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  30344. <para>-or-</para>
  30345. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  30346. at the specified <paramref name="offset"/>.</para>
  30347. </exception>
  30348. <exception cref="T:System.ObjectDisposedException">
  30349. The stream has been disposed.
  30350. </exception>
  30351. <exception cref="T:System.NotSupportedException">
  30352. The stream does not support writing.
  30353. </exception>
  30354. <exception cref="T:System.IO.IOException">
  30355. An I/O error occurred.
  30356. </exception>
  30357. </member>
  30358. <member name="M:MailKit.DuplexStream.WriteAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  30359. <summary>
  30360. Writes a sequence of bytes to the stream and advances the current
  30361. position within this stream by the number of bytes written.
  30362. </summary>
  30363. <returns>A task that represents the asynchronous write operation.</returns>
  30364. <param name="buffer">The buffer to write.</param>
  30365. <param name="offset">The offset of the first byte to write.</param>
  30366. <param name="count">The number of bytes to write.</param>
  30367. <param name="cancellationToken">The cancellation token.</param>
  30368. <exception cref="T:System.ArgumentNullException">
  30369. <paramref name="buffer"/> is <c>null</c>.
  30370. </exception>
  30371. <exception cref="T:System.ArgumentOutOfRangeException">
  30372. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  30373. <para>-or-</para>
  30374. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  30375. at the specified <paramref name="offset"/>.</para>
  30376. </exception>
  30377. <exception cref="T:System.ObjectDisposedException">
  30378. The stream has been disposed.
  30379. </exception>
  30380. <exception cref="T:System.NotSupportedException">
  30381. The stream does not support writing.
  30382. </exception>
  30383. <exception cref="T:System.IO.IOException">
  30384. An I/O error occurred.
  30385. </exception>
  30386. </member>
  30387. <member name="M:MailKit.DuplexStream.Flush">
  30388. <summary>
  30389. Clears all output buffers for this stream and causes any buffered data to be written
  30390. to the underlying device.
  30391. </summary>
  30392. <exception cref="T:System.ObjectDisposedException">
  30393. The stream has been disposed.
  30394. </exception>
  30395. <exception cref="T:System.NotSupportedException">
  30396. The stream does not support writing.
  30397. </exception>
  30398. <exception cref="T:System.IO.IOException">
  30399. An I/O error occurred.
  30400. </exception>
  30401. </member>
  30402. <member name="M:MailKit.DuplexStream.FlushAsync(System.Threading.CancellationToken)">
  30403. <summary>
  30404. Clears all output buffers for this stream and causes any buffered data to be written
  30405. to the underlying device.
  30406. </summary>
  30407. <returns>A task that represents the asynchronous flush operation.</returns>
  30408. <param name="cancellationToken">The cancellation token.</param>
  30409. <exception cref="T:System.ObjectDisposedException">
  30410. The stream has been disposed.
  30411. </exception>
  30412. <exception cref="T:System.NotSupportedException">
  30413. The stream does not support writing.
  30414. </exception>
  30415. <exception cref="T:System.IO.IOException">
  30416. An I/O error occurred.
  30417. </exception>
  30418. </member>
  30419. <member name="M:MailKit.DuplexStream.Seek(System.Int64,System.IO.SeekOrigin)">
  30420. <summary>
  30421. Sets the position within the current stream.
  30422. </summary>
  30423. <returns>The new position within the stream.</returns>
  30424. <param name="offset">The offset into the stream relative to the <paramref name="origin"/>.</param>
  30425. <param name="origin">The origin to seek from.</param>
  30426. <exception cref="T:System.NotSupportedException">
  30427. The stream does not support seeking.
  30428. </exception>
  30429. </member>
  30430. <member name="M:MailKit.DuplexStream.SetLength(System.Int64)">
  30431. <summary>
  30432. Sets the length of the stream.
  30433. </summary>
  30434. <param name="value">The desired length of the stream in bytes.</param>
  30435. <exception cref="T:System.NotSupportedException">
  30436. The stream does not support setting the length.
  30437. </exception>
  30438. </member>
  30439. <member name="M:MailKit.DuplexStream.Dispose(System.Boolean)">
  30440. <summary>
  30441. Releases the unmanaged resources used by the <see cref="T:MailKit.DuplexStream"/> and
  30442. optionally releases the managed resources.
  30443. </summary>
  30444. <param name="disposing"><c>true</c> to release both managed and unmanaged resources;
  30445. <c>false</c> to release only the unmanaged resources.</param>
  30446. </member>
  30447. <member name="T:MailKit.Envelope">
  30448. <summary>
  30449. A message envelope containing a brief summary of the message.
  30450. </summary>
  30451. <remarks>
  30452. The envelope of a message contains information such as the
  30453. date the message was sent, the subject of the message,
  30454. the sender of the message, who the message was sent to,
  30455. which message(s) the message may be in reply to,
  30456. and the message id.
  30457. </remarks>
  30458. </member>
  30459. <member name="M:MailKit.Envelope.#ctor">
  30460. <summary>
  30461. Initializes a new instance of the <see cref="T:MailKit.Envelope"/> class.
  30462. </summary>
  30463. <remarks>
  30464. Creates a new <see cref="T:MailKit.Envelope"/>.
  30465. </remarks>
  30466. </member>
  30467. <member name="P:MailKit.Envelope.From">
  30468. <summary>
  30469. Gets the address(es) that the message is from.
  30470. </summary>
  30471. <remarks>
  30472. Gets the address(es) that the message is from.
  30473. </remarks>
  30474. <value>The address(es) that the message is from.</value>
  30475. </member>
  30476. <member name="P:MailKit.Envelope.Sender">
  30477. <summary>
  30478. Gets the actual sender(s) of the message.
  30479. </summary>
  30480. <remarks>
  30481. The senders may differ from the addresses in <see cref="P:MailKit.Envelope.From"/> if
  30482. the message was sent by someone on behalf of someone else.
  30483. </remarks>
  30484. <value>The actual sender(s) of the message.</value>
  30485. </member>
  30486. <member name="P:MailKit.Envelope.ReplyTo">
  30487. <summary>
  30488. Gets the address(es) that replies should be sent to.
  30489. </summary>
  30490. <remarks>
  30491. The senders of the message may prefer that replies are sent
  30492. somewhere other than the address they used to send the message.
  30493. </remarks>
  30494. <value>The address(es) that replies should be sent to.</value>
  30495. </member>
  30496. <member name="P:MailKit.Envelope.To">
  30497. <summary>
  30498. Gets the list of addresses that the message was sent to.
  30499. </summary>
  30500. <remarks>
  30501. Gets the list of addresses that the message was sent to.
  30502. </remarks>
  30503. <value>The address(es) that the message was sent to.</value>
  30504. </member>
  30505. <member name="P:MailKit.Envelope.Cc">
  30506. <summary>
  30507. Gets the list of addresses that the message was carbon-copied to.
  30508. </summary>
  30509. <remarks>
  30510. Gets the list of addresses that the message was carbon-copied to.
  30511. </remarks>
  30512. <value>The address(es) that the message was carbon-copied to.</value>
  30513. </member>
  30514. <member name="P:MailKit.Envelope.Bcc">
  30515. <summary>
  30516. Gets the list of addresses that the message was blind-carbon-copied to.
  30517. </summary>
  30518. <remarks>
  30519. Gets the list of addresses that the message was blind-carbon-copied to.
  30520. </remarks>
  30521. <value>The address(es) that the message was carbon-copied to.</value>
  30522. </member>
  30523. <member name="P:MailKit.Envelope.InReplyTo">
  30524. <summary>
  30525. The Message-Id that the message is replying to.
  30526. </summary>
  30527. <remarks>
  30528. The Message-Id that the message is replying to.
  30529. </remarks>
  30530. <value>The Message-Id that the message is replying to.</value>
  30531. </member>
  30532. <member name="P:MailKit.Envelope.Date">
  30533. <summary>
  30534. Gets the date that the message was sent on, if available.
  30535. </summary>
  30536. <remarks>
  30537. Gets the date that the message was sent on, if available.
  30538. </remarks>
  30539. <value>The date the message was sent.</value>
  30540. </member>
  30541. <member name="P:MailKit.Envelope.MessageId">
  30542. <summary>
  30543. Gets the ID of the message, if available.
  30544. </summary>
  30545. <remarks>
  30546. Gets the ID of the message, if available.
  30547. </remarks>
  30548. <value>The message identifier.</value>
  30549. </member>
  30550. <member name="P:MailKit.Envelope.Subject">
  30551. <summary>
  30552. Gets the subject of the message.
  30553. </summary>
  30554. <remarks>
  30555. Gets the subject of the message.
  30556. </remarks>
  30557. <value>The subject.</value>
  30558. </member>
  30559. <member name="M:MailKit.Envelope.ToString">
  30560. <summary>
  30561. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.Envelope"/>.
  30562. </summary>
  30563. <remarks>
  30564. <para>The returned string can be parsed by <see cref="M:MailKit.Envelope.TryParse(System.String,MailKit.Envelope@)"/>.</para>
  30565. <note type="warning">The syntax of the string returned, while similar to IMAP's ENVELOPE syntax,
  30566. is not completely compatible.</note>
  30567. </remarks>
  30568. <returns>A <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.Envelope"/>.</returns>
  30569. </member>
  30570. <member name="M:MailKit.Envelope.TryParse(System.String,MailKit.Envelope@)">
  30571. <summary>
  30572. Tries to parse the given text into a new <see cref="T:MailKit.Envelope"/> instance.
  30573. </summary>
  30574. <remarks>
  30575. <para>Parses an Envelope value from the specified text.</para>
  30576. <note type="warning">This syntax, while similar to IMAP's ENVELOPE syntax, is not
  30577. completely compatible.</note>
  30578. </remarks>
  30579. <returns><c>true</c>, if the envelope was successfully parsed, <c>false</c> otherwise.</returns>
  30580. <param name="text">The text to parse.</param>
  30581. <param name="envelope">The parsed envelope.</param>
  30582. <exception cref="T:System.ArgumentNullException">
  30583. <paramref name="text"/> is <c>null</c>.
  30584. </exception>
  30585. </member>
  30586. <member name="T:MailKit.FolderAccess">
  30587. <summary>
  30588. A folder access mode.
  30589. </summary>
  30590. <remarks>
  30591. A folder access mode.
  30592. </remarks>
  30593. <example>
  30594. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadMessages"/>
  30595. </example>
  30596. </member>
  30597. <member name="F:MailKit.FolderAccess.None">
  30598. <summary>
  30599. The folder is not open.
  30600. </summary>
  30601. </member>
  30602. <member name="F:MailKit.FolderAccess.ReadOnly">
  30603. <summary>
  30604. The folder is read-only.
  30605. </summary>
  30606. </member>
  30607. <member name="F:MailKit.FolderAccess.ReadWrite">
  30608. <summary>
  30609. The folder is read/write.
  30610. </summary>
  30611. </member>
  30612. <member name="T:MailKit.FolderAttributes">
  30613. <summary>
  30614. Folder attributes as used by <see cref="P:MailKit.IMailFolder.Attributes"/>.
  30615. </summary>
  30616. <remarks>
  30617. Folder attributes as used by <see cref="P:MailKit.IMailFolder.Attributes"/>.
  30618. </remarks>
  30619. </member>
  30620. <member name="F:MailKit.FolderAttributes.None">
  30621. <summary>
  30622. The folder does not have any attributes.
  30623. </summary>
  30624. </member>
  30625. <member name="F:MailKit.FolderAttributes.NoInferiors">
  30626. <summary>
  30627. It is not possible for any subfolders to exist under the folder.
  30628. </summary>
  30629. </member>
  30630. <member name="F:MailKit.FolderAttributes.NoSelect">
  30631. <summary>
  30632. It is not possible to select the folder.
  30633. </summary>
  30634. </member>
  30635. <member name="F:MailKit.FolderAttributes.Marked">
  30636. <summary>
  30637. The folder has been marked as possibly containing new messages
  30638. since the folder was last selected.
  30639. </summary>
  30640. </member>
  30641. <member name="F:MailKit.FolderAttributes.Unmarked">
  30642. <summary>
  30643. The folder does not contain any new messages since the folder
  30644. was last selected.
  30645. </summary>
  30646. </member>
  30647. <member name="F:MailKit.FolderAttributes.NonExistent">
  30648. <summary>
  30649. The folder does not exist, but is simply a place-holder.
  30650. </summary>
  30651. </member>
  30652. <member name="F:MailKit.FolderAttributes.Subscribed">
  30653. <summary>
  30654. The folder is subscribed.
  30655. </summary>
  30656. </member>
  30657. <member name="F:MailKit.FolderAttributes.Remote">
  30658. <summary>
  30659. The folder is remote.
  30660. </summary>
  30661. </member>
  30662. <member name="F:MailKit.FolderAttributes.HasChildren">
  30663. <summary>
  30664. The folder has subfolders.
  30665. </summary>
  30666. </member>
  30667. <member name="F:MailKit.FolderAttributes.HasNoChildren">
  30668. <summary>
  30669. The folder does not have any subfolders.
  30670. </summary>
  30671. </member>
  30672. <member name="F:MailKit.FolderAttributes.All">
  30673. <summary>
  30674. The folder is a special "All" folder containing an aggregate of all messages.
  30675. </summary>
  30676. </member>
  30677. <member name="F:MailKit.FolderAttributes.Archive">
  30678. <summary>
  30679. The folder is a special "Archive" folder.
  30680. </summary>
  30681. </member>
  30682. <member name="F:MailKit.FolderAttributes.Drafts">
  30683. <summary>
  30684. The folder is the special "Drafts" folder.
  30685. </summary>
  30686. </member>
  30687. <member name="F:MailKit.FolderAttributes.Flagged">
  30688. <summary>
  30689. The folder is the special "Flagged" folder.
  30690. </summary>
  30691. </member>
  30692. <member name="F:MailKit.FolderAttributes.Inbox">
  30693. <summary>
  30694. The folder is the special "Inbox" folder.
  30695. </summary>
  30696. </member>
  30697. <member name="F:MailKit.FolderAttributes.Junk">
  30698. <summary>
  30699. The folder is the special "Junk" folder.
  30700. </summary>
  30701. </member>
  30702. <member name="F:MailKit.FolderAttributes.Sent">
  30703. <summary>
  30704. The folder is the special "Sent" folder.
  30705. </summary>
  30706. </member>
  30707. <member name="F:MailKit.FolderAttributes.Trash">
  30708. <summary>
  30709. The folder is the special "Trash" folder.
  30710. </summary>
  30711. </member>
  30712. <member name="T:MailKit.FolderCreatedEventArgs">
  30713. <summary>
  30714. Event args used when a <see cref="T:MailKit.IMailFolder"/> is created.
  30715. </summary>
  30716. <remarks>
  30717. Event args used when a <see cref="T:MailKit.IMailFolder"/> is created.
  30718. </remarks>
  30719. </member>
  30720. <member name="M:MailKit.FolderCreatedEventArgs.#ctor(MailKit.IMailFolder)">
  30721. <summary>
  30722. Initializes a new instance of the <see cref="T:MailKit.FolderCreatedEventArgs"/> class.
  30723. </summary>
  30724. <remarks>
  30725. Creates a new <see cref="T:MailKit.FolderCreatedEventArgs"/>.
  30726. </remarks>
  30727. <param name="folder">The newly created folder.</param>
  30728. <exception cref="T:System.ArgumentNullException">
  30729. <paramref name="folder"/> is <c>null</c>.
  30730. </exception>
  30731. </member>
  30732. <member name="P:MailKit.FolderCreatedEventArgs.Folder">
  30733. <summary>
  30734. Get the folder that was just created.
  30735. </summary>
  30736. <remarks>
  30737. Gets the folder that was just created.
  30738. </remarks>
  30739. <value>The folder.</value>
  30740. </member>
  30741. <member name="T:MailKit.FolderNamespace">
  30742. <summary>
  30743. A folder namespace.
  30744. </summary>
  30745. <remarks>
  30746. A folder namespace.
  30747. </remarks>
  30748. </member>
  30749. <member name="F:MailKit.FolderNamespace.DirectorySeparator">
  30750. <summary>
  30751. The directory separator for this folder namespace.
  30752. </summary>
  30753. <remarks>
  30754. The directory separator for this folder namespace.
  30755. </remarks>
  30756. </member>
  30757. <member name="F:MailKit.FolderNamespace.Path">
  30758. <summary>
  30759. The base path for this folder namespace.
  30760. </summary>
  30761. <remarks>
  30762. The base path for this folder namespace.
  30763. </remarks>
  30764. </member>
  30765. <member name="M:MailKit.FolderNamespace.#ctor(System.Char,System.String)">
  30766. <summary>
  30767. Initializes a new instance of the <see cref="T:MailKit.FolderNamespace"/> class.
  30768. </summary>
  30769. <remarks>
  30770. Creates a new folder namespace.
  30771. </remarks>
  30772. <param name="directorySeparator">The directory separator.</param>
  30773. <param name="path">The folder path.</param>
  30774. <exception cref="T:System.ArgumentNullException">
  30775. <paramref name="path"/> is <c>null</c>.
  30776. </exception>
  30777. </member>
  30778. <member name="T:MailKit.FolderNamespaceCollection">
  30779. <summary>
  30780. A read-only collection of folder namespaces.
  30781. </summary>
  30782. <remarks>
  30783. A read-only collection of folder namespaces.
  30784. </remarks>
  30785. </member>
  30786. <member name="M:MailKit.FolderNamespaceCollection.#ctor">
  30787. <summary>
  30788. Initializes a new instance of the <see cref="T:MailKit.FolderNamespaceCollection"/> class.
  30789. </summary>
  30790. <remarks>
  30791. Creates a new <see cref="T:MailKit.FolderNamespaceCollection"/>.
  30792. </remarks>
  30793. </member>
  30794. <member name="P:MailKit.FolderNamespaceCollection.Count">
  30795. <summary>
  30796. Gets the number of folder namespaces contained in the collection.
  30797. </summary>
  30798. <remarks>
  30799. Gets the number of folder namespaces contained in the collection.
  30800. </remarks>
  30801. <value>The count.</value>
  30802. </member>
  30803. <member name="M:MailKit.FolderNamespaceCollection.Add(MailKit.FolderNamespace)">
  30804. <summary>
  30805. Adds the specified namespace.
  30806. </summary>
  30807. <remarks>
  30808. Adds the specified namespace.
  30809. </remarks>
  30810. <param name="namespace">The namespace to add.</param>
  30811. <exception cref="T:System.ArgumentNullException">
  30812. <paramref name="namespace"/> is <c>null</c>.
  30813. </exception>
  30814. </member>
  30815. <member name="M:MailKit.FolderNamespaceCollection.Clear">
  30816. <summary>
  30817. Removes all namespaces from the collection.
  30818. </summary>
  30819. <remarks>
  30820. Removes all namespaces from the collection.
  30821. </remarks>
  30822. </member>
  30823. <member name="M:MailKit.FolderNamespaceCollection.Contains(MailKit.FolderNamespace)">
  30824. <summary>
  30825. Checks if the collection contains the specified namespace.
  30826. </summary>
  30827. <remarks>
  30828. Checks if the collection contains the specified namespace.
  30829. </remarks>
  30830. <returns><value>true</value> if the specified namespace exists;
  30831. otherwise <value>false</value>.</returns>
  30832. <param name="namespace">The namespace.</param>
  30833. <exception cref="T:System.ArgumentNullException">
  30834. <paramref name="namespace"/> is <c>null</c>.
  30835. </exception>
  30836. </member>
  30837. <member name="M:MailKit.FolderNamespaceCollection.Remove(MailKit.FolderNamespace)">
  30838. <summary>
  30839. Removes the first occurance of the specified namespace.
  30840. </summary>
  30841. <remarks>
  30842. Removes the first occurance of the specified namespace.
  30843. </remarks>
  30844. <returns><value>true</value> if the frst occurance of the specified
  30845. namespace was removed; otherwise <value>false</value>.</returns>
  30846. <param name="namespace">The namespace.</param>
  30847. <exception cref="T:System.ArgumentNullException">
  30848. <paramref name="namespace"/> is <c>null</c>.
  30849. </exception>
  30850. </member>
  30851. <member name="P:MailKit.FolderNamespaceCollection.Item(System.Int32)">
  30852. <summary>
  30853. Gets the <see cref="T:MailKit.FolderNamespace"/> at the specified index.
  30854. </summary>
  30855. <remarks>
  30856. Gets the <see cref="T:MailKit.FolderNamespace"/> at the specified index.
  30857. </remarks>
  30858. <value>The folder namespace at the specified index.</value>
  30859. <param name="index">The index.</param>
  30860. <exception cref="T:System.ArgumentNullException">
  30861. <paramref name="value"/> is <c>null</c>.
  30862. </exception>
  30863. <exception cref="T:System.ArgumentOutOfRangeException">
  30864. <paramref name="index"/> is out of range.
  30865. </exception>
  30866. </member>
  30867. <member name="M:MailKit.FolderNamespaceCollection.GetEnumerator">
  30868. <summary>
  30869. Gets the enumerator.
  30870. </summary>
  30871. <remarks>
  30872. Gets the enumerator.
  30873. </remarks>
  30874. <returns>The enumerator.</returns>
  30875. </member>
  30876. <member name="M:MailKit.FolderNamespaceCollection.System#Collections#IEnumerable#GetEnumerator">
  30877. <summary>
  30878. Gets the enumerator.
  30879. </summary>
  30880. <remarks>
  30881. Gets the enumerator.
  30882. </remarks>
  30883. <returns>The enumerator.</returns>
  30884. </member>
  30885. <member name="M:MailKit.FolderNamespaceCollection.ToString">
  30886. <summary>
  30887. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.FolderNamespaceCollection"/>.
  30888. </summary>
  30889. <remarks>
  30890. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.FolderNamespaceCollection"/>.
  30891. </remarks>
  30892. <returns>A <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.FolderNamespaceCollection"/>.</returns>
  30893. </member>
  30894. <member name="T:MailKit.FolderNotFoundException">
  30895. <summary>
  30896. The exception that is thrown when a folder could not be found.
  30897. </summary>
  30898. <remarks>
  30899. This exception is thrown by <see cref="M:MailKit.IMailFolder.GetSubfolder(System.String,System.Threading.CancellationToken)"/>.
  30900. </remarks>
  30901. </member>
  30902. <member name="M:MailKit.FolderNotFoundException.#ctor(System.String,System.String,System.Exception)">
  30903. <summary>
  30904. Initializes a new instance of the <see cref="T:MailKit.FolderNotFoundException"/> class.
  30905. </summary>
  30906. <remarks>
  30907. Creates a new <see cref="T:MailKit.FolderNotFoundException"/>.
  30908. </remarks>
  30909. <param name="message">The error message.</param>
  30910. <param name="folderName">The name of the folder.</param>
  30911. <param name="innerException">The inner exception.</param>
  30912. <exception cref="T:System.ArgumentNullException">
  30913. <paramref name="folderName"/> is <c>null</c>.
  30914. </exception>
  30915. </member>
  30916. <member name="M:MailKit.FolderNotFoundException.#ctor(System.String,System.String)">
  30917. <summary>
  30918. Initializes a new instance of the <see cref="T:MailKit.FolderNotFoundException"/> class.
  30919. </summary>
  30920. <remarks>
  30921. Creates a new <see cref="T:MailKit.FolderNotFoundException"/>.
  30922. </remarks>
  30923. <param name="message">The error message.</param>
  30924. <param name="folderName">The name of the folder.</param>
  30925. <exception cref="T:System.ArgumentNullException">
  30926. <paramref name="folderName"/> is <c>null</c>.
  30927. </exception>
  30928. </member>
  30929. <member name="M:MailKit.FolderNotFoundException.#ctor(System.String)">
  30930. <summary>
  30931. Initializes a new instance of the <see cref="T:MailKit.FolderNotFoundException"/> class.
  30932. </summary>
  30933. <remarks>
  30934. Creates a new <see cref="T:MailKit.FolderNotFoundException"/>.
  30935. </remarks>
  30936. <param name="folderName">The name of the folder.</param>
  30937. <exception cref="T:System.ArgumentNullException">
  30938. <paramref name="folderName"/> is <c>null</c>.
  30939. </exception>
  30940. </member>
  30941. <member name="P:MailKit.FolderNotFoundException.FolderName">
  30942. <summary>
  30943. Gets the name of the folder that could not be found.
  30944. </summary>
  30945. <remarks>
  30946. Gets the name of the folder that could not be found.
  30947. </remarks>
  30948. <value>The name of the folder.</value>
  30949. </member>
  30950. <member name="T:MailKit.FolderNotOpenException">
  30951. <summary>
  30952. The exception that is thrown when a folder is not open.
  30953. </summary>
  30954. <remarks>
  30955. This exception is thrown when an operation on a folder could not be completed
  30956. due to the folder being in a closed state. For example, the
  30957. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>
  30958. method will throw a <see cref="T:MailKit.FolderNotOpenException"/> if the folder is not
  30959. current open.
  30960. </remarks>
  30961. </member>
  30962. <member name="M:MailKit.FolderNotOpenException.#ctor(System.String,MailKit.FolderAccess,System.String,System.Exception)">
  30963. <summary>
  30964. Initializes a new instance of the <see cref="T:MailKit.FolderNotOpenException"/> class.
  30965. </summary>
  30966. <remarks>
  30967. Creates a new <see cref="T:MailKit.FolderNotOpenException"/>.
  30968. </remarks>
  30969. <param name="folderName">The folder name.</param>
  30970. <param name="access">The minimum folder access required by the operation.</param>
  30971. <param name="message">The error message.</param>
  30972. <param name="innerException">The inner exception.</param>
  30973. <exception cref="T:System.ArgumentNullException">
  30974. <paramref name="folderName"/> is <c>null</c>.
  30975. </exception>
  30976. </member>
  30977. <member name="M:MailKit.FolderNotOpenException.#ctor(System.String,MailKit.FolderAccess,System.String)">
  30978. <summary>
  30979. Initializes a new instance of the <see cref="T:MailKit.FolderNotOpenException"/> class.
  30980. </summary>
  30981. <remarks>
  30982. Creates a new <see cref="T:MailKit.FolderNotOpenException"/>.
  30983. </remarks>
  30984. <param name="folderName">The folder name.</param>
  30985. <param name="access">The minimum folder access required by the operation.</param>
  30986. <param name="message">The error message.</param>
  30987. <exception cref="T:System.ArgumentNullException">
  30988. <paramref name="folderName"/> is <c>null</c>.
  30989. </exception>
  30990. </member>
  30991. <member name="M:MailKit.FolderNotOpenException.#ctor(System.String,MailKit.FolderAccess)">
  30992. <summary>
  30993. Initializes a new instance of the <see cref="T:MailKit.FolderNotOpenException"/> class.
  30994. </summary>
  30995. <remarks>
  30996. Creates a new <see cref="T:MailKit.FolderNotOpenException"/>.
  30997. </remarks>
  30998. <param name="folderName">The folder name.</param>
  30999. <param name="access">The minimum folder access required by the operation.</param>
  31000. <exception cref="T:System.ArgumentNullException">
  31001. <paramref name="folderName"/> is <c>null</c>.
  31002. </exception>
  31003. </member>
  31004. <member name="P:MailKit.FolderNotOpenException.FolderName">
  31005. <summary>
  31006. Get the name of the folder.
  31007. </summary>
  31008. <remarks>
  31009. Gets the name of the folder.
  31010. </remarks>
  31011. <value>The name of the folder.</value>
  31012. </member>
  31013. <member name="P:MailKit.FolderNotOpenException.FolderAccess">
  31014. <summary>
  31015. Get the minimum folder access required by the operation.
  31016. </summary>
  31017. <remarks>
  31018. Gets the minimum folder access required by the operation.
  31019. </remarks>
  31020. <value>The minimum required folder access.</value>
  31021. </member>
  31022. <member name="T:MailKit.FolderQuota">
  31023. <summary>
  31024. A folder quota.
  31025. </summary>
  31026. <remarks>
  31027. A <see cref="T:MailKit.FolderQuota"/> is returned by <see cref="M:MailKit.IMailFolder.GetQuota(System.Threading.CancellationToken)"/>.
  31028. </remarks>
  31029. <example>
  31030. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  31031. </example>
  31032. </member>
  31033. <member name="M:MailKit.FolderQuota.#ctor(MailKit.IMailFolder)">
  31034. <summary>
  31035. Initializes a new instance of the <see cref="T:MailKit.FolderQuota"/> class.
  31036. </summary>
  31037. <remarks>
  31038. Creates a new <see cref="T:MailKit.FolderQuota"/> with the specified root.
  31039. </remarks>
  31040. <param name="quotaRoot">The quota root.</param>
  31041. </member>
  31042. <member name="P:MailKit.FolderQuota.QuotaRoot">
  31043. <summary>
  31044. Get the quota root.
  31045. </summary>
  31046. <remarks>
  31047. Gets the quota root. If the quota root is <c>null</c>, then
  31048. it suggests that the folder does not have a quota.
  31049. </remarks>
  31050. <example>
  31051. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  31052. </example>
  31053. <value>The quota root.</value>
  31054. </member>
  31055. <member name="P:MailKit.FolderQuota.MessageLimit">
  31056. <summary>
  31057. Get or set the message limit.
  31058. </summary>
  31059. <remarks>
  31060. Gets or sets the message limit.
  31061. </remarks>
  31062. <example>
  31063. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  31064. </example>
  31065. <value>The message limit.</value>
  31066. </member>
  31067. <member name="P:MailKit.FolderQuota.StorageLimit">
  31068. <summary>
  31069. Get or set the storage limit, in kilobytes.
  31070. </summary>
  31071. <remarks>
  31072. Gets or sets the storage limit, in kilobytes.
  31073. </remarks>
  31074. <example>
  31075. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  31076. </example>
  31077. <value>The storage limit, in kilobytes.</value>
  31078. </member>
  31079. <member name="P:MailKit.FolderQuota.CurrentMessageCount">
  31080. <summary>
  31081. Get or set the current message count.
  31082. </summary>
  31083. <remarks>
  31084. Gets or sets the current message count.
  31085. </remarks>
  31086. <example>
  31087. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  31088. </example>
  31089. <value>The current message count.</value>
  31090. </member>
  31091. <member name="P:MailKit.FolderQuota.CurrentStorageSize">
  31092. <summary>
  31093. Gets or sets the size of the current storage, in kilobytes.
  31094. </summary>
  31095. <remarks>
  31096. Gets or sets the size of the current storage, in kilobytes.
  31097. </remarks>
  31098. <example>
  31099. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  31100. </example>
  31101. <value>The size of the current storage, in kilobytes.</value>
  31102. </member>
  31103. <member name="T:MailKit.FolderRenamedEventArgs">
  31104. <summary>
  31105. Event args used when a <see cref="T:MailKit.IMailFolder"/> is renamed.
  31106. </summary>
  31107. <remarks>
  31108. Event args used when a <see cref="T:MailKit.IMailFolder"/> is renamed.
  31109. </remarks>
  31110. </member>
  31111. <member name="M:MailKit.FolderRenamedEventArgs.#ctor(System.String,System.String)">
  31112. <summary>
  31113. Initializes a new instance of the <see cref="T:MailKit.FolderRenamedEventArgs"/> class.
  31114. </summary>
  31115. <remarks>
  31116. Creates a new <see cref="T:MailKit.FolderRenamedEventArgs"/>.
  31117. </remarks>
  31118. <param name="oldName">The old name of the folder.</param>
  31119. <param name="newName">The new name of the folder.</param>
  31120. <exception cref="T:System.ArgumentNullException">
  31121. <para><paramref name="oldName"/> is <c>null</c>.</para>
  31122. <para>-or-</para>
  31123. <para><paramref name="newName"/> is <c>null</c>.</para>
  31124. </exception>
  31125. </member>
  31126. <member name="P:MailKit.FolderRenamedEventArgs.OldName">
  31127. <summary>
  31128. The old name of the folder.
  31129. </summary>
  31130. <remarks>
  31131. The old name of the folder.
  31132. </remarks>
  31133. <value>The old name.</value>
  31134. </member>
  31135. <member name="P:MailKit.FolderRenamedEventArgs.NewName">
  31136. <summary>
  31137. The new name of the folder.
  31138. </summary>
  31139. <remarks>
  31140. The new name of the folder.
  31141. </remarks>
  31142. <value>The new name.</value>
  31143. </member>
  31144. <member name="T:MailKit.IMailFolder">
  31145. <summary>
  31146. An interface for a mailbox folder as used by <see cref="T:MailKit.IMailStore"/>.
  31147. </summary>
  31148. <remarks>
  31149. Implemented by message stores such as <see cref="T:MailKit.Net.Imap.ImapClient"/>
  31150. </remarks>
  31151. </member>
  31152. <member name="P:MailKit.IMailFolder.SyncRoot">
  31153. <summary>
  31154. Gets an object that can be used to synchronize access to the folder.
  31155. </summary>
  31156. <remarks>
  31157. Gets an object that can be used to synchronize access to the folder.
  31158. </remarks>
  31159. <value>The sync root.</value>
  31160. </member>
  31161. <member name="P:MailKit.IMailFolder.ParentFolder">
  31162. <summary>
  31163. Get the parent folder.
  31164. </summary>
  31165. <remarks>
  31166. Root-level folders do not have a parent folder.
  31167. </remarks>
  31168. <value>The parent folder.</value>
  31169. </member>
  31170. <member name="P:MailKit.IMailFolder.Attributes">
  31171. <summary>
  31172. Get the folder attributes.
  31173. </summary>
  31174. <remarks>
  31175. Gets the folder attributes.
  31176. </remarks>
  31177. <value>The folder attributes.</value>
  31178. </member>
  31179. <member name="P:MailKit.IMailFolder.AnnotationAccess">
  31180. <summary>
  31181. Get the annotation access level.
  31182. </summary>
  31183. <remarks>
  31184. If annotations are supported, this property can be used to determine whether or not
  31185. the <see cref="T:MailKit.IMailFolder"/> supports reading and writing annotations.
  31186. </remarks>
  31187. </member>
  31188. <member name="P:MailKit.IMailFolder.AnnotationScopes">
  31189. <summary>
  31190. Get the supported annotation scopes.
  31191. </summary>
  31192. <remarks>
  31193. If annotations are supported, this property can be used to determine which
  31194. annotation scopes are supported by the <see cref="T:MailKit.IMailFolder"/>.
  31195. </remarks>
  31196. </member>
  31197. <member name="P:MailKit.IMailFolder.MaxAnnotationSize">
  31198. <summary>
  31199. Get the maximum size of annotation values supported by the folder.
  31200. </summary>
  31201. <remarks>
  31202. If annotations are supported, this property can be used to determine the
  31203. maximum size of annotation values supported by the <see cref="T:MailKit.IMailFolder"/>.
  31204. </remarks>
  31205. </member>
  31206. <member name="P:MailKit.IMailFolder.PermanentFlags">
  31207. <summary>
  31208. Get the permanent flags.
  31209. </summary>
  31210. <remarks>
  31211. <para>The permanent flags are the message flags that will persist between sessions.</para>
  31212. <para>If the <see cref="F:MailKit.MessageFlags.UserDefined"/> flag is set, then the folder allows
  31213. storing of user-defined (custom) message flags.</para>
  31214. </remarks>
  31215. <value>The permanent flags.</value>
  31216. </member>
  31217. <member name="P:MailKit.IMailFolder.AcceptedFlags">
  31218. <summary>
  31219. Get the accepted flags.
  31220. </summary>
  31221. <remarks>
  31222. The accepted flags are the message flags that will be accepted and persist
  31223. for the current session. For the set of flags that will persist between
  31224. sessions, see the <see cref="P:MailKit.IMailFolder.PermanentFlags"/> property.
  31225. </remarks>
  31226. <value>The accepted flags.</value>
  31227. </member>
  31228. <member name="P:MailKit.IMailFolder.DirectorySeparator">
  31229. <summary>
  31230. Get the directory separator.
  31231. </summary>
  31232. <remarks>
  31233. Gets the directory separator.
  31234. </remarks>
  31235. <value>The directory separator.</value>
  31236. </member>
  31237. <member name="P:MailKit.IMailFolder.Access">
  31238. <summary>
  31239. Get the read/write access of the folder.
  31240. </summary>
  31241. <remarks>
  31242. Gets the read/write access of the folder.
  31243. </remarks>
  31244. <value>The read/write access.</value>
  31245. </member>
  31246. <member name="P:MailKit.IMailFolder.IsNamespace">
  31247. <summary>
  31248. Get whether or not the folder is a namespace folder.
  31249. </summary>
  31250. <remarks>
  31251. Gets whether or not the folder is a namespace folder.
  31252. </remarks>
  31253. <value><c>true</c> if the folder is a namespace folder; otherwise, <c>false</c>.</value>
  31254. </member>
  31255. <member name="P:MailKit.IMailFolder.FullName">
  31256. <summary>
  31257. Get the full name of the folder.
  31258. </summary>
  31259. <remarks>
  31260. This is the equivalent of the full path of a file on a file system.
  31261. </remarks>
  31262. <value>The full name of the folder.</value>
  31263. </member>
  31264. <member name="P:MailKit.IMailFolder.Name">
  31265. <summary>
  31266. Get the name of the folder.
  31267. </summary>
  31268. <remarks>
  31269. This is the equivalent of the file name of a file on the file system.
  31270. </remarks>
  31271. <value>The name of the folder.</value>
  31272. </member>
  31273. <member name="P:MailKit.IMailFolder.Id">
  31274. <summary>
  31275. Get the unique identifier for the folder, if available.
  31276. </summary>
  31277. <remarks>
  31278. <para>Gets a unique identifier for the folder, if available. This is useful for clients
  31279. implementing a message cache that want to track the folder after it is renamed by another
  31280. client.</para>
  31281. <note type="note">This property will only be available if the server supports the
  31282. <a href="https://tools.ietf.org/html/rfc8474">OBJECTID</a> extension.</note>
  31283. </remarks>
  31284. <value>The unique folder identifier.</value>
  31285. </member>
  31286. <member name="P:MailKit.IMailFolder.IsSubscribed">
  31287. <summary>
  31288. Get whether or not the folder is subscribed.
  31289. </summary>
  31290. <remarks>
  31291. Gets whether or not the folder is subscribed.
  31292. </remarks>
  31293. <value><c>true</c> if the folder is subscribed; otherwise, <c>false</c>.</value>
  31294. </member>
  31295. <member name="P:MailKit.IMailFolder.IsOpen">
  31296. <summary>
  31297. Get whether or not the folder is currently open.
  31298. </summary>
  31299. <remarks>
  31300. Gets whether or not the folder is currently open.
  31301. </remarks>
  31302. <value><c>true</c> if the folder is currently open; otherwise, <c>false</c>.</value>
  31303. </member>
  31304. <member name="P:MailKit.IMailFolder.Exists">
  31305. <summary>
  31306. Get whether or not the folder exists.
  31307. </summary>
  31308. <remarks>
  31309. Gets whether or not the folder exists.
  31310. </remarks>
  31311. <value><c>true</c> if the folder exists; otherwise, <c>false</c>.</value>
  31312. </member>
  31313. <member name="P:MailKit.IMailFolder.SupportsModSeq">
  31314. <summary>
  31315. Get whether or not the folder supports mod-sequences.
  31316. </summary>
  31317. <remarks>
  31318. If mod-sequences are not supported by the folder, then all of the APIs that take a modseq
  31319. argument will throw <see cref="T:System.NotSupportedException"/> and should not be used.
  31320. </remarks>
  31321. <value><c>true</c> if supports mod-sequences; otherwise, <c>false</c>.</value>
  31322. </member>
  31323. <member name="P:MailKit.IMailFolder.HighestModSeq">
  31324. <summary>
  31325. Get the highest mod-sequence value of all messages in the mailbox.
  31326. </summary>
  31327. <remarks>
  31328. Gets the highest mod-sequence value of all messages in the mailbox.
  31329. </remarks>
  31330. <value>The highest mod-sequence value.</value>
  31331. </member>
  31332. <member name="P:MailKit.IMailFolder.UidValidity">
  31333. <summary>
  31334. Get the Unique ID validity.
  31335. </summary>
  31336. <remarks>
  31337. <para>UIDs are only valid so long as the UID validity value remains unchanged. If and when
  31338. the folder's <see cref="P:MailKit.IMailFolder.UidValidity"/> is changed, a client MUST discard its cache of UIDs
  31339. along with any summary information that it may have and re-query the folder.</para>
  31340. <para>The <see cref="P:MailKit.IMailFolder.UidValidity"/> will only be set after the folder has been opened.</para>
  31341. </remarks>
  31342. <value>The UID validity.</value>
  31343. </member>
  31344. <member name="P:MailKit.IMailFolder.UidNext">
  31345. <summary>
  31346. Get the UID that the next message that is added to the folder will be assigned.
  31347. </summary>
  31348. <remarks>
  31349. This value will only be set after the folder has been opened.
  31350. </remarks>
  31351. <value>The next UID.</value>
  31352. </member>
  31353. <member name="P:MailKit.IMailFolder.AppendLimit">
  31354. <summary>
  31355. Get the maximum size of a message that can be appended to the folder.
  31356. </summary>
  31357. <remarks>
  31358. <para>Gets the maximum size of a message that can be appended to the folder.</para>
  31359. <note type="note">If the value is not set, then the limit is unspecified.</note>
  31360. </remarks>
  31361. <value>The append limit.</value>
  31362. </member>
  31363. <member name="P:MailKit.IMailFolder.Size">
  31364. <summary>
  31365. Get the size of the folder.
  31366. </summary>
  31367. <remarks>
  31368. <para>Gets the size of the folder in bytes.</para>
  31369. <note type="note">If the value is not set, then the size is unspecified.</note>
  31370. </remarks>
  31371. <value>The size.</value>
  31372. </member>
  31373. <member name="P:MailKit.IMailFolder.FirstUnread">
  31374. <summary>
  31375. Get the index of the first unread message in the folder.
  31376. </summary>
  31377. <remarks>
  31378. This value will only be set after the folder has been opened.
  31379. </remarks>
  31380. <value>The index of the first unread message.</value>
  31381. </member>
  31382. <member name="P:MailKit.IMailFolder.Unread">
  31383. <summary>
  31384. Get the number of unread messages in the folder.
  31385. </summary>
  31386. <remarks>
  31387. <para>Gets the number of unread messages in the folder.</para>
  31388. <note type="note">This value will only be set after calling
  31389. <see cref="M:MailKit.IMailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/>
  31390. with <see cref="F:MailKit.StatusItems.Unread"/>.</note>
  31391. </remarks>
  31392. <value>The number of unread messages.</value>
  31393. </member>
  31394. <member name="P:MailKit.IMailFolder.Recent">
  31395. <summary>
  31396. Get the number of recently delivered messages in the folder.
  31397. </summary>
  31398. <remarks>
  31399. <para>Gets the number of recently delivered messages in the folder.</para>
  31400. <note type="note">
  31401. This value will only be set after calling
  31402. <see cref="M:MailKit.IMailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/>
  31403. with <see cref="F:MailKit.StatusItems.Recent"/>.</note>
  31404. </remarks>
  31405. <value>The number of recently delivered messages.</value>
  31406. </member>
  31407. <member name="P:MailKit.IMailFolder.Count">
  31408. <summary>
  31409. Get the total number of messages in the folder.
  31410. </summary>
  31411. <remarks>
  31412. Gets the total number of messages in the folder.
  31413. </remarks>
  31414. <value>The total number of messages.</value>
  31415. </member>
  31416. <member name="M:MailKit.IMailFolder.Open(MailKit.FolderAccess,System.UInt32,System.UInt64,System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)">
  31417. <summary>
  31418. Opens the folder using the requested folder access.
  31419. </summary>
  31420. <remarks>
  31421. <para>This variant of the <see cref="M:MailKit.IMailFolder.Open(MailKit.FolderAccess,System.Threading.CancellationToken)"/>
  31422. method is meant for quick resynchronization of the folder. Before calling this method,
  31423. the <see cref="M:MailKit.IMailStore.EnableQuickResync(System.Threading.CancellationToken)"/> method MUST be called.</para>
  31424. <para>You should also make sure to add listeners to the <see cref="E:MailKit.IMailFolder.MessagesVanished"/> and
  31425. <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events to get notifications of changes since
  31426. the last time the folder was opened.</para>
  31427. </remarks>
  31428. <returns>The <see cref="T:MailKit.FolderAccess"/> state of the folder.</returns>
  31429. <param name="access">The requested folder access.</param>
  31430. <param name="uidValidity">The last known <see cref="P:MailKit.IMailFolder.UidValidity"/> value.</param>
  31431. <param name="highestModSeq">The last known <see cref="P:MailKit.IMailFolder.HighestModSeq"/> value.</param>
  31432. <param name="uids">The last known list of unique message identifiers.</param>
  31433. <param name="cancellationToken">The cancellation token.</param>
  31434. </member>
  31435. <member name="M:MailKit.IMailFolder.OpenAsync(MailKit.FolderAccess,System.UInt32,System.UInt64,System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)">
  31436. <summary>
  31437. Asynchronously opens the folder using the requested folder access.
  31438. </summary>
  31439. <remarks>
  31440. <para>This variant of the <see cref="M:MailKit.IMailFolder.OpenAsync(MailKit.FolderAccess,System.Threading.CancellationToken)"/>
  31441. method is meant for quick resynchronization of the folder. Before calling this method,
  31442. the <see cref="M:MailKit.IMailStore.EnableQuickResync(System.Threading.CancellationToken)"/> method MUST be called.</para>
  31443. <para>You should also make sure to add listeners to the <see cref="E:MailKit.IMailFolder.MessagesVanished"/> and
  31444. <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events to get notifications of changes since
  31445. the last time the folder was opened.</para>
  31446. </remarks>
  31447. <returns>The <see cref="T:MailKit.FolderAccess"/> state of the folder.</returns>
  31448. <param name="access">The requested folder access.</param>
  31449. <param name="uidValidity">The last known <see cref="P:MailKit.IMailFolder.UidValidity"/> value.</param>
  31450. <param name="highestModSeq">The last known <see cref="P:MailKit.IMailFolder.HighestModSeq"/> value.</param>
  31451. <param name="uids">The last known list of unique message identifiers.</param>
  31452. <param name="cancellationToken">The cancellation token.</param>
  31453. </member>
  31454. <member name="M:MailKit.IMailFolder.Open(MailKit.FolderAccess,System.Threading.CancellationToken)">
  31455. <summary>
  31456. Open the folder using the requested folder access.
  31457. </summary>
  31458. <remarks>
  31459. Opens the folder using the requested folder access.
  31460. </remarks>
  31461. <returns>The <see cref="T:MailKit.FolderAccess"/> state of the folder.</returns>
  31462. <param name="access">The requested folder access.</param>
  31463. <param name="cancellationToken">The cancellation token.</param>
  31464. </member>
  31465. <member name="M:MailKit.IMailFolder.OpenAsync(MailKit.FolderAccess,System.Threading.CancellationToken)">
  31466. <summary>
  31467. Asynchronously open the folder using the requested folder access.
  31468. </summary>
  31469. <remarks>
  31470. Asynchronously opens the folder using the requested folder access.
  31471. </remarks>
  31472. <returns>The <see cref="T:MailKit.FolderAccess"/> state of the folder.</returns>
  31473. <param name="access">The requested folder access.</param>
  31474. <param name="cancellationToken">The cancellation token.</param>
  31475. </member>
  31476. <member name="M:MailKit.IMailFolder.Close(System.Boolean,System.Threading.CancellationToken)">
  31477. <summary>
  31478. Close the folder, optionally expunging the messages marked for deletion.
  31479. </summary>
  31480. <remarks>
  31481. Closes the folder, optionally expunging the messages marked for deletion.
  31482. </remarks>
  31483. <param name="expunge">If set to <c>true</c>, expunge.</param>
  31484. <param name="cancellationToken">The cancellation token.</param>
  31485. </member>
  31486. <member name="M:MailKit.IMailFolder.CloseAsync(System.Boolean,System.Threading.CancellationToken)">
  31487. <summary>
  31488. Asynchronously close the folder, optionally expunging the messages marked for deletion.
  31489. </summary>
  31490. <remarks>
  31491. Asynchronously closes the folder, optionally expunging the messages marked for deletion.
  31492. </remarks>
  31493. <returns>An asynchronous task context.</returns>
  31494. <param name="expunge">If set to <c>true</c>, expunge.</param>
  31495. <param name="cancellationToken">The cancellation token.</param>
  31496. </member>
  31497. <member name="M:MailKit.IMailFolder.Create(System.String,System.Boolean,System.Threading.CancellationToken)">
  31498. <summary>
  31499. Create a new subfolder with the given name.
  31500. </summary>
  31501. <remarks>
  31502. Creates a new subfolder with the given name.
  31503. </remarks>
  31504. <returns>The created folder.</returns>
  31505. <param name="name">The name of the folder to create.</param>
  31506. <param name="isMessageFolder"><c>true</c> if the folder will be used to contain messages; otherwise <c>false</c>.</param>
  31507. <param name="cancellationToken">The cancellation token.</param>
  31508. </member>
  31509. <member name="M:MailKit.IMailFolder.CreateAsync(System.String,System.Boolean,System.Threading.CancellationToken)">
  31510. <summary>
  31511. Asynchronously create a new subfolder with the given name.
  31512. </summary>
  31513. <remarks>
  31514. Asynchronously creates a new subfolder with the given name.
  31515. </remarks>
  31516. <returns>The created folder.</returns>
  31517. <param name="name">The name of the folder to create.</param>
  31518. <param name="isMessageFolder"><c>true</c> if the folder will be used to contain messages; otherwise <c>false</c>.</param>
  31519. <param name="cancellationToken">The cancellation token.</param>
  31520. </member>
  31521. <member name="M:MailKit.IMailFolder.Create(System.String,System.Collections.Generic.IEnumerable{MailKit.SpecialFolder},System.Threading.CancellationToken)">
  31522. <summary>
  31523. Create a new subfolder with the given name.
  31524. </summary>
  31525. <remarks>
  31526. Creates a new subfolder with the given name.
  31527. </remarks>
  31528. <returns>The created folder.</returns>
  31529. <param name="name">The name of the folder to create.</param>
  31530. <param name="specialUses">A list of special uses for the folder being created.</param>
  31531. <param name="cancellationToken">The cancellation token.</param>
  31532. </member>
  31533. <member name="M:MailKit.IMailFolder.CreateAsync(System.String,System.Collections.Generic.IEnumerable{MailKit.SpecialFolder},System.Threading.CancellationToken)">
  31534. <summary>
  31535. Asynchronously create a new subfolder with the given name.
  31536. </summary>
  31537. <remarks>
  31538. Asynchronously creates a new subfolder with the given name.
  31539. </remarks>
  31540. <returns>The created folder.</returns>
  31541. <param name="name">The name of the folder to create.</param>
  31542. <param name="specialUses">A list of special uses for the folder being created.</param>
  31543. <param name="cancellationToken">The cancellation token.</param>
  31544. </member>
  31545. <member name="M:MailKit.IMailFolder.Create(System.String,MailKit.SpecialFolder,System.Threading.CancellationToken)">
  31546. <summary>
  31547. Create a new subfolder with the given name.
  31548. </summary>
  31549. <remarks>
  31550. Creates a new subfolder with the given name.
  31551. </remarks>
  31552. <returns>The created folder.</returns>
  31553. <param name="name">The name of the folder to create.</param>
  31554. <param name="specialUse">The special use for the folder being created.</param>
  31555. <param name="cancellationToken">The cancellation token.</param>
  31556. </member>
  31557. <member name="M:MailKit.IMailFolder.CreateAsync(System.String,MailKit.SpecialFolder,System.Threading.CancellationToken)">
  31558. <summary>
  31559. Asynchronously create a new subfolder with the given name.
  31560. </summary>
  31561. <remarks>
  31562. Asynchronously creates a new subfolder with the given name.
  31563. </remarks>
  31564. <returns>The created folder.</returns>
  31565. <param name="name">The name of the folder to create.</param>
  31566. <param name="specialUse">The special use for the folder being created.</param>
  31567. <param name="cancellationToken">The cancellation token.</param>
  31568. </member>
  31569. <member name="M:MailKit.IMailFolder.Rename(MailKit.IMailFolder,System.String,System.Threading.CancellationToken)">
  31570. <summary>
  31571. Rename the folder.
  31572. </summary>
  31573. <remarks>
  31574. Renames the folder.
  31575. </remarks>
  31576. <param name="parent">The new parent folder.</param>
  31577. <param name="name">The new name of the folder.</param>
  31578. <param name="cancellationToken">The cancellation token.</param>
  31579. </member>
  31580. <member name="M:MailKit.IMailFolder.RenameAsync(MailKit.IMailFolder,System.String,System.Threading.CancellationToken)">
  31581. <summary>
  31582. Asynchronously rename the folder.
  31583. </summary>
  31584. <remarks>
  31585. Asynchronously renames the folder.
  31586. </remarks>
  31587. <returns>An asynchronous task context.</returns>
  31588. <param name="parent">The new parent folder.</param>
  31589. <param name="name">The new name of the folder.</param>
  31590. <param name="cancellationToken">The cancellation token.</param>
  31591. </member>
  31592. <member name="M:MailKit.IMailFolder.Delete(System.Threading.CancellationToken)">
  31593. <summary>
  31594. Delete the folder.
  31595. </summary>
  31596. <remarks>
  31597. Deletes the folder.
  31598. </remarks>
  31599. <param name="cancellationToken">The cancellation token.</param>
  31600. </member>
  31601. <member name="M:MailKit.IMailFolder.DeleteAsync(System.Threading.CancellationToken)">
  31602. <summary>
  31603. Asynchronously delete the folder.
  31604. </summary>
  31605. <remarks>
  31606. Asynchronously deletes the folder.
  31607. </remarks>
  31608. <returns>An asynchronous task context.</returns>
  31609. <param name="cancellationToken">The cancellation token.</param>
  31610. </member>
  31611. <member name="M:MailKit.IMailFolder.Subscribe(System.Threading.CancellationToken)">
  31612. <summary>
  31613. Subscribe to the folder.
  31614. </summary>
  31615. <remarks>
  31616. Subscribes to the folder.
  31617. </remarks>
  31618. <param name="cancellationToken">The cancellation token.</param>
  31619. </member>
  31620. <member name="M:MailKit.IMailFolder.SubscribeAsync(System.Threading.CancellationToken)">
  31621. <summary>
  31622. Asynchronously subscribe to the folder.
  31623. </summary>
  31624. <remarks>
  31625. Asynchronously subscribes to the folder.
  31626. </remarks>
  31627. <returns>An asynchronous task context.</returns>
  31628. <param name="cancellationToken">The cancellation token.</param>
  31629. </member>
  31630. <member name="M:MailKit.IMailFolder.Unsubscribe(System.Threading.CancellationToken)">
  31631. <summary>
  31632. Unsubscribe from the folder.
  31633. </summary>
  31634. <remarks>
  31635. Unsubscribes from the folder.
  31636. </remarks>
  31637. <param name="cancellationToken">The cancellation token.</param>
  31638. </member>
  31639. <member name="M:MailKit.IMailFolder.UnsubscribeAsync(System.Threading.CancellationToken)">
  31640. <summary>
  31641. Asynchronously unsubscribe from the folder.
  31642. </summary>
  31643. <remarks>
  31644. Asynchronously unsubscribes from the folder.
  31645. </remarks>
  31646. <returns>An asynchronous task context.</returns>
  31647. <param name="cancellationToken">The cancellation token.</param>
  31648. </member>
  31649. <member name="M:MailKit.IMailFolder.GetSubfolders(MailKit.StatusItems,System.Boolean,System.Threading.CancellationToken)">
  31650. <summary>
  31651. Get the subfolders.
  31652. </summary>
  31653. <remarks>
  31654. <para>Gets the subfolders as well as queries the server for the status of the requested items.</para>
  31655. <para>When the <paramref name="items"/> argument is non-empty, this has the equivalent functionality
  31656. of calling <see cref="M:MailKit.IMailFolder.GetSubfolders(System.Boolean,System.Threading.CancellationToken)"/> and then calling
  31657. <see cref="M:MailKit.IMailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/> on each of the returned folders.</para>
  31658. <note type="tip">Using this method is potentially more efficient than querying the status of each returned folder.</note>
  31659. </remarks>
  31660. <returns>The subfolders.</returns>
  31661. <param name="items">The status items to pre-populate.</param>
  31662. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  31663. <param name="cancellationToken">The cancellation token.</param>
  31664. </member>
  31665. <member name="M:MailKit.IMailFolder.GetSubfoldersAsync(MailKit.StatusItems,System.Boolean,System.Threading.CancellationToken)">
  31666. <summary>
  31667. Asynchronously get the subfolders.
  31668. </summary>
  31669. <remarks>
  31670. <para>Asynchronously gets the subfolders as well as queries the server for the status of the requested items.</para>
  31671. <para>When the <paramref name="items"/> argument is non-empty, this has the equivalent functionality
  31672. of calling <see cref="M:MailKit.IMailFolder.GetSubfoldersAsync(System.Boolean,System.Threading.CancellationToken)"/> and then calling
  31673. <see cref="M:MailKit.IMailFolder.StatusAsync(MailKit.StatusItems,System.Threading.CancellationToken)"/> on each of the returned folders.</para>
  31674. </remarks>
  31675. <returns>The subfolders.</returns>
  31676. <param name="items">The status items to pre-populate.</param>
  31677. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  31678. <param name="cancellationToken">The cancellation token.</param>
  31679. </member>
  31680. <member name="M:MailKit.IMailFolder.GetSubfolders(System.Boolean,System.Threading.CancellationToken)">
  31681. <summary>
  31682. Get the subfolders.
  31683. </summary>
  31684. <remarks>
  31685. Gets the subfolders.
  31686. </remarks>
  31687. <returns>The subfolders.</returns>
  31688. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  31689. <param name="cancellationToken">The cancellation token.</param>
  31690. </member>
  31691. <member name="M:MailKit.IMailFolder.GetSubfoldersAsync(System.Boolean,System.Threading.CancellationToken)">
  31692. <summary>
  31693. Asynchronously get the subfolders.
  31694. </summary>
  31695. <remarks>
  31696. Asynchronously gets the subfolders.
  31697. </remarks>
  31698. <returns>The subfolders.</returns>
  31699. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  31700. <param name="cancellationToken">The cancellation token.</param>
  31701. </member>
  31702. <member name="M:MailKit.IMailFolder.GetSubfolder(System.String,System.Threading.CancellationToken)">
  31703. <summary>
  31704. Get the specified subfolder.
  31705. </summary>
  31706. <remarks>
  31707. Gets the specified subfolder.
  31708. </remarks>
  31709. <returns>The subfolder.</returns>
  31710. <param name="name">The name of the subfolder.</param>
  31711. <param name="cancellationToken">The cancellation token.</param>
  31712. </member>
  31713. <member name="M:MailKit.IMailFolder.GetSubfolderAsync(System.String,System.Threading.CancellationToken)">
  31714. <summary>
  31715. Asynchronously get the specified subfolder.
  31716. </summary>
  31717. <remarks>
  31718. Asynchronously gets the specified subfolder.
  31719. </remarks>
  31720. <returns>The subfolder.</returns>
  31721. <param name="name">The name of the subfolder.</param>
  31722. <param name="cancellationToken">The cancellation token.</param>
  31723. </member>
  31724. <member name="M:MailKit.IMailFolder.Check(System.Threading.CancellationToken)">
  31725. <summary>
  31726. Force the server to flush its state for the folder.
  31727. </summary>
  31728. <remarks>
  31729. Forces the server to flush its state for the folder.
  31730. </remarks>
  31731. <param name="cancellationToken">The cancellation token.</param>
  31732. </member>
  31733. <member name="M:MailKit.IMailFolder.CheckAsync(System.Threading.CancellationToken)">
  31734. <summary>
  31735. Asynchronously force the server to flush its state for the folder.
  31736. </summary>
  31737. <remarks>
  31738. Asynchronously forces the server to flush its state for the folder.
  31739. </remarks>
  31740. <returns>An asynchronous task context.</returns>
  31741. <param name="cancellationToken">The cancellation token.</param>
  31742. </member>
  31743. <member name="M:MailKit.IMailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)">
  31744. <summary>
  31745. Update the values of the specified items.
  31746. </summary>
  31747. <remarks>
  31748. <para>Updates the values of the specified items.</para>
  31749. <para>The <see cref="M:MailKit.IMailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/> method
  31750. MUST NOT be used on a folder that is already in the opened state. Instead, other ways
  31751. of getting the desired information should be used.</para>
  31752. <para>For example, a common use for the <see cref="M:MailKit.IMailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/>
  31753. method is to get the number of unread messages in the folder. When the folder is open, however, it is
  31754. possible to use the <see cref="M:MailKit.IMailFolder.Search(MailKit.Search.SearchQuery,System.Threading.CancellationToken)"/>
  31755. method to query for the list of unread messages.</para>
  31756. </remarks>
  31757. <param name="items">The items to update.</param>
  31758. <param name="cancellationToken">The cancellation token.</param>
  31759. </member>
  31760. <member name="M:MailKit.IMailFolder.StatusAsync(MailKit.StatusItems,System.Threading.CancellationToken)">
  31761. <summary>
  31762. Asynchronously update the values of the specified items.
  31763. </summary>
  31764. <remarks>
  31765. <para>Updates the values of the specified items.</para>
  31766. <para>The <see cref="M:MailKit.IMailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/> method
  31767. MUST NOT be used on a folder that is already in the opened state. Instead, other ways
  31768. of getting the desired information should be used.</para>
  31769. <para>For example, a common use for the <see cref="M:MailKit.IMailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/>
  31770. method is to get the number of unread messages in the folder. When the folder is open, however, it is
  31771. possible to use the <see cref="M:MailKit.IMailFolder.Search(MailKit.Search.SearchQuery,System.Threading.CancellationToken)"/>
  31772. method to query for the list of unread messages.</para>
  31773. </remarks>
  31774. <returns>An asynchronous task context.</returns>
  31775. <param name="items">The items to update.</param>
  31776. <param name="cancellationToken">The cancellation token.</param>
  31777. </member>
  31778. <member name="M:MailKit.IMailFolder.GetAccessControlList(System.Threading.CancellationToken)">
  31779. <summary>
  31780. Get the complete access control list for the folder.
  31781. </summary>
  31782. <remarks>
  31783. Gets the complete access control list for the folder.
  31784. </remarks>
  31785. <returns>The access control list.</returns>
  31786. <param name="cancellationToken">The cancellation token.</param>
  31787. </member>
  31788. <member name="M:MailKit.IMailFolder.GetAccessControlListAsync(System.Threading.CancellationToken)">
  31789. <summary>
  31790. Asynchronously get the complete access control list for the folder.
  31791. </summary>
  31792. <remarks>
  31793. Asynchronously gets the complete access control list for the folder.
  31794. </remarks>
  31795. <returns>The access control list.</returns>
  31796. <param name="cancellationToken">The cancellation token.</param>
  31797. </member>
  31798. <member name="M:MailKit.IMailFolder.GetAccessRights(System.String,System.Threading.CancellationToken)">
  31799. <summary>
  31800. Get the access rights for a particular identifier.
  31801. </summary>
  31802. <remarks>
  31803. Gets the access rights for a particular identifier.
  31804. </remarks>
  31805. <returns>The access rights.</returns>
  31806. <param name="name">The identifier name.</param>
  31807. <param name="cancellationToken">The cancellation token.</param>
  31808. </member>
  31809. <member name="M:MailKit.IMailFolder.GetAccessRightsAsync(System.String,System.Threading.CancellationToken)">
  31810. <summary>
  31811. Asynchronously get the access rights for a particular identifier.
  31812. </summary>
  31813. <remarks>
  31814. Asynchronously gets the access rights for a particular identifier.
  31815. </remarks>
  31816. <returns>The access rights.</returns>
  31817. <param name="name">The identifier name.</param>
  31818. <param name="cancellationToken">The cancellation token.</param>
  31819. </member>
  31820. <member name="M:MailKit.IMailFolder.GetMyAccessRights(System.Threading.CancellationToken)">
  31821. <summary>
  31822. Get the access rights for the current authenticated user.
  31823. </summary>
  31824. <remarks>
  31825. Gets the access rights for the current authenticated user.
  31826. </remarks>
  31827. <returns>The access rights.</returns>
  31828. <param name="cancellationToken">The cancellation token.</param>
  31829. </member>
  31830. <member name="M:MailKit.IMailFolder.GetMyAccessRightsAsync(System.Threading.CancellationToken)">
  31831. <summary>
  31832. Asynchronously get the access rights for the current authenticated user.
  31833. </summary>
  31834. <remarks>
  31835. Asynchronously gets the access rights for the current authenticated user.
  31836. </remarks>
  31837. <returns>The access rights.</returns>
  31838. <param name="cancellationToken">The cancellation token.</param>
  31839. </member>
  31840. <member name="M:MailKit.IMailFolder.AddAccessRights(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  31841. <summary>
  31842. Add access rights for the specified identity.
  31843. </summary>
  31844. <remarks>
  31845. Adds the given access rights for the specified identity.
  31846. </remarks>
  31847. <param name="name">The identity name.</param>
  31848. <param name="rights">The access rights.</param>
  31849. <param name="cancellationToken">The cancellation token.</param>
  31850. </member>
  31851. <member name="M:MailKit.IMailFolder.AddAccessRightsAsync(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  31852. <summary>
  31853. Asynchronously add access rights for the specified identity.
  31854. </summary>
  31855. <remarks>
  31856. Asynchronously adds the given access rights for the specified identity.
  31857. </remarks>
  31858. <returns>An asynchronous task context.</returns>
  31859. <param name="name">The identity name.</param>
  31860. <param name="rights">The access rights.</param>
  31861. <param name="cancellationToken">The cancellation token.</param>
  31862. </member>
  31863. <member name="M:MailKit.IMailFolder.RemoveAccessRights(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  31864. <summary>
  31865. Remove access rights for the specified identity.
  31866. </summary>
  31867. <remarks>
  31868. Removes the given access rights for the specified identity.
  31869. </remarks>
  31870. <param name="name">The identity name.</param>
  31871. <param name="rights">The access rights.</param>
  31872. <param name="cancellationToken">The cancellation token.</param>
  31873. </member>
  31874. <member name="M:MailKit.IMailFolder.RemoveAccessRightsAsync(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  31875. <summary>
  31876. Asynchronously remove access rights for the specified identity.
  31877. </summary>
  31878. <remarks>
  31879. Asynchronously removes the given access rights for the specified identity.
  31880. </remarks>
  31881. <returns>An asynchronous task context.</returns>
  31882. <param name="name">The identity name.</param>
  31883. <param name="rights">The access rights.</param>
  31884. <param name="cancellationToken">The cancellation token.</param>
  31885. </member>
  31886. <member name="M:MailKit.IMailFolder.SetAccessRights(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  31887. <summary>
  31888. Set the access rights for the specified identity.
  31889. </summary>
  31890. <remarks>
  31891. Sets the access rights for the specified identity.
  31892. </remarks>
  31893. <param name="name">The identity name.</param>
  31894. <param name="rights">The access rights.</param>
  31895. <param name="cancellationToken">The cancellation token.</param>
  31896. </member>
  31897. <member name="M:MailKit.IMailFolder.SetAccessRightsAsync(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  31898. <summary>
  31899. Asynchronously set the access rights for the sepcified identity.
  31900. </summary>
  31901. <remarks>
  31902. Asynchronously sets the access rights for the specified identity.
  31903. </remarks>
  31904. <returns>An asynchronous task context.</returns>
  31905. <param name="name">The identity name.</param>
  31906. <param name="rights">The access rights.</param>
  31907. <param name="cancellationToken">The cancellation token.</param>
  31908. </member>
  31909. <member name="M:MailKit.IMailFolder.RemoveAccess(System.String,System.Threading.CancellationToken)">
  31910. <summary>
  31911. Remove all access rights for the given identity.
  31912. </summary>
  31913. <remarks>
  31914. Removes all access rights for the given identity.
  31915. </remarks>
  31916. <param name="name">The identity name.</param>
  31917. <param name="cancellationToken">The cancellation token.</param>
  31918. </member>
  31919. <member name="M:MailKit.IMailFolder.RemoveAccessAsync(System.String,System.Threading.CancellationToken)">
  31920. <summary>
  31921. Asynchronously remove all access rights for the given identity.
  31922. </summary>
  31923. <remarks>
  31924. Asynchronously removes all access rights for the given identity.
  31925. </remarks>
  31926. <returns>An asynchronous task context.</returns>
  31927. <param name="name">The identity name.</param>
  31928. <param name="cancellationToken">The cancellation token.</param>
  31929. </member>
  31930. <member name="M:MailKit.IMailFolder.GetQuota(System.Threading.CancellationToken)">
  31931. <summary>
  31932. Get the quota information for the folder.
  31933. </summary>
  31934. <remarks>
  31935. <para>Gets the quota information for the folder.</para>
  31936. <para>To determine if a quotas are supported, check the
  31937. <see cref="P:MailKit.IMailStore.SupportsQuotas"/> property.</para>
  31938. </remarks>
  31939. <returns>The folder quota.</returns>
  31940. <param name="cancellationToken">The cancellation token.</param>
  31941. </member>
  31942. <member name="M:MailKit.IMailFolder.GetQuotaAsync(System.Threading.CancellationToken)">
  31943. <summary>
  31944. Asynchronously get the quota information for the folder.
  31945. </summary>
  31946. <remarks>
  31947. <para>Asynchronously gets the quota information for the folder.</para>
  31948. <para>To determine if a quotas are supported, check the
  31949. <see cref="P:MailKit.IMailStore.SupportsQuotas"/> property.</para>
  31950. </remarks>
  31951. <returns>The folder quota.</returns>
  31952. <param name="cancellationToken">The cancellation token.</param>
  31953. </member>
  31954. <member name="M:MailKit.IMailFolder.SetQuota(System.Nullable{System.UInt32},System.Nullable{System.UInt32},System.Threading.CancellationToken)">
  31955. <summary>
  31956. Set the quota limits for the folder.
  31957. </summary>
  31958. <remarks>
  31959. <para>Sets the quota limits for the folder.</para>
  31960. <para>To determine if a quotas are supported, check the
  31961. <see cref="P:MailKit.IMailStore.SupportsQuotas"/> property.</para>
  31962. </remarks>
  31963. <returns>The updated folder quota.</returns>
  31964. <param name="messageLimit">If not <c>null</c>, sets the maximum number of messages to allow.</param>
  31965. <param name="storageLimit">If not <c>null</c>, sets the maximum storage size (in kilobytes).</param>
  31966. <param name="cancellationToken">The cancellation token.</param>
  31967. </member>
  31968. <member name="M:MailKit.IMailFolder.SetQuotaAsync(System.Nullable{System.UInt32},System.Nullable{System.UInt32},System.Threading.CancellationToken)">
  31969. <summary>
  31970. Asynchronously set the quota limits for the folder.
  31971. </summary>
  31972. <remarks>
  31973. <para>Asynchronously sets the quota limits for the folder.</para>
  31974. <para>To determine if a quotas are supported, check the
  31975. <see cref="P:MailKit.IMailStore.SupportsQuotas"/> property.</para>
  31976. </remarks>
  31977. <returns>The updated folder quota.</returns>
  31978. <param name="messageLimit">If not <c>null</c>, sets the maximum number of messages to allow.</param>
  31979. <param name="storageLimit">If not <c>null</c>, sets the maximum storage size (in kilobytes).</param>
  31980. <param name="cancellationToken">The cancellation token.</param>
  31981. </member>
  31982. <member name="M:MailKit.IMailFolder.GetMetadata(MailKit.MetadataTag,System.Threading.CancellationToken)">
  31983. <summary>
  31984. Gets the specified metadata.
  31985. </summary>
  31986. <remarks>
  31987. Gets the specified metadata.
  31988. </remarks>
  31989. <returns>The requested metadata value.</returns>
  31990. <param name="tag">The metadata tag.</param>
  31991. <param name="cancellationToken">The cancellation token.</param>
  31992. </member>
  31993. <member name="M:MailKit.IMailFolder.GetMetadataAsync(MailKit.MetadataTag,System.Threading.CancellationToken)">
  31994. <summary>
  31995. Asynchronously gets the specified metadata.
  31996. </summary>
  31997. <remarks>
  31998. Asynchronously gets the specified metadata.
  31999. </remarks>
  32000. <returns>The requested metadata value.</returns>
  32001. <param name="tag">The metadata tag.</param>
  32002. <param name="cancellationToken">The cancellation token.</param>
  32003. </member>
  32004. <member name="M:MailKit.IMailFolder.GetMetadata(System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  32005. <summary>
  32006. Gets the specified metadata.
  32007. </summary>
  32008. <remarks>
  32009. Gets the specified metadata.
  32010. </remarks>
  32011. <returns>The requested metadata.</returns>
  32012. <param name="tags">The metadata tags.</param>
  32013. <param name="cancellationToken">The cancellation token.</param>
  32014. </member>
  32015. <member name="M:MailKit.IMailFolder.GetMetadataAsync(System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  32016. <summary>
  32017. Asynchronously gets the specified metadata.
  32018. </summary>
  32019. <remarks>
  32020. Asynchronously gets the specified metadata.
  32021. </remarks>
  32022. <returns>The requested metadata.</returns>
  32023. <param name="tags">The metadata tags.</param>
  32024. <param name="cancellationToken">The cancellation token.</param>
  32025. </member>
  32026. <member name="M:MailKit.IMailFolder.GetMetadata(MailKit.MetadataOptions,System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  32027. <summary>
  32028. Gets the specified metadata.
  32029. </summary>
  32030. <remarks>
  32031. Gets the specified metadata.
  32032. </remarks>
  32033. <returns>The requested metadata.</returns>
  32034. <param name="options">The metadata options.</param>
  32035. <param name="tags">The metadata tags.</param>
  32036. <param name="cancellationToken">The cancellation token.</param>
  32037. </member>
  32038. <member name="M:MailKit.IMailFolder.GetMetadataAsync(MailKit.MetadataOptions,System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  32039. <summary>
  32040. Asynchronously gets the specified metadata.
  32041. </summary>
  32042. <remarks>
  32043. Asynchronously gets the specified metadata.
  32044. </remarks>
  32045. <returns>The requested metadata.</returns>
  32046. <param name="options">The metadata options.</param>
  32047. <param name="tags">The metadata tags.</param>
  32048. <param name="cancellationToken">The cancellation token.</param>
  32049. </member>
  32050. <member name="M:MailKit.IMailFolder.SetMetadata(MailKit.MetadataCollection,System.Threading.CancellationToken)">
  32051. <summary>
  32052. Sets the specified metadata.
  32053. </summary>
  32054. <remarks>
  32055. Sets the specified metadata.
  32056. </remarks>
  32057. <param name="metadata">The metadata.</param>
  32058. <param name="cancellationToken">The cancellation token.</param>
  32059. </member>
  32060. <member name="M:MailKit.IMailFolder.SetMetadataAsync(MailKit.MetadataCollection,System.Threading.CancellationToken)">
  32061. <summary>
  32062. Asynchronously sets the specified metadata.
  32063. </summary>
  32064. <remarks>
  32065. Asynchronously sets the specified metadata.
  32066. </remarks>
  32067. <returns>An asynchronous task context.</returns>
  32068. <param name="metadata">The metadata.</param>
  32069. <param name="cancellationToken">The cancellation token.</param>
  32070. </member>
  32071. <member name="M:MailKit.IMailFolder.Expunge(System.Threading.CancellationToken)">
  32072. <summary>
  32073. Expunge the folder, permanently removing all messages marked for deletion.
  32074. </summary>
  32075. <remarks>
  32076. <para>Expunges the folder, permanently removing all messages marked for deletion.</para>
  32077. <note type="note">Normally, an <see cref="E:MailKit.IMailFolder.MessageExpunged"/> event will be emitted for each
  32078. message that is expunged. However, if the mail store supports the quick
  32079. resynchronization feature and it has been enabled via the
  32080. <see cref="M:MailKit.IMailStore.EnableQuickResync(System.Threading.CancellationToken)"/> method, then
  32081. the <see cref="E:MailKit.IMailFolder.MessagesVanished"/> event will be emitted rather than the
  32082. <see cref="E:MailKit.IMailFolder.MessageExpunged"/> event.</note>
  32083. </remarks>
  32084. <param name="cancellationToken">The cancellation token.</param>
  32085. </member>
  32086. <member name="M:MailKit.IMailFolder.ExpungeAsync(System.Threading.CancellationToken)">
  32087. <summary>
  32088. Asynchronously expunge the folder, permanently removing all messages marked for deletion.
  32089. </summary>
  32090. <remarks>
  32091. <para>Asynchronously expunges the folder, permanently removing all messages marked for deletion.</para>
  32092. <note type="note">Normally, an <see cref="E:MailKit.IMailFolder.MessageExpunged"/> event will be emitted for
  32093. each message that is expunged. However, if the mail store supports the quick
  32094. resynchronization feature and it has been enabled via the
  32095. <see cref="M:MailKit.IMailStore.EnableQuickResync(System.Threading.CancellationToken)"/> method, then
  32096. the <see cref="E:MailKit.IMailFolder.MessagesVanished"/> event will be emitted rather than the
  32097. <see cref="E:MailKit.IMailFolder.MessageExpunged"/> event.</note>
  32098. </remarks>
  32099. <returns>An asynchronous task context.</returns>
  32100. <param name="cancellationToken">The cancellation token.</param>
  32101. </member>
  32102. <member name="M:MailKit.IMailFolder.Expunge(System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)">
  32103. <summary>
  32104. Expunge the specified uids, permanently removing them from the folder.
  32105. </summary>
  32106. <remarks>
  32107. <para>Expunges the specified uids, permanently removing them from the folder.</para>
  32108. <note type="note">Normally, an <see cref="E:MailKit.IMailFolder.MessageExpunged"/> event will be emitted for
  32109. each message that is expunged. However, if the mail store supports the quick
  32110. resynchronization feature and it has been enabled via the
  32111. <see cref="M:MailKit.IMailStore.EnableQuickResync(System.Threading.CancellationToken)"/> method, then
  32112. the <see cref="E:MailKit.IMailFolder.MessagesVanished"/> event will be emitted rather than the
  32113. <see cref="E:MailKit.IMailFolder.MessageExpunged"/> event.</note>
  32114. </remarks>
  32115. <param name="uids">The message uids.</param>
  32116. <param name="cancellationToken">The cancellation token.</param>
  32117. </member>
  32118. <member name="M:MailKit.IMailFolder.ExpungeAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)">
  32119. <summary>
  32120. Asynchronously expunge the specified uids, permanently removing them from the folder.
  32121. </summary>
  32122. <remarks>
  32123. <para>Asynchronously expunges the specified uids, permanently removing them from the folder.</para>
  32124. <note type="note">Normally, an <see cref="E:MailKit.IMailFolder.MessageExpunged"/> event will be emitted for
  32125. each message that is expunged. However, if the mail store supports the quick
  32126. resynchronization feature and it has been enabled via the
  32127. <see cref="M:MailKit.IMailStore.EnableQuickResync(System.Threading.CancellationToken)"/> method, then
  32128. the <see cref="E:MailKit.IMailFolder.MessagesVanished"/> event will be emitted rather than the
  32129. <see cref="E:MailKit.IMailFolder.MessageExpunged"/> event.</note>
  32130. </remarks>
  32131. <returns>An asynchronous task context.</returns>
  32132. <param name="uids">The message uids.</param>
  32133. <param name="cancellationToken">The cancellation token.</param>
  32134. </member>
  32135. <member name="M:MailKit.IMailFolder.Append(MimeKit.MimeMessage,MailKit.MessageFlags,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32136. <summary>
  32137. Append the specified message to the folder.
  32138. </summary>
  32139. <remarks>
  32140. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  32141. </remarks>
  32142. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  32143. <param name="message">The message.</param>
  32144. <param name="flags">The message flags.</param>
  32145. <param name="cancellationToken">The cancellation token.</param>
  32146. <param name="progress">The progress reporting mechanism.</param>
  32147. </member>
  32148. <member name="M:MailKit.IMailFolder.AppendAsync(MimeKit.MimeMessage,MailKit.MessageFlags,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32149. <summary>
  32150. Asynchronously append the specified message to the folder.
  32151. </summary>
  32152. <remarks>
  32153. Asynchronously appends the specified message to the folder and returns the UniqueId assigned to the message.
  32154. </remarks>
  32155. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  32156. <param name="message">The message.</param>
  32157. <param name="flags">The message flags.</param>
  32158. <param name="cancellationToken">The cancellation token.</param>
  32159. <param name="progress">The progress reporting mechanism.</param>
  32160. </member>
  32161. <member name="M:MailKit.IMailFolder.Append(MimeKit.MimeMessage,MailKit.MessageFlags,System.DateTimeOffset,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32162. <summary>
  32163. Append the specified message to the folder.
  32164. </summary>
  32165. <remarks>
  32166. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  32167. </remarks>
  32168. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  32169. <param name="message">The message.</param>
  32170. <param name="flags">The message flags.</param>
  32171. <param name="date">The received date of the message.</param>
  32172. <param name="cancellationToken">The cancellation token.</param>
  32173. <param name="progress">The progress reporting mechanism.</param>
  32174. </member>
  32175. <member name="M:MailKit.IMailFolder.AppendAsync(MimeKit.MimeMessage,MailKit.MessageFlags,System.DateTimeOffset,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32176. <summary>
  32177. Asynchronously append the specified message to the folder.
  32178. </summary>
  32179. <remarks>
  32180. Asynchronously appends the specified message to the folder and returns the UniqueId assigned to the message.
  32181. </remarks>
  32182. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  32183. <param name="message">The message.</param>
  32184. <param name="flags">The message flags.</param>
  32185. <param name="date">The received date of the message.</param>
  32186. <param name="cancellationToken">The cancellation token.</param>
  32187. <param name="progress">The progress reporting mechanism.</param>
  32188. </member>
  32189. <member name="M:MailKit.IMailFolder.Append(MimeKit.MimeMessage,MailKit.MessageFlags,System.Nullable{System.DateTimeOffset},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32190. <summary>
  32191. Append the specified message to the folder.
  32192. </summary>
  32193. <remarks>
  32194. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  32195. </remarks>
  32196. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  32197. <param name="message">The message.</param>
  32198. <param name="flags">The message flags.</param>
  32199. <param name="date">The received date of the message.</param>
  32200. <param name="annotations">The message annotations.</param>
  32201. <param name="cancellationToken">The cancellation token.</param>
  32202. <param name="progress">The progress reporting mechanism.</param>
  32203. </member>
  32204. <member name="M:MailKit.IMailFolder.AppendAsync(MimeKit.MimeMessage,MailKit.MessageFlags,System.Nullable{System.DateTimeOffset},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32205. <summary>
  32206. Asynchronously append the specified message to the folder.
  32207. </summary>
  32208. <remarks>
  32209. Asynchronously appends the specified message to the folder and returns the UniqueId assigned to the message.
  32210. </remarks>
  32211. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  32212. <param name="message">The message.</param>
  32213. <param name="flags">The message flags.</param>
  32214. <param name="date">The received date of the message.</param>
  32215. <param name="annotations">The message annotations.</param>
  32216. <param name="cancellationToken">The cancellation token.</param>
  32217. <param name="progress">The progress reporting mechanism.</param>
  32218. </member>
  32219. <member name="M:MailKit.IMailFolder.Append(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32220. <summary>
  32221. Append the specified message to the folder.
  32222. </summary>
  32223. <remarks>
  32224. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  32225. </remarks>
  32226. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  32227. <param name="options">The formatting options.</param>
  32228. <param name="message">The message.</param>
  32229. <param name="flags">The message flags.</param>
  32230. <param name="cancellationToken">The cancellation token.</param>
  32231. <param name="progress">The progress reporting mechanism.</param>
  32232. </member>
  32233. <member name="M:MailKit.IMailFolder.AppendAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32234. <summary>
  32235. Asynchronously append the specified message to the folder.
  32236. </summary>
  32237. <remarks>
  32238. Asynchronously appends the specified message to the folder and returns the UniqueId assigned to the message.
  32239. </remarks>
  32240. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  32241. <param name="options">The formatting options.</param>
  32242. <param name="message">The message.</param>
  32243. <param name="flags">The message flags.</param>
  32244. <param name="cancellationToken">The cancellation token.</param>
  32245. <param name="progress">The progress reporting mechanism.</param>
  32246. </member>
  32247. <member name="M:MailKit.IMailFolder.Append(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.DateTimeOffset,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32248. <summary>
  32249. Append the specified message to the folder.
  32250. </summary>
  32251. <remarks>
  32252. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  32253. </remarks>
  32254. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  32255. <param name="options">The formatting options.</param>
  32256. <param name="message">The message.</param>
  32257. <param name="flags">The message flags.</param>
  32258. <param name="date">The received date of the message.</param>
  32259. <param name="cancellationToken">The cancellation token.</param>
  32260. <param name="progress">The progress reporting mechanism.</param>
  32261. </member>
  32262. <member name="M:MailKit.IMailFolder.AppendAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.DateTimeOffset,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32263. <summary>
  32264. Asynchronously append the specified message to the folder.
  32265. </summary>
  32266. <remarks>
  32267. Asynchronously appends the specified message to the folder and returns the UniqueId assigned to the message.
  32268. </remarks>
  32269. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  32270. <param name="options">The formatting options.</param>
  32271. <param name="message">The message.</param>
  32272. <param name="flags">The message flags.</param>
  32273. <param name="date">The received date of the message.</param>
  32274. <param name="cancellationToken">The cancellation token.</param>
  32275. <param name="progress">The progress reporting mechanism.</param>
  32276. </member>
  32277. <member name="M:MailKit.IMailFolder.Append(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.Nullable{System.DateTimeOffset},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32278. <summary>
  32279. Append the specified message to the folder.
  32280. </summary>
  32281. <remarks>
  32282. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  32283. </remarks>
  32284. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  32285. <param name="options">The formatting options.</param>
  32286. <param name="message">The message.</param>
  32287. <param name="flags">The message flags.</param>
  32288. <param name="date">The received date of the message.</param>
  32289. <param name="annotations">The message annotations.</param>
  32290. <param name="cancellationToken">The cancellation token.</param>
  32291. <param name="progress">The progress reporting mechanism.</param>
  32292. </member>
  32293. <member name="M:MailKit.IMailFolder.AppendAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.Nullable{System.DateTimeOffset},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32294. <summary>
  32295. Asynchronously append the specified message to the folder.
  32296. </summary>
  32297. <remarks>
  32298. Asynchronously appends the specified message to the folder and returns the UniqueId assigned to the message.
  32299. </remarks>
  32300. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  32301. <param name="options">The formatting options.</param>
  32302. <param name="message">The message.</param>
  32303. <param name="flags">The message flags.</param>
  32304. <param name="date">The received date of the message.</param>
  32305. <param name="annotations">The message annotations.</param>
  32306. <param name="cancellationToken">The cancellation token.</param>
  32307. <param name="progress">The progress reporting mechanism.</param>
  32308. </member>
  32309. <member name="M:MailKit.IMailFolder.Append(System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32310. <summary>
  32311. Append the specified messages to the folder.
  32312. </summary>
  32313. <remarks>
  32314. Appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  32315. </remarks>
  32316. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  32317. <param name="messages">The list of messages to append to the folder.</param>
  32318. <param name="flags">The message flags to use for each message.</param>
  32319. <param name="cancellationToken">The cancellation token.</param>
  32320. <param name="progress">The progress reporting mechanism.</param>
  32321. </member>
  32322. <member name="M:MailKit.IMailFolder.AppendAsync(System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32323. <summary>
  32324. Asynchronously append the specified messages to the folder.
  32325. </summary>
  32326. <remarks>
  32327. Asynchronously appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  32328. </remarks>
  32329. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  32330. <param name="messages">The list of messages to append to the folder.</param>
  32331. <param name="flags">The message flags to use for each message.</param>
  32332. <param name="cancellationToken">The cancellation token.</param>
  32333. <param name="progress">The progress reporting mechanism.</param>
  32334. </member>
  32335. <member name="M:MailKit.IMailFolder.Append(System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Collections.Generic.IList{System.DateTimeOffset},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32336. <summary>
  32337. Append the specified messages to the folder.
  32338. </summary>
  32339. <remarks>
  32340. Appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  32341. </remarks>
  32342. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  32343. <param name="messages">The list of messages to append to the folder.</param>
  32344. <param name="flags">The message flags to use for each of the messages.</param>
  32345. <param name="dates">The received dates to use for each of the messages.</param>
  32346. <param name="cancellationToken">The cancellation token.</param>
  32347. <param name="progress">The progress reporting mechanism.</param>
  32348. </member>
  32349. <member name="M:MailKit.IMailFolder.AppendAsync(System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Collections.Generic.IList{System.DateTimeOffset},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32350. <summary>
  32351. Asynchronously append the specified messages to the folder.
  32352. </summary>
  32353. <remarks>
  32354. Asynchronously appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  32355. </remarks>
  32356. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  32357. <param name="messages">The list of messages to append to the folder.</param>
  32358. <param name="flags">The message flags to use for each of the messages.</param>
  32359. <param name="dates">The received dates to use for each of the messages.</param>
  32360. <param name="cancellationToken">The cancellation token.</param>
  32361. <param name="progress">The progress reporting mechanism.</param>
  32362. </member>
  32363. <member name="M:MailKit.IMailFolder.Append(MimeKit.FormatOptions,System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32364. <summary>
  32365. Append the specified messages to the folder.
  32366. </summary>
  32367. <remarks>
  32368. Appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  32369. </remarks>
  32370. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  32371. <param name="options">The formatting options.</param>
  32372. <param name="messages">The list of messages to append to the folder.</param>
  32373. <param name="flags">The message flags to use for each message.</param>
  32374. <param name="cancellationToken">The cancellation token.</param>
  32375. <param name="progress">The progress reporting mechanism.</param>
  32376. </member>
  32377. <member name="M:MailKit.IMailFolder.AppendAsync(MimeKit.FormatOptions,System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32378. <summary>
  32379. Asynchronously append the specified messages to the folder.
  32380. </summary>
  32381. <remarks>
  32382. Asynchronously appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  32383. </remarks>
  32384. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  32385. <param name="options">The formatting options.</param>
  32386. <param name="messages">The list of messages to append to the folder.</param>
  32387. <param name="flags">The message flags to use for each message.</param>
  32388. <param name="cancellationToken">The cancellation token.</param>
  32389. <param name="progress">The progress reporting mechanism.</param>
  32390. </member>
  32391. <member name="M:MailKit.IMailFolder.Append(MimeKit.FormatOptions,System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Collections.Generic.IList{System.DateTimeOffset},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32392. <summary>
  32393. Append the specified messages to the folder.
  32394. </summary>
  32395. <remarks>
  32396. Appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  32397. </remarks>
  32398. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  32399. <param name="options">The formatting options.</param>
  32400. <param name="messages">The list of messages to append to the folder.</param>
  32401. <param name="flags">The message flags to use for each of the messages.</param>
  32402. <param name="dates">The received dates to use for each of the messages.</param>
  32403. <param name="cancellationToken">The cancellation token.</param>
  32404. <param name="progress">The progress reporting mechanism.</param>
  32405. </member>
  32406. <member name="M:MailKit.IMailFolder.AppendAsync(MimeKit.FormatOptions,System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Collections.Generic.IList{System.DateTimeOffset},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  32407. <summary>
  32408. Asynchronously append the specified messages to the folder.
  32409. </summary>
  32410. <remarks>
  32411. Asynchronously appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  32412. </remarks>
  32413. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  32414. <param name="options">The formatting options.</param>
  32415. <param name="messages">The list of messages to append to the folder.</param>
  32416. <param name="flags">The message flags to use for each of the messages.</param>
  32417. <param name="dates">The received dates to use for each of the messages.</param>
  32418. <param name="cancellationToken">The cancellation token.</param>
  32419. <param name="progress">The progress reporting mechanism.</param>
  32420. </member>
  32421. <member name="M:MailKit.IMailFolder.CopyTo(MailKit.UniqueId,MailKit.IMailFolder,System.Threading.CancellationToken)">
  32422. <summary>
  32423. Copy the specified message to the destination folder.
  32424. </summary>
  32425. <remarks>
  32426. Copies the specified message to the destination folder.
  32427. </remarks>
  32428. <returns>The UID of the message in the destination folder, if available; otherwise, <c>null</c>.</returns>
  32429. <param name="uid">The UID of the message to copy.</param>
  32430. <param name="destination">The destination folder.</param>
  32431. <param name="cancellationToken">The cancellation token.</param>
  32432. </member>
  32433. <member name="M:MailKit.IMailFolder.CopyToAsync(MailKit.UniqueId,MailKit.IMailFolder,System.Threading.CancellationToken)">
  32434. <summary>
  32435. Asynchronously copy the specified message to the destination folder.
  32436. </summary>
  32437. <remarks>
  32438. Asynchronously copies the specified message to the destination folder.
  32439. </remarks>
  32440. <returns>The UID of the message in the destination folder, if available; otherwise, <c>null</c>.</returns>
  32441. <param name="uid">The UID of the message to copy.</param>
  32442. <param name="destination">The destination folder.</param>
  32443. <param name="cancellationToken">The cancellation token.</param>
  32444. </member>
  32445. <member name="M:MailKit.IMailFolder.CopyTo(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.IMailFolder,System.Threading.CancellationToken)">
  32446. <summary>
  32447. Copy the specified messages to the destination folder.
  32448. </summary>
  32449. <remarks>
  32450. Copies the specified messages to the destination folder.
  32451. </remarks>
  32452. <returns>The UID mapping of the messages in the destination folder, if available; otherwise an empty mapping.</returns>
  32453. <param name="uids">The UIDs of the messages to copy.</param>
  32454. <param name="destination">The destination folder.</param>
  32455. <param name="cancellationToken">The cancellation token.</param>
  32456. </member>
  32457. <member name="M:MailKit.IMailFolder.CopyToAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.IMailFolder,System.Threading.CancellationToken)">
  32458. <summary>
  32459. Asynchronously copy the specified messages to the destination folder.
  32460. </summary>
  32461. <remarks>
  32462. Asynchronously copies the specified messages to the destination folder.
  32463. </remarks>
  32464. <returns>The UID mapping of the messages in the destination folder, if available; otherwise an empty mapping.</returns>
  32465. <param name="uids">The UIDs of the messages to copy.</param>
  32466. <param name="destination">The destination folder.</param>
  32467. <param name="cancellationToken">The cancellation token.</param>
  32468. </member>
  32469. <member name="M:MailKit.IMailFolder.MoveTo(MailKit.UniqueId,MailKit.IMailFolder,System.Threading.CancellationToken)">
  32470. <summary>
  32471. Move the specified message to the destination folder.
  32472. </summary>
  32473. <remarks>
  32474. Moves the specified message to the destination folder.
  32475. </remarks>
  32476. <returns>The UID of the message in the destination folder, if available; otherwise, <c>null</c>.</returns>
  32477. <param name="uid">The UID of the message to move.</param>
  32478. <param name="destination">The destination folder.</param>
  32479. <param name="cancellationToken">The cancellation token.</param>
  32480. </member>
  32481. <member name="M:MailKit.IMailFolder.MoveToAsync(MailKit.UniqueId,MailKit.IMailFolder,System.Threading.CancellationToken)">
  32482. <summary>
  32483. Asynchronously move the specified message to the destination folder.
  32484. </summary>
  32485. <remarks>
  32486. Asynchronously moves the specified message to the destination folder.
  32487. </remarks>
  32488. <returns>The UID of the message in the destination folder, if available; otherwise, <c>null</c>.</returns>
  32489. <param name="uid">The UID of the message to move.</param>
  32490. <param name="destination">The destination folder.</param>
  32491. <param name="cancellationToken">The cancellation token.</param>
  32492. </member>
  32493. <member name="M:MailKit.IMailFolder.MoveTo(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.IMailFolder,System.Threading.CancellationToken)">
  32494. <summary>
  32495. Move the specified messages to the destination folder.
  32496. </summary>
  32497. <remarks>
  32498. Moves the specified messages to the destination folder.
  32499. </remarks>
  32500. <returns>The UID mapping of the messages in the destination folder, if available; otherwise an empty mapping.</returns>
  32501. <param name="uids">The UIDs of the messages to copy.</param>
  32502. <param name="destination">The destination folder.</param>
  32503. <param name="cancellationToken">The cancellation token.</param>
  32504. </member>
  32505. <member name="M:MailKit.IMailFolder.MoveToAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.IMailFolder,System.Threading.CancellationToken)">
  32506. <summary>
  32507. Asynchronously move the specified messages to the destination folder.
  32508. </summary>
  32509. <remarks>
  32510. Asynchronously moves the specified messages to the destination folder.
  32511. </remarks>
  32512. <returns>The UID mapping of the messages in the destination folder, if available; otherwise an empty mapping.</returns>
  32513. <param name="uids">The UIDs of the messages to copy.</param>
  32514. <param name="destination">The destination folder.</param>
  32515. <param name="cancellationToken">The cancellation token.</param>
  32516. </member>
  32517. <member name="M:MailKit.IMailFolder.CopyTo(System.Int32,MailKit.IMailFolder,System.Threading.CancellationToken)">
  32518. <summary>
  32519. Copy the specified message to the destination folder.
  32520. </summary>
  32521. <remarks>
  32522. Copies the specified message to the destination folder.
  32523. </remarks>
  32524. <param name="index">The index of the message to copy.</param>
  32525. <param name="destination">The destination folder.</param>
  32526. <param name="cancellationToken">The cancellation token.</param>
  32527. </member>
  32528. <member name="M:MailKit.IMailFolder.CopyToAsync(System.Int32,MailKit.IMailFolder,System.Threading.CancellationToken)">
  32529. <summary>
  32530. Asynchronously copy the specified message to the destination folder.
  32531. </summary>
  32532. <remarks>
  32533. Asynchronously copies the specified message to the destination folder.
  32534. </remarks>
  32535. <returns>An asynchronous task context.</returns>
  32536. <param name="index">The indexes of the message to copy.</param>
  32537. <param name="destination">The destination folder.</param>
  32538. <param name="cancellationToken">The cancellation token.</param>
  32539. </member>
  32540. <member name="M:MailKit.IMailFolder.CopyTo(System.Collections.Generic.IList{System.Int32},MailKit.IMailFolder,System.Threading.CancellationToken)">
  32541. <summary>
  32542. Copy the specified messages to the destination folder.
  32543. </summary>
  32544. <remarks>
  32545. Copies the specified messages to the destination folder.
  32546. </remarks>
  32547. <param name="indexes">The indexes of the messages to copy.</param>
  32548. <param name="destination">The destination folder.</param>
  32549. <param name="cancellationToken">The cancellation token.</param>
  32550. </member>
  32551. <member name="M:MailKit.IMailFolder.CopyToAsync(System.Collections.Generic.IList{System.Int32},MailKit.IMailFolder,System.Threading.CancellationToken)">
  32552. <summary>
  32553. Asynchronously copy the specified messages to the destination folder.
  32554. </summary>
  32555. <remarks>
  32556. Asynchronously copies the specified messages to the destination folder.
  32557. </remarks>
  32558. <returns>An asynchronous task context.</returns>
  32559. <param name="indexes">The indexes of the messages to copy.</param>
  32560. <param name="destination">The destination folder.</param>
  32561. <param name="cancellationToken">The cancellation token.</param>
  32562. </member>
  32563. <member name="M:MailKit.IMailFolder.MoveTo(System.Int32,MailKit.IMailFolder,System.Threading.CancellationToken)">
  32564. <summary>
  32565. Move the specified message to the destination folder.
  32566. </summary>
  32567. <remarks>
  32568. Moves the specified message to the destination folder.
  32569. </remarks>
  32570. <param name="index">The index of the message to move.</param>
  32571. <param name="destination">The destination folder.</param>
  32572. <param name="cancellationToken">The cancellation token.</param>
  32573. </member>
  32574. <member name="M:MailKit.IMailFolder.MoveToAsync(System.Int32,MailKit.IMailFolder,System.Threading.CancellationToken)">
  32575. <summary>
  32576. Asynchronously move the specified message to the destination folder.
  32577. </summary>
  32578. <remarks>
  32579. Asynchronously moves the specified message to the destination folder.
  32580. </remarks>
  32581. <returns>An asynchronous task context.</returns>
  32582. <param name="index">The index of the message to move.</param>
  32583. <param name="destination">The destination folder.</param>
  32584. <param name="cancellationToken">The cancellation token.</param>
  32585. </member>
  32586. <member name="M:MailKit.IMailFolder.MoveTo(System.Collections.Generic.IList{System.Int32},MailKit.IMailFolder,System.Threading.CancellationToken)">
  32587. <summary>
  32588. Move the specified messages to the destination folder.
  32589. </summary>
  32590. <remarks>
  32591. Moves the specified messages to the destination folder.
  32592. </remarks>
  32593. <param name="indexes">The indexes of the messages to move.</param>
  32594. <param name="destination">The destination folder.</param>
  32595. <param name="cancellationToken">The cancellation token.</param>
  32596. </member>
  32597. <member name="M:MailKit.IMailFolder.MoveToAsync(System.Collections.Generic.IList{System.Int32},MailKit.IMailFolder,System.Threading.CancellationToken)">
  32598. <summary>
  32599. Asynchronously move the specified messages to the destination folder.
  32600. </summary>
  32601. <remarks>
  32602. Asynchronously moves the specified messages to the destination folder.
  32603. </remarks>
  32604. <returns>An asynchronous task context.</returns>
  32605. <param name="indexes">The indexes of the messages to move.</param>
  32606. <param name="destination">The destination folder.</param>
  32607. <param name="cancellationToken">The cancellation token.</param>
  32608. </member>
  32609. <member name="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  32610. <summary>
  32611. Fetch the message summaries for the specified message UIDs.
  32612. </summary>
  32613. <remarks>
  32614. <para>Fetches the message summaries for the specified message UIDs.</para>
  32615. <para>It should be noted that if another client has modified any message
  32616. in the folder, the mail service may choose to return information that was
  32617. not explicitly requested. It is therefore important to be prepared to
  32618. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32619. messages that were requested as well as summaries for messages that were
  32620. not requested at all.</para>
  32621. </remarks>
  32622. <example>
  32623. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  32624. </example>
  32625. <returns>An enumeration of summaries for the requested messages.</returns>
  32626. <param name="uids">The UIDs.</param>
  32627. <param name="items">The message summary items to fetch.</param>
  32628. <param name="cancellationToken">The cancellation token.</param>
  32629. </member>
  32630. <member name="M:MailKit.IMailFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  32631. <summary>
  32632. Asynchronously fetch the message summaries for the specified message UIDs.
  32633. </summary>
  32634. <remarks>
  32635. <para>Asynchronously fetches the message summaries for the specified message
  32636. UIDs.</para>
  32637. <para>It should be noted that if another client has modified any message
  32638. in the folder, the mail service may choose to return information that was
  32639. not explicitly requested. It is therefore important to be prepared to
  32640. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32641. messages that were requested as well as summaries for messages that were
  32642. not requested at all.</para>
  32643. </remarks>
  32644. <returns>An enumeration of summaries for the requested messages.</returns>
  32645. <param name="uids">The UIDs.</param>
  32646. <param name="items">The message summary items to fetch.</param>
  32647. <param name="cancellationToken">The cancellation token.</param>
  32648. </member>
  32649. <member name="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  32650. <summary>
  32651. Fetch the message summaries for the specified message UIDs.
  32652. </summary>
  32653. <remarks>
  32654. <para>Fetches the message summaries for the specified message UIDs.</para>
  32655. <para>It should be noted that if another client has modified any message
  32656. in the folder, the mail service may choose to return information that was
  32657. not explicitly requested. It is therefore important to be prepared to
  32658. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32659. messages that were requested as well as summaries for messages that were
  32660. not requested at all.</para>
  32661. </remarks>
  32662. <returns>An enumeration of summaries for the requested messages.</returns>
  32663. <param name="uids">The UIDs.</param>
  32664. <param name="items">The message summary items to fetch.</param>
  32665. <param name="headers">The desired header fields.</param>
  32666. <param name="cancellationToken">The cancellation token.</param>
  32667. </member>
  32668. <member name="M:MailKit.IMailFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  32669. <summary>
  32670. Asynchronously fetch the message summaries for the specified message UIDs.
  32671. </summary>
  32672. <remarks>
  32673. <para>Asynchronously fetches the message summaries for the specified message
  32674. UIDs.</para>
  32675. <para>It should be noted that if another client has modified any message
  32676. in the folder, the mail service may choose to return information that was
  32677. not explicitly requested. It is therefore important to be prepared to
  32678. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32679. messages that were requested as well as summaries for messages that were
  32680. not requested at all.</para>
  32681. </remarks>
  32682. <returns>An enumeration of summaries for the requested messages.</returns>
  32683. <param name="uids">The UIDs.</param>
  32684. <param name="items">The message summary items to fetch.</param>
  32685. <param name="headers">The desired header fields.</param>
  32686. <param name="cancellationToken">The cancellation token.</param>
  32687. </member>
  32688. <member name="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  32689. <summary>
  32690. Fetch the message summaries for the specified message UIDs.
  32691. </summary>
  32692. <remarks>
  32693. <para>Fetches the message summaries for the specified message UIDs.</para>
  32694. <para>It should be noted that if another client has modified any message
  32695. in the folder, the mail service may choose to return information that was
  32696. not explicitly requested. It is therefore important to be prepared to
  32697. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32698. messages that were requested as well as summaries for messages that were
  32699. not requested at all.</para>
  32700. </remarks>
  32701. <returns>An enumeration of summaries for the requested messages.</returns>
  32702. <param name="uids">The UIDs.</param>
  32703. <param name="items">The message summary items to fetch.</param>
  32704. <param name="headers">The desired header fields.</param>
  32705. <param name="cancellationToken">The cancellation token.</param>
  32706. </member>
  32707. <member name="M:MailKit.IMailFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  32708. <summary>
  32709. Asynchronously fetch the message summaries for the specified message UIDs.
  32710. </summary>
  32711. <remarks>
  32712. <para>Asynchronously fetches the message summaries for the specified message
  32713. UIDs.</para>
  32714. <para>It should be noted that if another client has modified any message
  32715. in the folder, the mail service may choose to return information that was
  32716. not explicitly requested. It is therefore important to be prepared to
  32717. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32718. messages that were requested as well as summaries for messages that were
  32719. not requested at all.</para>
  32720. </remarks>
  32721. <returns>An enumeration of summaries for the requested messages.</returns>
  32722. <param name="uids">The UIDs.</param>
  32723. <param name="items">The message summary items to fetch.</param>
  32724. <param name="headers">The desired header fields.</param>
  32725. <param name="cancellationToken">The cancellation token.</param>
  32726. </member>
  32727. <member name="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  32728. <summary>
  32729. Fetch the message summaries for the specified message UIDs that have a
  32730. higher mod-sequence value than the one specified.
  32731. </summary>
  32732. <remarks>
  32733. <para>Fetches the message summaries for the specified message UIDs that
  32734. have a higher mod-sequence value than the one specified.</para>
  32735. <para>If the mail store supports quick resynchronization and the application has
  32736. enabled this feature via <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/>,
  32737. then this method will emit <see cref="E:MailKit.IMailFolder.MessagesVanished"/> events for messages that
  32738. have vanished since the specified mod-sequence value.</para>
  32739. <para>It should be noted that if another client has modified any message
  32740. in the folder, the mail service may choose to return information that was
  32741. not explicitly requested. It is therefore important to be prepared to
  32742. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32743. messages that were requested as well as summaries for messages that were
  32744. not requested at all.</para>
  32745. </remarks>
  32746. <returns>An enumeration of summaries for the requested messages.</returns>
  32747. <param name="uids">The UIDs.</param>
  32748. <param name="modseq">The mod-sequence value.</param>
  32749. <param name="items">The message summary items to fetch.</param>
  32750. <param name="cancellationToken">The cancellation token.</param>
  32751. </member>
  32752. <member name="M:MailKit.IMailFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  32753. <summary>
  32754. Asynchronously fetch the message summaries for the specified message UIDs that have a
  32755. higher mod-sequence value than the one specified.
  32756. </summary>
  32757. <remarks>
  32758. <para>Asynchronously fetches the message summaries for the specified message UIDs that
  32759. have a higher mod-sequence value than the one specified.</para>
  32760. <para>If the mail store supports quick resynchronization and the application has
  32761. enabled this feature via <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/>,
  32762. then this method will emit <see cref="E:MailKit.IMailFolder.MessagesVanished"/> events for messages that
  32763. have vanished since the specified mod-sequence value.</para>
  32764. <para>It should be noted that if another client has modified any message
  32765. in the folder, the mail service may choose to return information that was
  32766. not explicitly requested. It is therefore important to be prepared to
  32767. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32768. messages that were requested as well as summaries for messages that were
  32769. not requested at all.</para>
  32770. </remarks>
  32771. <returns>An enumeration of summaries for the requested messages.</returns>
  32772. <param name="uids">The UIDs.</param>
  32773. <param name="modseq">The mod-sequence value.</param>
  32774. <param name="items">The message summary items to fetch.</param>
  32775. <param name="cancellationToken">The cancellation token.</param>
  32776. </member>
  32777. <member name="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  32778. <summary>
  32779. Fetch the message summaries for the specified message UIDs that have a
  32780. higher mod-sequence value than the one specified.
  32781. </summary>
  32782. <remarks>
  32783. <para>Fetches the message summaries for the specified message UIDs that
  32784. have a higher mod-sequence value than the one specified.</para>
  32785. <para>If the mail store supports quick resynchronization and the application has
  32786. enabled this feature via <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/>,
  32787. then this method will emit <see cref="E:MailKit.IMailFolder.MessagesVanished"/> events for messages that
  32788. have vanished since the specified mod-sequence value.</para>
  32789. <para>It should be noted that if another client has modified any message
  32790. in the folder, the mail service may choose to return information that was
  32791. not explicitly requested. It is therefore important to be prepared to
  32792. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32793. messages that were requested as well as summaries for messages that were
  32794. not requested at all.</para>
  32795. </remarks>
  32796. <returns>An enumeration of summaries for the requested messages.</returns>
  32797. <param name="uids">The UIDs.</param>
  32798. <param name="modseq">The mod-sequence value.</param>
  32799. <param name="items">The message summary items to fetch.</param>
  32800. <param name="headers">The desired header fields.</param>
  32801. <param name="cancellationToken">The cancellation token.</param>
  32802. </member>
  32803. <member name="M:MailKit.IMailFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  32804. <summary>
  32805. Asynchronously fetch the message summaries for the specified message UIDs that have a
  32806. higher mod-sequence value than the one specified.
  32807. </summary>
  32808. <remarks>
  32809. <para>Asynchronously fetches the message summaries for the specified message UIDs that
  32810. have a higher mod-sequence value than the one specified.</para>
  32811. <para>If the mail store supports quick resynchronization and the application has
  32812. enabled this feature via <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/>,
  32813. then this method will emit <see cref="E:MailKit.IMailFolder.MessagesVanished"/> events for messages that
  32814. have vanished since the specified mod-sequence value.</para>
  32815. <para>It should be noted that if another client has modified any message
  32816. in the folder, the mail service may choose to return information that was
  32817. not explicitly requested. It is therefore important to be prepared to
  32818. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32819. messages that were requested as well as summaries for messages that were
  32820. not requested at all.</para>
  32821. </remarks>
  32822. <returns>An enumeration of summaries for the requested messages.</returns>
  32823. <param name="uids">The UIDs.</param>
  32824. <param name="modseq">The mod-sequence value.</param>
  32825. <param name="items">The message summary items to fetch.</param>
  32826. <param name="headers">The desired header fields.</param>
  32827. <param name="cancellationToken">The cancellation token.</param>
  32828. </member>
  32829. <member name="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  32830. <summary>
  32831. Fetch the message summaries for the specified message UIDs that have a
  32832. higher mod-sequence value than the one specified.
  32833. </summary>
  32834. <remarks>
  32835. <para>Fetches the message summaries for the specified message UIDs that
  32836. have a higher mod-sequence value than the one specified.</para>
  32837. <para>If the mail store supports quick resynchronization and the application has
  32838. enabled this feature via <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/>,
  32839. then this method will emit <see cref="E:MailKit.IMailFolder.MessagesVanished"/> events for messages that
  32840. have vanished since the specified mod-sequence value.</para>
  32841. <para>It should be noted that if another client has modified any message
  32842. in the folder, the mail service may choose to return information that was
  32843. not explicitly requested. It is therefore important to be prepared to
  32844. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32845. messages that were requested as well as summaries for messages that were
  32846. not requested at all.</para>
  32847. </remarks>
  32848. <returns>An enumeration of summaries for the requested messages.</returns>
  32849. <param name="uids">The UIDs.</param>
  32850. <param name="modseq">The mod-sequence value.</param>
  32851. <param name="items">The message summary items to fetch.</param>
  32852. <param name="headers">The desired header fields.</param>
  32853. <param name="cancellationToken">The cancellation token.</param>
  32854. </member>
  32855. <member name="M:MailKit.IMailFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  32856. <summary>
  32857. Asynchronously fetch the message summaries for the specified message UIDs that have a
  32858. higher mod-sequence value than the one specified.
  32859. </summary>
  32860. <remarks>
  32861. <para>Asynchronously fetches the message summaries for the specified message UIDs that
  32862. have a higher mod-sequence value than the one specified.</para>
  32863. <para>If the mail store supports quick resynchronization and the application has
  32864. enabled this feature via <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/>,
  32865. then this method will emit <see cref="E:MailKit.IMailFolder.MessagesVanished"/> events for messages that
  32866. have vanished since the specified mod-sequence value.</para>
  32867. <para>It should be noted that if another client has modified any message
  32868. in the folder, the mail service may choose to return information that was
  32869. not explicitly requested. It is therefore important to be prepared to
  32870. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32871. messages that were requested as well as summaries for messages that were
  32872. not requested at all.</para>
  32873. </remarks>
  32874. <returns>An enumeration of summaries for the requested messages.</returns>
  32875. <param name="uids">The UIDs.</param>
  32876. <param name="modseq">The mod-sequence value.</param>
  32877. <param name="items">The message summary items to fetch.</param>
  32878. <param name="headers">The desired header fields.</param>
  32879. <param name="cancellationToken">The cancellation token.</param>
  32880. </member>
  32881. <member name="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  32882. <summary>
  32883. Fetch the message summaries for the specified message indexes.
  32884. </summary>
  32885. <remarks>
  32886. <para>Fetches the message summaries for the specified message indexes.</para>
  32887. <para>It should be noted that if another client has modified any message
  32888. in the folder, the mail service may choose to return information that was
  32889. not explicitly requested. It is therefore important to be prepared to
  32890. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32891. messages that were requested as well as summaries for messages that were
  32892. not requested at all.</para>
  32893. </remarks>
  32894. <returns>An enumeration of summaries for the requested messages.</returns>
  32895. <param name="indexes">The indexes.</param>
  32896. <param name="items">The message summary items to fetch.</param>
  32897. <param name="cancellationToken">The cancellation token.</param>
  32898. </member>
  32899. <member name="M:MailKit.IMailFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  32900. <summary>
  32901. Asynchronously fetch the message summaries for the specified message indexes.
  32902. </summary>
  32903. <remarks>
  32904. <para>Asynchronously fetches the message summaries for the specified message
  32905. indexes.</para>
  32906. <para>It should be noted that if another client has modified any message
  32907. in the folder, the mail service may choose to return information that was
  32908. not explicitly requested. It is therefore important to be prepared to
  32909. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32910. messages that were requested as well as summaries for messages that were
  32911. not requested at all.</para>
  32912. </remarks>
  32913. <returns>An enumeration of summaries for the requested messages.</returns>
  32914. <param name="indexes">The indexes.</param>
  32915. <param name="items">The message summary items to fetch.</param>
  32916. <param name="cancellationToken">The cancellation token.</param>
  32917. </member>
  32918. <member name="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  32919. <summary>
  32920. Fetch the message summaries for the specified message indexes.
  32921. </summary>
  32922. <remarks>
  32923. <para>Fetches the message summaries for the specified message indexes.</para>
  32924. <para>It should be noted that if another client has modified any message
  32925. in the folder, the mail service may choose to return information that was
  32926. not explicitly requested. It is therefore important to be prepared to
  32927. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32928. messages that were requested as well as summaries for messages that were
  32929. not requested at all.</para>
  32930. </remarks>
  32931. <returns>An enumeration of summaries for the requested messages.</returns>
  32932. <param name="indexes">The indexes.</param>
  32933. <param name="items">The message summary items to fetch.</param>
  32934. <param name="headers">The desired header fields.</param>
  32935. <param name="cancellationToken">The cancellation token.</param>
  32936. </member>
  32937. <member name="M:MailKit.IMailFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  32938. <summary>
  32939. Asynchronously fetch the message summaries for the specified message indexes.
  32940. </summary>
  32941. <remarks>
  32942. <para>Asynchronously fetches the message summaries for the specified message
  32943. indexes.</para>
  32944. <para>It should be noted that if another client has modified any message
  32945. in the folder, the mail service may choose to return information that was
  32946. not explicitly requested. It is therefore important to be prepared to
  32947. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32948. messages that were requested as well as summaries for messages that were
  32949. not requested at all.</para>
  32950. </remarks>
  32951. <returns>An enumeration of summaries for the requested messages.</returns>
  32952. <param name="indexes">The indexes.</param>
  32953. <param name="items">The message summary items to fetch.</param>
  32954. <param name="headers">The desired header fields.</param>
  32955. <param name="cancellationToken">The cancellation token.</param>
  32956. </member>
  32957. <member name="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  32958. <summary>
  32959. Fetch the message summaries for the specified message indexes.
  32960. </summary>
  32961. <remarks>
  32962. <para>Fetches the message summaries for the specified message indexes.</para>
  32963. <para>It should be noted that if another client has modified any message
  32964. in the folder, the mail service may choose to return information that was
  32965. not explicitly requested. It is therefore important to be prepared to
  32966. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32967. messages that were requested as well as summaries for messages that were
  32968. not requested at all.</para>
  32969. </remarks>
  32970. <returns>An enumeration of summaries for the requested messages.</returns>
  32971. <param name="indexes">The indexes.</param>
  32972. <param name="items">The message summary items to fetch.</param>
  32973. <param name="headers">The desired header fields.</param>
  32974. <param name="cancellationToken">The cancellation token.</param>
  32975. </member>
  32976. <member name="M:MailKit.IMailFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  32977. <summary>
  32978. Asynchronously fetch the message summaries for the specified message indexes.
  32979. </summary>
  32980. <remarks>
  32981. <para>Asynchronously fetches the message summaries for the specified message
  32982. indexes.</para>
  32983. <para>It should be noted that if another client has modified any message
  32984. in the folder, the mail service may choose to return information that was
  32985. not explicitly requested. It is therefore important to be prepared to
  32986. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  32987. messages that were requested as well as summaries for messages that were
  32988. not requested at all.</para>
  32989. </remarks>
  32990. <returns>An enumeration of summaries for the requested messages.</returns>
  32991. <param name="indexes">The indexes.</param>
  32992. <param name="items">The message summary items to fetch.</param>
  32993. <param name="headers">The desired header fields.</param>
  32994. <param name="cancellationToken">The cancellation token.</param>
  32995. </member>
  32996. <member name="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  32997. <summary>
  32998. Fetch the message summaries for the specified message indexes that have a
  32999. higher mod-sequence value than the one specified.
  33000. </summary>
  33001. <remarks>
  33002. <para>Fetches the message summaries for the specified message indexes that
  33003. have a higher mod-sequence value than the one specified.</para>
  33004. <para>It should be noted that if another client has modified any message
  33005. in the folder, the mail service may choose to return information that was
  33006. not explicitly requested. It is therefore important to be prepared to
  33007. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33008. messages that were requested as well as summaries for messages that were
  33009. not requested at all.</para>
  33010. </remarks>
  33011. <returns>An enumeration of summaries for the requested messages.</returns>
  33012. <param name="indexes">The indexes.</param>
  33013. <param name="modseq">The mod-sequence value.</param>
  33014. <param name="items">The message summary items to fetch.</param>
  33015. <param name="cancellationToken">The cancellation token.</param>
  33016. </member>
  33017. <member name="M:MailKit.IMailFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  33018. <summary>
  33019. Asynchronously fetch the message summaries for the specified message indexes that have a
  33020. higher mod-sequence value than the one specified.
  33021. </summary>
  33022. <remarks>
  33023. <para>Asynchronously fetches the message summaries for the specified message
  33024. indexes that have a higher mod-sequence value than the one specified.</para>
  33025. <para>It should be noted that if another client has modified any message
  33026. in the folder, the mail service may choose to return information that was
  33027. not explicitly requested. It is therefore important to be prepared to
  33028. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33029. messages that were requested as well as summaries for messages that were
  33030. not requested at all.</para>
  33031. </remarks>
  33032. <returns>An enumeration of summaries for the requested messages.</returns>
  33033. <param name="indexes">The indexes.</param>
  33034. <param name="modseq">The mod-sequence value.</param>
  33035. <param name="items">The message summary items to fetch.</param>
  33036. <param name="cancellationToken">The cancellation token.</param>
  33037. </member>
  33038. <member name="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  33039. <summary>
  33040. Fetch the message summaries for the specified message indexes that have a
  33041. higher mod-sequence value than the one specified.
  33042. </summary>
  33043. <remarks>
  33044. <para>Fetches the message summaries for the specified message indexes that
  33045. have a higher mod-sequence value than the one specified.</para>
  33046. <para>It should be noted that if another client has modified any message
  33047. in the folder, the mail service may choose to return information that was
  33048. not explicitly requested. It is therefore important to be prepared to
  33049. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33050. messages that were requested as well as summaries for messages that were
  33051. not requested at all.</para>
  33052. </remarks>
  33053. <returns>An enumeration of summaries for the requested messages.</returns>
  33054. <param name="indexes">The indexes.</param>
  33055. <param name="modseq">The mod-sequence value.</param>
  33056. <param name="items">The message summary items to fetch.</param>
  33057. <param name="headers">The desired header fields.</param>
  33058. <param name="cancellationToken">The cancellation token.</param>
  33059. </member>
  33060. <member name="M:MailKit.IMailFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  33061. <summary>
  33062. Asynchronously fetch the message summaries for the specified message indexes
  33063. that have a higher mod-sequence value than the one specified.
  33064. </summary>
  33065. <remarks>
  33066. <para>Asynchronously fetches the message summaries for the specified message
  33067. indexes that have a higher mod-sequence value than the one specified.</para>
  33068. <para>It should be noted that if another client has modified any message
  33069. in the folder, the mail service may choose to return information that was
  33070. not explicitly requested. It is therefore important to be prepared to
  33071. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33072. messages that were requested as well as summaries for messages that were
  33073. not requested at all.</para>
  33074. </remarks>
  33075. <returns>An enumeration of summaries for the requested messages.</returns>
  33076. <param name="indexes">The indexes.</param>
  33077. <param name="modseq">The mod-sequence value.</param>
  33078. <param name="items">The message summary items to fetch.</param>
  33079. <param name="headers">The desired header fields.</param>
  33080. <param name="cancellationToken">The cancellation token.</param>
  33081. </member>
  33082. <member name="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  33083. <summary>
  33084. Fetch the message summaries for the specified message indexes that
  33085. have a higher mod-sequence value than the one specified.
  33086. </summary>
  33087. <remarks>
  33088. <para>Fetches the message summaries for the specified message indexes that
  33089. have a higher mod-sequence value than the one specified.</para>
  33090. <para>It should be noted that if another client has modified any message
  33091. in the folder, the mail service may choose to return information that was
  33092. not explicitly requested. It is therefore important to be prepared to
  33093. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33094. messages that were requested as well as summaries for messages that were
  33095. not requested at all.</para>
  33096. </remarks>
  33097. <returns>An enumeration of summaries for the requested messages.</returns>
  33098. <param name="indexes">The indexes.</param>
  33099. <param name="modseq">The mod-sequence value.</param>
  33100. <param name="items">The message summary items to fetch.</param>
  33101. <param name="headers">The desired header fields.</param>
  33102. <param name="cancellationToken">The cancellation token.</param>
  33103. </member>
  33104. <member name="M:MailKit.IMailFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  33105. <summary>
  33106. Asynchronously fetch the message summaries for the specified message indexes
  33107. that have a higher mod-sequence value than the one specified.
  33108. </summary>
  33109. <remarks>
  33110. <para>Asynchronously fetches the message summaries for the specified message
  33111. indexes that have a higher mod-sequence value than the one specified.</para>
  33112. <para>It should be noted that if another client has modified any message
  33113. in the folder, the mail service may choose to return information that was
  33114. not explicitly requested. It is therefore important to be prepared to
  33115. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33116. messages that were requested as well as summaries for messages that were
  33117. not requested at all.</para>
  33118. </remarks>
  33119. <returns>An enumeration of summaries for the requested messages.</returns>
  33120. <param name="indexes">The indexes.</param>
  33121. <param name="modseq">The mod-sequence value.</param>
  33122. <param name="items">The message summary items to fetch.</param>
  33123. <param name="headers">The desired header fields.</param>
  33124. <param name="cancellationToken">The cancellation token.</param>
  33125. </member>
  33126. <member name="M:MailKit.IMailFolder.Fetch(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  33127. <summary>
  33128. Fetch the message summaries for the messages between the two indexes, inclusive.
  33129. </summary>
  33130. <remarks>
  33131. <para>Fetches the message summaries for the messages between the two
  33132. indexes, inclusive.</para>
  33133. <para>It should be noted that if another client has modified any message
  33134. in the folder, the mail service may choose to return information that was
  33135. not explicitly requested. It is therefore important to be prepared to
  33136. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33137. messages that were requested as well as summaries for messages that were
  33138. not requested at all.</para>
  33139. </remarks>
  33140. <returns>An enumeration of summaries for the requested messages.</returns>
  33141. <param name="min">The minimum index.</param>
  33142. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  33143. <param name="items">The message summary items to fetch.</param>
  33144. <param name="cancellationToken">The cancellation token.</param>
  33145. </member>
  33146. <member name="M:MailKit.IMailFolder.FetchAsync(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  33147. <summary>
  33148. Asynchronously fetch the message summaries for the messages between the two indexes, inclusive.
  33149. </summary>
  33150. <remarks>
  33151. <para>Asynchronously fetches the message summaries for the messages between
  33152. the two indexes, inclusive.</para>
  33153. <para>It should be noted that if another client has modified any message
  33154. in the folder, the mail service may choose to return information that was
  33155. not explicitly requested. It is therefore important to be prepared to
  33156. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33157. messages that were requested as well as summaries for messages that were
  33158. not requested at all.</para>
  33159. </remarks>
  33160. <returns>An enumeration of summaries for the requested messages.</returns>
  33161. <param name="min">The minimum index.</param>
  33162. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  33163. <param name="items">The message summary items to fetch.</param>
  33164. <param name="cancellationToken">The cancellation token.</param>
  33165. </member>
  33166. <member name="M:MailKit.IMailFolder.Fetch(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  33167. <summary>
  33168. Fetch the message summaries for the messages between the two indexes, inclusive.
  33169. </summary>
  33170. <remarks>
  33171. <para>Fetches the message summaries for the messages between the two
  33172. indexes, inclusive.</para>
  33173. <para>It should be noted that if another client has modified any message
  33174. in the folder, the mail service may choose to return information that was
  33175. not explicitly requested. It is therefore important to be prepared to
  33176. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33177. messages that were requested as well as summaries for messages that were
  33178. not requested at all.</para>
  33179. </remarks>
  33180. <returns>An enumeration of summaries for the requested messages.</returns>
  33181. <param name="min">The minimum index.</param>
  33182. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  33183. <param name="items">The message summary items to fetch.</param>
  33184. <param name="headers">The desired header fields.</param>
  33185. <param name="cancellationToken">The cancellation token.</param>
  33186. </member>
  33187. <member name="M:MailKit.IMailFolder.FetchAsync(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  33188. <summary>
  33189. Asynchronously fetch the message summaries for the messages between the two indexes, inclusive.
  33190. </summary>
  33191. <remarks>
  33192. <para>Asynchronously fetches the message summaries for the messages between
  33193. the two indexes, inclusive.</para>
  33194. <para>It should be noted that if another client has modified any message
  33195. in the folder, the mail service may choose to return information that was
  33196. not explicitly requested. It is therefore important to be prepared to
  33197. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33198. messages that were requested as well as summaries for messages that were
  33199. not requested at all.</para>
  33200. </remarks>
  33201. <returns>An enumeration of summaries for the requested messages.</returns>
  33202. <param name="min">The minimum index.</param>
  33203. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  33204. <param name="items">The message summary items to fetch.</param>
  33205. <param name="headers">The desired header fields.</param>
  33206. <param name="cancellationToken">The cancellation token.</param>
  33207. </member>
  33208. <member name="M:MailKit.IMailFolder.Fetch(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  33209. <summary>
  33210. Fetch the message summaries for the messages between the two indexes, inclusive.
  33211. </summary>
  33212. <remarks>
  33213. <para>Fetches the message summaries for the messages between the two
  33214. indexes, inclusive.</para>
  33215. <para>It should be noted that if another client has modified any message
  33216. in the folder, the mail service may choose to return information that was
  33217. not explicitly requested. It is therefore important to be prepared to
  33218. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33219. messages that were requested as well as summaries for messages that were
  33220. not requested at all.</para>
  33221. </remarks>
  33222. <returns>An enumeration of summaries for the requested messages.</returns>
  33223. <param name="min">The minimum index.</param>
  33224. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  33225. <param name="items">The message summary items to fetch.</param>
  33226. <param name="headers">The desired header fields.</param>
  33227. <param name="cancellationToken">The cancellation token.</param>
  33228. </member>
  33229. <member name="M:MailKit.IMailFolder.FetchAsync(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  33230. <summary>
  33231. Asynchronously fetch the message summaries for the messages between the two indexes, inclusive.
  33232. </summary>
  33233. <remarks>
  33234. <para>Asynchronously fetches the message summaries for the messages between
  33235. the two indexes, inclusive.</para>
  33236. <para>It should be noted that if another client has modified any message
  33237. in the folder, the mail service may choose to return information that was
  33238. not explicitly requested. It is therefore important to be prepared to
  33239. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33240. messages that were requested as well as summaries for messages that were
  33241. not requested at all.</para>
  33242. </remarks>
  33243. <returns>An enumeration of summaries for the requested messages.</returns>
  33244. <param name="min">The minimum index.</param>
  33245. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  33246. <param name="items">The message summary items to fetch.</param>
  33247. <param name="headers">The desired header fields.</param>
  33248. <param name="cancellationToken">The cancellation token.</param>
  33249. </member>
  33250. <member name="M:MailKit.IMailFolder.Fetch(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  33251. <summary>
  33252. Fetch the message summaries for the messages between the two indexes (inclusive)
  33253. that have a higher mod-sequence value than the one specified.
  33254. </summary>
  33255. <remarks>
  33256. <para>Fetches the message summaries for the messages between the two
  33257. indexes (inclusive) that have a higher mod-sequence value than the one
  33258. specified.</para>
  33259. <para>It should be noted that if another client has modified any message
  33260. in the folder, the mail service may choose to return information that was
  33261. not explicitly requested. It is therefore important to be prepared to
  33262. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33263. messages that were requested as well as summaries for messages that were
  33264. not requested at all.</para>
  33265. </remarks>
  33266. <returns>An enumeration of summaries for the requested messages.</returns>
  33267. <param name="min">The minimum index.</param>
  33268. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  33269. <param name="modseq">The mod-sequence value.</param>
  33270. <param name="items">The message summary items to fetch.</param>
  33271. <param name="cancellationToken">The cancellation token.</param>
  33272. </member>
  33273. <member name="M:MailKit.IMailFolder.FetchAsync(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  33274. <summary>
  33275. Asynchronously fetch the message summaries for the messages between the two indexes
  33276. (inclusive) that have a higher mod-sequence value than the one specified.
  33277. </summary>
  33278. <remarks>
  33279. <para>Asynchronously fetches the message summaries for the messages between
  33280. the two indexes (inclusive) that have a higher mod-sequence value than the
  33281. one specified.</para>
  33282. <para>It should be noted that if another client has modified any message
  33283. in the folder, the mail service may choose to return information that was
  33284. not explicitly requested. It is therefore important to be prepared to
  33285. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33286. messages that were requested as well as summaries for messages that were
  33287. not requested at all.</para>
  33288. </remarks>
  33289. <returns>An enumeration of summaries for the requested messages.</returns>
  33290. <param name="min">The minimum index.</param>
  33291. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  33292. <param name="modseq">The mod-sequence value.</param>
  33293. <param name="items">The message summary items to fetch.</param>
  33294. <param name="cancellationToken">The cancellation token.</param>
  33295. </member>
  33296. <member name="M:MailKit.IMailFolder.Fetch(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  33297. <summary>
  33298. Fetch the message summaries for the messages between the two indexes (inclusive)
  33299. that have a higher mod-sequence value than the one specified.
  33300. </summary>
  33301. <remarks>
  33302. <para>Fetches the message summaries for the messages between the two
  33303. indexes (inclusive) that have a higher mod-sequence value than the one
  33304. specified.</para>
  33305. <para>It should be noted that if another client has modified any message
  33306. in the folder, the mail service may choose to return information that was
  33307. not explicitly requested. It is therefore important to be prepared to
  33308. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33309. messages that were requested as well as summaries for messages that were
  33310. not requested at all.</para>
  33311. </remarks>
  33312. <returns>An enumeration of summaries for the requested messages.</returns>
  33313. <param name="min">The minimum index.</param>
  33314. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  33315. <param name="modseq">The mod-sequence value.</param>
  33316. <param name="items">The message summary items to fetch.</param>
  33317. <param name="headers">The desired header fields.</param>
  33318. <param name="cancellationToken">The cancellation token.</param>
  33319. </member>
  33320. <member name="M:MailKit.IMailFolder.FetchAsync(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  33321. <summary>
  33322. Asynchronously fetch the message summaries for the messages between the two indexes
  33323. (inclusive) that have a higher mod-sequence value than the one specified.
  33324. </summary>
  33325. <remarks>
  33326. <para>Asynchronously fetches the message summaries for the messages between
  33327. the two indexes (inclusive) that have a higher mod-sequence value than the
  33328. one specified.</para>
  33329. <para>It should be noted that if another client has modified any message
  33330. in the folder, the mail service may choose to return information that was
  33331. not explicitly requested. It is therefore important to be prepared to
  33332. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33333. messages that were requested as well as summaries for messages that were
  33334. not requested at all.</para>
  33335. </remarks>
  33336. <returns>An enumeration of summaries for the requested messages.</returns>
  33337. <param name="min">The minimum index.</param>
  33338. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  33339. <param name="modseq">The mod-sequence value.</param>
  33340. <param name="items">The message summary items to fetch.</param>
  33341. <param name="headers">The desired header fields.</param>
  33342. <param name="cancellationToken">The cancellation token.</param>
  33343. </member>
  33344. <member name="M:MailKit.IMailFolder.Fetch(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  33345. <summary>
  33346. Fetch the message summaries for the messages between the two indexes (inclusive)
  33347. that have a higher mod-sequence value than the one specified.
  33348. </summary>
  33349. <remarks>
  33350. <para>Fetches the message summaries for the messages between the two
  33351. indexes (inclusive) that have a higher mod-sequence value than the one
  33352. specified.</para>
  33353. <para>It should be noted that if another client has modified any message
  33354. in the folder, the mail service may choose to return information that was
  33355. not explicitly requested. It is therefore important to be prepared to
  33356. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33357. messages that were requested as well as summaries for messages that were
  33358. not requested at all.</para>
  33359. </remarks>
  33360. <returns>An enumeration of summaries for the requested messages.</returns>
  33361. <param name="min">The minimum index.</param>
  33362. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  33363. <param name="modseq">The mod-sequence value.</param>
  33364. <param name="items">The message summary items to fetch.</param>
  33365. <param name="headers">The desired header fields.</param>
  33366. <param name="cancellationToken">The cancellation token.</param>
  33367. </member>
  33368. <member name="M:MailKit.IMailFolder.FetchAsync(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  33369. <summary>
  33370. Asynchronously fetch the message summaries for the messages between the two indexes
  33371. (inclusive) that have a higher mod-sequence value than the one specified.
  33372. </summary>
  33373. <remarks>
  33374. <para>Asynchronously fetches the message summaries for the messages between
  33375. the two indexes (inclusive) that have a higher mod-sequence value than the
  33376. one specified.</para>
  33377. <para>It should be noted that if another client has modified any message
  33378. in the folder, the mail service may choose to return information that was
  33379. not explicitly requested. It is therefore important to be prepared to
  33380. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  33381. messages that were requested as well as summaries for messages that were
  33382. not requested at all.</para>
  33383. </remarks>
  33384. <returns>An enumeration of summaries for the requested messages.</returns>
  33385. <param name="min">The minimum index.</param>
  33386. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  33387. <param name="modseq">The mod-sequence value.</param>
  33388. <param name="items">The message summary items to fetch.</param>
  33389. <param name="headers">The desired header fields.</param>
  33390. <param name="cancellationToken">The cancellation token.</param>
  33391. </member>
  33392. <member name="M:MailKit.IMailFolder.GetHeaders(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33393. <summary>
  33394. Get the specified message headers.
  33395. </summary>
  33396. <remarks>
  33397. Gets the specified message headers.
  33398. </remarks>
  33399. <returns>The message headers.</returns>
  33400. <param name="uid">The UID of the message.</param>
  33401. <param name="cancellationToken">The cancellation token.</param>
  33402. <param name="progress">The progress reporting mechanism.</param>
  33403. </member>
  33404. <member name="M:MailKit.IMailFolder.GetHeadersAsync(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33405. <summary>
  33406. Asynchronously get the specified message headers.
  33407. </summary>
  33408. <remarks>
  33409. Asynchronously gets the specified message headers.
  33410. </remarks>
  33411. <returns>The message headers.</returns>
  33412. <param name="uid">The UID of the message.</param>
  33413. <param name="cancellationToken">The cancellation token.</param>
  33414. <param name="progress">The progress reporting mechanism.</param>
  33415. </member>
  33416. <member name="M:MailKit.IMailFolder.GetHeaders(MailKit.UniqueId,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33417. <summary>
  33418. Get the specified body part headers.
  33419. </summary>
  33420. <remarks>
  33421. Gets the specified body part headers.
  33422. </remarks>
  33423. <returns>The body part headers.</returns>
  33424. <param name="uid">The UID of the message.</param>
  33425. <param name="part">The body part.</param>
  33426. <param name="cancellationToken">The cancellation token.</param>
  33427. <param name="progress">The progress reporting mechanism.</param>
  33428. </member>
  33429. <member name="M:MailKit.IMailFolder.GetHeadersAsync(MailKit.UniqueId,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33430. <summary>
  33431. Asynchronously get the specified body part headers.
  33432. </summary>
  33433. <remarks>
  33434. Asynchronously gets the specified body part headers.
  33435. </remarks>
  33436. <returns>The body part headers.</returns>
  33437. <param name="uid">The UID of the message.</param>
  33438. <param name="part">The body part.</param>
  33439. <param name="cancellationToken">The cancellation token.</param>
  33440. <param name="progress">The progress reporting mechanism.</param>
  33441. </member>
  33442. <member name="M:MailKit.IMailFolder.GetHeaders(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33443. <summary>
  33444. Get the specified message headers.
  33445. </summary>
  33446. <remarks>
  33447. Gets the specified message headers.
  33448. </remarks>
  33449. <returns>The message headers.</returns>
  33450. <param name="index">The index of the message.</param>
  33451. <param name="cancellationToken">The cancellation token.</param>
  33452. <param name="progress">The progress reporting mechanism.</param>
  33453. </member>
  33454. <member name="M:MailKit.IMailFolder.GetHeadersAsync(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33455. <summary>
  33456. Asynchronously get the specified message headers.
  33457. </summary>
  33458. <remarks>
  33459. Asynchronously gets the specified message headers.
  33460. </remarks>
  33461. <returns>The message headers.</returns>
  33462. <param name="index">The index of the message.</param>
  33463. <param name="cancellationToken">The cancellation token.</param>
  33464. <param name="progress">The progress reporting mechanism.</param>
  33465. </member>
  33466. <member name="M:MailKit.IMailFolder.GetHeaders(System.Int32,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33467. <summary>
  33468. Get the specified body part headers.
  33469. </summary>
  33470. <remarks>
  33471. Gets the specified body part headers.
  33472. </remarks>
  33473. <returns>The body part headers.</returns>
  33474. <param name="index">The index of the message.</param>
  33475. <param name="part">The body part.</param>
  33476. <param name="cancellationToken">The cancellation token.</param>
  33477. <param name="progress">The progress reporting mechanism.</param>
  33478. </member>
  33479. <member name="M:MailKit.IMailFolder.GetHeadersAsync(System.Int32,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33480. <summary>
  33481. Asynchronously get the specified body part headers.
  33482. </summary>
  33483. <remarks>
  33484. Asynchronously gets the specified body part headers.
  33485. </remarks>
  33486. <returns>The body part headers.</returns>
  33487. <param name="index">The index of the message.</param>
  33488. <param name="part">The body part.</param>
  33489. <param name="cancellationToken">The cancellation token.</param>
  33490. <param name="progress">The progress reporting mechanism.</param>
  33491. </member>
  33492. <member name="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33493. <summary>
  33494. Get the specified message.
  33495. </summary>
  33496. <remarks>
  33497. Gets the specified message.
  33498. </remarks>
  33499. <returns>The message.</returns>
  33500. <param name="uid">The UID of the message.</param>
  33501. <param name="cancellationToken">The cancellation token.</param>
  33502. <param name="progress">The progress reporting mechanism.</param>
  33503. </member>
  33504. <member name="M:MailKit.IMailFolder.GetMessageAsync(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33505. <summary>
  33506. Asynchronously get the specified message.
  33507. </summary>
  33508. <remarks>
  33509. Asynchronously gets the specified message.
  33510. </remarks>
  33511. <returns>The message.</returns>
  33512. <param name="uid">The UID of the message.</param>
  33513. <param name="cancellationToken">The cancellation token.</param>
  33514. <param name="progress">The progress reporting mechanism.</param>
  33515. </member>
  33516. <member name="M:MailKit.IMailFolder.GetMessage(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33517. <summary>
  33518. Get the specified message.
  33519. </summary>
  33520. <remarks>
  33521. Gets the specified message.
  33522. </remarks>
  33523. <returns>The message.</returns>
  33524. <param name="index">The index of the message.</param>
  33525. <param name="cancellationToken">The cancellation token.</param>
  33526. <param name="progress">The progress reporting mechanism.</param>
  33527. </member>
  33528. <member name="M:MailKit.IMailFolder.GetMessageAsync(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33529. <summary>
  33530. Asynchronously get the specified message.
  33531. </summary>
  33532. <remarks>
  33533. Asynchronously gets the specified message.
  33534. </remarks>
  33535. <returns>The message.</returns>
  33536. <param name="index">The index of the message.</param>
  33537. <param name="cancellationToken">The cancellation token.</param>
  33538. <param name="progress">The progress reporting mechanism.</param>
  33539. </member>
  33540. <member name="M:MailKit.IMailFolder.GetBodyPart(MailKit.UniqueId,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33541. <summary>
  33542. Get the specified body part.
  33543. </summary>
  33544. <remarks>
  33545. Gets the specified body part.
  33546. </remarks>
  33547. <example>
  33548. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  33549. </example>
  33550. <returns>The body part.</returns>
  33551. <param name="uid">The UID of the message.</param>
  33552. <param name="part">The body part.</param>
  33553. <param name="cancellationToken">The cancellation token.</param>
  33554. <param name="progress">The progress reporting mechanism.</param>
  33555. </member>
  33556. <member name="M:MailKit.IMailFolder.GetBodyPartAsync(MailKit.UniqueId,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33557. <summary>
  33558. Asynchronously get the specified body part.
  33559. </summary>
  33560. <remarks>
  33561. Asynchronously gets the specified body part.
  33562. </remarks>
  33563. <returns>The body part.</returns>
  33564. <param name="uid">The UID of the message.</param>
  33565. <param name="part">The body part.</param>
  33566. <param name="cancellationToken">The cancellation token.</param>
  33567. <param name="progress">The progress reporting mechanism.</param>
  33568. </member>
  33569. <member name="M:MailKit.IMailFolder.GetBodyPart(System.Int32,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33570. <summary>
  33571. Get the specified body part.
  33572. </summary>
  33573. <remarks>
  33574. Gets the specified body part.
  33575. </remarks>
  33576. <returns>The body part.</returns>
  33577. <param name="index">The index of the message.</param>
  33578. <param name="part">The body part.</param>
  33579. <param name="cancellationToken">The cancellation token.</param>
  33580. <param name="progress">The progress reporting mechanism.</param>
  33581. </member>
  33582. <member name="M:MailKit.IMailFolder.GetBodyPartAsync(System.Int32,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33583. <summary>
  33584. Asynchronously get the specified body part.
  33585. </summary>
  33586. <remarks>
  33587. Asynchronously gets the specified body part.
  33588. </remarks>
  33589. <returns>The body part.</returns>
  33590. <param name="index">The index of the message.</param>
  33591. <param name="part">The body part.</param>
  33592. <param name="cancellationToken">The cancellation token.</param>
  33593. <param name="progress">The progress reporting mechanism.</param>
  33594. </member>
  33595. <member name="M:MailKit.IMailFolder.GetStream(MailKit.UniqueId,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33596. <summary>
  33597. Get a substream of the specified message.
  33598. </summary>
  33599. <remarks>
  33600. Gets a substream of the message. If the starting offset is beyond
  33601. the end of the message, an empty stream is returned. If the number of
  33602. bytes desired extends beyond the end of the message, a truncated stream
  33603. will be returned.
  33604. </remarks>
  33605. <returns>The stream.</returns>
  33606. <param name="uid">The UID of the message.</param>
  33607. <param name="offset">The starting offset of the first desired byte.</param>
  33608. <param name="count">The number of bytes desired.</param>
  33609. <param name="cancellationToken">The cancellation token.</param>
  33610. <param name="progress">The progress reporting mechanism.</param>
  33611. </member>
  33612. <member name="M:MailKit.IMailFolder.GetStreamAsync(MailKit.UniqueId,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33613. <summary>
  33614. Asynchronously get a substream of the specified message.
  33615. </summary>
  33616. <remarks>
  33617. Asynchronously gets a substream of the message. If the starting offset is beyond
  33618. the end of the message, an empty stream is returned. If the number of
  33619. bytes desired extends beyond the end of the message, a truncated stream
  33620. will be returned.
  33621. </remarks>
  33622. <returns>The stream.</returns>
  33623. <param name="uid">The UID of the message.</param>
  33624. <param name="offset">The starting offset of the first desired byte.</param>
  33625. <param name="count">The number of bytes desired.</param>
  33626. <param name="cancellationToken">The cancellation token.</param>
  33627. <param name="progress">The progress reporting mechanism.</param>
  33628. </member>
  33629. <member name="M:MailKit.IMailFolder.GetStream(System.Int32,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33630. <summary>
  33631. Get a substream of the specified message.
  33632. </summary>
  33633. <remarks>
  33634. Gets a substream of the message. If the starting offset is beyond
  33635. the end of the message, an empty stream is returned. If the number of
  33636. bytes desired extends beyond the end of the message, a truncated stream
  33637. will be returned.
  33638. </remarks>
  33639. <returns>The stream.</returns>
  33640. <param name="index">The index of the message.</param>
  33641. <param name="offset">The starting offset of the first desired byte.</param>
  33642. <param name="count">The number of bytes desired.</param>
  33643. <param name="cancellationToken">The cancellation token.</param>
  33644. <param name="progress">The progress reporting mechanism.</param>
  33645. </member>
  33646. <member name="M:MailKit.IMailFolder.GetStreamAsync(System.Int32,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33647. <summary>
  33648. Asynchronously get a substream of the specified message.
  33649. </summary>
  33650. <remarks>
  33651. Asynchronously gets a substream of the message. If the starting offset is beyond
  33652. the end of the message, an empty stream is returned. If the number of
  33653. bytes desired extends beyond the end of the message, a truncated stream
  33654. will be returned.
  33655. </remarks>
  33656. <returns>The stream.</returns>
  33657. <param name="index">The index of the message.</param>
  33658. <param name="offset">The starting offset of the first desired byte.</param>
  33659. <param name="count">The number of bytes desired.</param>
  33660. <param name="cancellationToken">The cancellation token.</param>
  33661. <param name="progress">The progress reporting mechanism.</param>
  33662. </member>
  33663. <member name="M:MailKit.IMailFolder.GetStream(MailKit.UniqueId,MailKit.BodyPart,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33664. <summary>
  33665. Get a substream of the specified body part.
  33666. </summary>
  33667. <remarks>
  33668. Gets a substream of the body part. If the starting offset is beyond
  33669. the end of the body part, an empty stream is returned. If the number of
  33670. bytes desired extends beyond the end of the body part, a truncated stream
  33671. will be returned.
  33672. </remarks>
  33673. <returns>The stream.</returns>
  33674. <param name="uid">The UID of the message.</param>
  33675. <param name="part">The desired body part.</param>
  33676. <param name="offset">The starting offset of the first desired byte.</param>
  33677. <param name="count">The number of bytes desired.</param>
  33678. <param name="cancellationToken">The cancellation token.</param>
  33679. <param name="progress">The progress reporting mechanism.</param>
  33680. </member>
  33681. <member name="M:MailKit.IMailFolder.GetStreamAsync(MailKit.UniqueId,MailKit.BodyPart,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33682. <summary>
  33683. Asynchronously get a substream of the specified body part.
  33684. </summary>
  33685. <remarks>
  33686. Asynchronously gets a substream of the body part. If the starting offset is beyond
  33687. the end of the body part, an empty stream is returned. If the number of
  33688. bytes desired extends beyond the end of the body part, a truncated stream
  33689. will be returned.
  33690. </remarks>
  33691. <returns>The stream.</returns>
  33692. <param name="uid">The UID of the message.</param>
  33693. <param name="part">The desired body part.</param>
  33694. <param name="offset">The starting offset of the first desired byte.</param>
  33695. <param name="count">The number of bytes desired.</param>
  33696. <param name="cancellationToken">The cancellation token.</param>
  33697. <param name="progress">The progress reporting mechanism.</param>
  33698. </member>
  33699. <member name="M:MailKit.IMailFolder.GetStream(System.Int32,MailKit.BodyPart,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33700. <summary>
  33701. Get a substream of the specified body part.
  33702. </summary>
  33703. <remarks>
  33704. Gets a substream of the body part. If the starting offset is beyond
  33705. the end of the body part, an empty stream is returned. If the number of
  33706. bytes desired extends beyond the end of the body part, a truncated stream
  33707. will be returned.
  33708. </remarks>
  33709. <returns>The stream.</returns>
  33710. <param name="index">The index of the message.</param>
  33711. <param name="part">The desired body part.</param>
  33712. <param name="offset">The starting offset of the first desired byte.</param>
  33713. <param name="count">The number of bytes desired.</param>
  33714. <param name="cancellationToken">The cancellation token.</param>
  33715. <param name="progress">The progress reporting mechanism.</param>
  33716. </member>
  33717. <member name="M:MailKit.IMailFolder.GetStreamAsync(System.Int32,MailKit.BodyPart,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33718. <summary>
  33719. Asynchronously get a substream of the specified body part.
  33720. </summary>
  33721. <remarks>
  33722. Asynchronously gets a substream of the body part. If the starting offset is beyond
  33723. the end of the body part, an empty stream is returned. If the number of
  33724. bytes desired extends beyond the end of the body part, a truncated stream
  33725. will be returned.
  33726. </remarks>
  33727. <returns>The stream.</returns>
  33728. <param name="index">The index of the message.</param>
  33729. <param name="part">The desired body part.</param>
  33730. <param name="offset">The starting offset of the first desired byte.</param>
  33731. <param name="count">The number of bytes desired.</param>
  33732. <param name="cancellationToken">The cancellation token.</param>
  33733. <param name="progress">The progress reporting mechanism.</param>
  33734. </member>
  33735. <member name="M:MailKit.IMailFolder.GetStream(MailKit.UniqueId,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33736. <summary>
  33737. Get a substream of the specified message.
  33738. </summary>
  33739. <remarks>
  33740. <para>Gets a substream of the specified message.</para>
  33741. <para>For more information about how to construct the <paramref name="section"/>,
  33742. see Section 6.4.5 of RFC3501.</para>
  33743. </remarks>
  33744. <returns>The stream.</returns>
  33745. <param name="uid">The UID of the message.</param>
  33746. <param name="section">The desired section of the message.</param>
  33747. <param name="cancellationToken">The cancellation token.</param>
  33748. <param name="progress">The progress reporting mechanism.</param>
  33749. </member>
  33750. <member name="M:MailKit.IMailFolder.GetStreamAsync(MailKit.UniqueId,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33751. <summary>
  33752. Asynchronously get a substream of the specified message.
  33753. </summary>
  33754. <remarks>
  33755. <para>Asynchronously gets a substream of the specified message.</para>
  33756. <para>For more information about how to construct the <paramref name="section"/>,
  33757. see Section 6.4.5 of RFC3501.</para>
  33758. </remarks>
  33759. <returns>The stream.</returns>
  33760. <param name="uid">The UID of the message.</param>
  33761. <param name="section">The desired section of the message.</param>
  33762. <param name="cancellationToken">The cancellation token.</param>
  33763. <param name="progress">The progress reporting mechanism.</param>
  33764. </member>
  33765. <member name="M:MailKit.IMailFolder.GetStream(MailKit.UniqueId,System.String,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33766. <summary>
  33767. Get a substream of the specified message.
  33768. </summary>
  33769. <remarks>
  33770. <para>Gets a substream of the specified message. If the starting offset is beyond
  33771. the end of the specified section of the message, an empty stream is returned. If
  33772. the number of bytes desired extends beyond the end of the section, a truncated
  33773. stream will be returned.</para>
  33774. <para>For more information about how to construct the <paramref name="section"/>,
  33775. see Section 6.4.5 of RFC3501.</para>
  33776. </remarks>
  33777. <returns>The stream.</returns>
  33778. <param name="uid">The UID of the message.</param>
  33779. <param name="section">The desired section of the message.</param>
  33780. <param name="offset">The starting offset of the first desired byte.</param>
  33781. <param name="count">The number of bytes desired.</param>
  33782. <param name="cancellationToken">The cancellation token.</param>
  33783. <param name="progress">The progress reporting mechanism.</param>
  33784. </member>
  33785. <member name="M:MailKit.IMailFolder.GetStreamAsync(MailKit.UniqueId,System.String,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33786. <summary>
  33787. Asynchronously get a substream of the specified message.
  33788. </summary>
  33789. <remarks>
  33790. <para>Asynchronously gets a substream of the specified message. If the starting
  33791. offset is beyond the end of the specified section of the message, an empty stream
  33792. is returned. If the number of bytes desired extends beyond the end of the section,
  33793. a truncated stream will be returned.</para>
  33794. <para>For more information about how to construct the <paramref name="section"/>,
  33795. see Section 6.4.5 of RFC3501.</para>
  33796. </remarks>
  33797. <returns>The stream.</returns>
  33798. <param name="uid">The UID of the message.</param>
  33799. <param name="section">The desired section of the message.</param>
  33800. <param name="offset">The starting offset of the first desired byte.</param>
  33801. <param name="count">The number of bytes desired.</param>
  33802. <param name="cancellationToken">The cancellation token.</param>
  33803. <param name="progress">The progress reporting mechanism.</param>
  33804. </member>
  33805. <member name="M:MailKit.IMailFolder.GetStream(System.Int32,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33806. <summary>
  33807. Get a substream of the specified message.
  33808. </summary>
  33809. <remarks>
  33810. <para>Gets a substream of the specified message.</para>
  33811. <para>For more information about how to construct the <paramref name="section"/>,
  33812. see Section 6.4.5 of RFC3501.</para>
  33813. </remarks>
  33814. <returns>The stream.</returns>
  33815. <param name="index">The index of the message.</param>
  33816. <param name="section">The desired section of the message.</param>
  33817. <param name="cancellationToken">The cancellation token.</param>
  33818. <param name="progress">The progress reporting mechanism.</param>
  33819. </member>
  33820. <member name="M:MailKit.IMailFolder.GetStreamAsync(System.Int32,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33821. <summary>
  33822. Asynchronously get a substream of the specified message.
  33823. </summary>
  33824. <remarks>
  33825. <para>Asynchronously gets a substream of the specified message.</para>
  33826. <para>For more information about how to construct the <paramref name="section"/>,
  33827. see Section 6.4.5 of RFC3501.</para>
  33828. </remarks>
  33829. <returns>The stream.</returns>
  33830. <param name="index">The index of the message.</param>
  33831. <param name="section">The desired section of the message.</param>
  33832. <param name="cancellationToken">The cancellation token.</param>
  33833. <param name="progress">The progress reporting mechanism.</param>
  33834. </member>
  33835. <member name="M:MailKit.IMailFolder.GetStream(System.Int32,System.String,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33836. <summary>
  33837. Get a substream of the specified message.
  33838. </summary>
  33839. <remarks>
  33840. <para>Gets a substream of the specified message. If the starting offset is beyond
  33841. the end of the specified section of the message, an empty stream is returned. If
  33842. the number of bytes desired extends beyond the end of the section, a truncated
  33843. stream will be returned.</para>
  33844. <para>For more information about how to construct the <paramref name="section"/>,
  33845. see Section 6.4.5 of RFC3501.</para>
  33846. </remarks>
  33847. <returns>The stream.</returns>
  33848. <param name="index">The index of the message.</param>
  33849. <param name="section">The desired section of the message.</param>
  33850. <param name="offset">The starting offset of the first desired byte.</param>
  33851. <param name="count">The number of bytes desired.</param>
  33852. <param name="cancellationToken">The cancellation token.</param>
  33853. <param name="progress">The progress reporting mechanism.</param>
  33854. </member>
  33855. <member name="M:MailKit.IMailFolder.GetStreamAsync(System.Int32,System.String,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  33856. <summary>
  33857. Asynchronously get a substream of the specified message.
  33858. </summary>
  33859. <remarks>
  33860. <para>Asynchronously gets a substream of the specified message. If the starting
  33861. offset is beyond the end of the specified section of the message, an empty stream
  33862. is returned. If the number of bytes desired extends beyond the end of the section,
  33863. a truncated stream will be returned.</para>
  33864. <para>For more information about how to construct the <paramref name="section"/>,
  33865. see Section 6.4.5 of RFC3501.</para>
  33866. </remarks>
  33867. <returns>The stream.</returns>
  33868. <param name="index">The index of the message.</param>
  33869. <param name="section">The desired section of the message.</param>
  33870. <param name="offset">The starting offset of the first desired byte.</param>
  33871. <param name="count">The number of bytes desired.</param>
  33872. <param name="cancellationToken">The cancellation token.</param>
  33873. <param name="progress">The progress reporting mechanism.</param>
  33874. </member>
  33875. <member name="M:MailKit.IMailFolder.AddFlags(MailKit.UniqueId,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  33876. <summary>
  33877. Add a set of flags to the specified message.
  33878. </summary>
  33879. <remarks>
  33880. Adds a set of flags to the specified message.
  33881. </remarks>
  33882. <param name="uid">The UID of the message.</param>
  33883. <param name="flags">The message flags to add.</param>
  33884. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  33885. <param name="cancellationToken">The cancellation token.</param>
  33886. </member>
  33887. <member name="M:MailKit.IMailFolder.AddFlagsAsync(MailKit.UniqueId,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  33888. <summary>
  33889. Asynchronously add a set of flags to the specified message.
  33890. </summary>
  33891. <remarks>
  33892. Asynchronously adds a set of flags to the specified message.
  33893. </remarks>
  33894. <returns>An asynchronous task context.</returns>
  33895. <param name="uid">The UIDs of the message.</param>
  33896. <param name="flags">The message flags to add.</param>
  33897. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  33898. <param name="cancellationToken">The cancellation token.</param>
  33899. </member>
  33900. <member name="M:MailKit.IMailFolder.AddFlags(MailKit.UniqueId,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  33901. <summary>
  33902. Add a set of flags to the specified message.
  33903. </summary>
  33904. <remarks>
  33905. Adds a set of flags to the specified message.
  33906. </remarks>
  33907. <param name="uid">The UID of the message.</param>
  33908. <param name="flags">The message flags to add.</param>
  33909. <param name="keywords">A set of user-defined flags to add.</param>
  33910. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  33911. <param name="cancellationToken">The cancellation token.</param>
  33912. </member>
  33913. <member name="M:MailKit.IMailFolder.AddFlagsAsync(MailKit.UniqueId,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  33914. <summary>
  33915. Asynchronously add a set of flags to the specified message.
  33916. </summary>
  33917. <remarks>
  33918. Asynchronously adds a set of flags to the specified message.
  33919. </remarks>
  33920. <returns>An asynchronous task context.</returns>
  33921. <param name="uid">The UIDs of the message.</param>
  33922. <param name="flags">The message flags to add.</param>
  33923. <param name="keywords">A set of user-defined flags to add.</param>
  33924. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  33925. <param name="cancellationToken">The cancellation token.</param>
  33926. </member>
  33927. <member name="M:MailKit.IMailFolder.AddFlags(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  33928. <summary>
  33929. Add a set of flags to the specified messages.
  33930. </summary>
  33931. <remarks>
  33932. Adds a set of flags to the specified messages.
  33933. </remarks>
  33934. <param name="uids">The UIDs of the messages.</param>
  33935. <param name="flags">The message flags to add.</param>
  33936. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  33937. <param name="cancellationToken">The cancellation token.</param>
  33938. </member>
  33939. <member name="M:MailKit.IMailFolder.AddFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  33940. <summary>
  33941. Asynchronously add a set of flags to the specified messages.
  33942. </summary>
  33943. <remarks>
  33944. Asynchronously adds a set of flags to the specified messages.
  33945. </remarks>
  33946. <returns>An asynchronous task context.</returns>
  33947. <param name="uids">The UIDs of the messages.</param>
  33948. <param name="flags">The message flags to add.</param>
  33949. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  33950. <param name="cancellationToken">The cancellation token.</param>
  33951. </member>
  33952. <member name="M:MailKit.IMailFolder.AddFlags(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  33953. <summary>
  33954. Add a set of flags to the specified messages.
  33955. </summary>
  33956. <remarks>
  33957. Adds a set of flags to the specified messages.
  33958. </remarks>
  33959. <param name="uids">The UIDs of the messages.</param>
  33960. <param name="flags">The message flags to add.</param>
  33961. <param name="keywords">A set of user-defined flags to add.</param>
  33962. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  33963. <param name="cancellationToken">The cancellation token.</param>
  33964. </member>
  33965. <member name="M:MailKit.IMailFolder.AddFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  33966. <summary>
  33967. Asynchronously add a set of flags to the specified messages.
  33968. </summary>
  33969. <remarks>
  33970. Asynchronously adds a set of flags to the specified messages.
  33971. </remarks>
  33972. <returns>An asynchronous task context.</returns>
  33973. <param name="uids">The UIDs of the messages.</param>
  33974. <param name="flags">The message flags to add.</param>
  33975. <param name="keywords">A set of user-defined flags to add.</param>
  33976. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  33977. <param name="cancellationToken">The cancellation token.</param>
  33978. </member>
  33979. <member name="M:MailKit.IMailFolder.RemoveFlags(MailKit.UniqueId,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  33980. <summary>
  33981. Remove a set of flags from the specified message.
  33982. </summary>
  33983. <remarks>
  33984. Removes a set of flags from the specified message.
  33985. </remarks>
  33986. <param name="uid">The UID of the message.</param>
  33987. <param name="flags">The message flags to remove.</param>
  33988. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  33989. <param name="cancellationToken">The cancellation token.</param>
  33990. </member>
  33991. <member name="M:MailKit.IMailFolder.RemoveFlagsAsync(MailKit.UniqueId,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  33992. <summary>
  33993. Asynchronously remove a set of flags from the specified message.
  33994. </summary>
  33995. <remarks>
  33996. Asynchronously removes a set of flags from the specified message.
  33997. </remarks>
  33998. <returns>An asynchronous task context.</returns>
  33999. <param name="uid">The UID of the message.</param>
  34000. <param name="flags">The message flags to remove.</param>
  34001. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34002. <param name="cancellationToken">The cancellation token.</param>
  34003. </member>
  34004. <member name="M:MailKit.IMailFolder.RemoveFlags(MailKit.UniqueId,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34005. <summary>
  34006. Remove a set of flags from the specified message.
  34007. </summary>
  34008. <remarks>
  34009. Removes a set of flags from the specified message.
  34010. </remarks>
  34011. <param name="uid">The UID of the message.</param>
  34012. <param name="flags">The message flags to remove.</param>
  34013. <param name="keywords">A set of user-defined flags to remove.</param>
  34014. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34015. <param name="cancellationToken">The cancellation token.</param>
  34016. </member>
  34017. <member name="M:MailKit.IMailFolder.RemoveFlagsAsync(MailKit.UniqueId,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34018. <summary>
  34019. Asynchronously remove a set of flags from the specified message.
  34020. </summary>
  34021. <remarks>
  34022. Asynchronously removes a set of flags from the specified message.
  34023. </remarks>
  34024. <returns>An asynchronous task context.</returns>
  34025. <param name="uid">The UID of the message.</param>
  34026. <param name="flags">The message flags to remove.</param>
  34027. <param name="keywords">A set of user-defined flags to remove.</param>
  34028. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34029. <param name="cancellationToken">The cancellation token.</param>
  34030. </member>
  34031. <member name="M:MailKit.IMailFolder.RemoveFlags(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34032. <summary>
  34033. Remove a set of flags from the specified messages.
  34034. </summary>
  34035. <remarks>
  34036. Removes a set of flags from the specified messages.
  34037. </remarks>
  34038. <param name="uids">The UIDs of the messages.</param>
  34039. <param name="flags">The message flags to remove.</param>
  34040. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34041. <param name="cancellationToken">The cancellation token.</param>
  34042. </member>
  34043. <member name="M:MailKit.IMailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34044. <summary>
  34045. Asynchronously remove a set of flags from the specified messages.
  34046. </summary>
  34047. <remarks>
  34048. Asynchronously removes a set of flags from the specified messages.
  34049. </remarks>
  34050. <returns>An asynchronous task context.</returns>
  34051. <param name="uids">The UIDs of the messages.</param>
  34052. <param name="flags">The message flags to remove.</param>
  34053. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34054. <param name="cancellationToken">The cancellation token.</param>
  34055. </member>
  34056. <member name="M:MailKit.IMailFolder.RemoveFlags(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34057. <summary>
  34058. Remove a set of flags from the specified messages.
  34059. </summary>
  34060. <remarks>
  34061. Removes a set of flags from the specified messages.
  34062. </remarks>
  34063. <param name="uids">The UIDs of the messages.</param>
  34064. <param name="flags">The message flags to remove.</param>
  34065. <param name="keywords">A set of user-defined flags to remove.</param>
  34066. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34067. <param name="cancellationToken">The cancellation token.</param>
  34068. </member>
  34069. <member name="M:MailKit.IMailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34070. <summary>
  34071. Asynchronously remove a set of flags from the specified messages.
  34072. </summary>
  34073. <remarks>
  34074. Asynchronously removes a set of flags from the specified messages.
  34075. </remarks>
  34076. <returns>An asynchronous task context.</returns>
  34077. <param name="uids">The UIDs of the messages.</param>
  34078. <param name="flags">The message flags to remove.</param>
  34079. <param name="keywords">A set of user-defined flags to remove.</param>
  34080. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34081. <param name="cancellationToken">The cancellation token.</param>
  34082. </member>
  34083. <member name="M:MailKit.IMailFolder.SetFlags(MailKit.UniqueId,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34084. <summary>
  34085. Set the flags of the specified message.
  34086. </summary>
  34087. <remarks>
  34088. Sets the flags of the specified message.
  34089. </remarks>
  34090. <param name="uid">The UID of the message.</param>
  34091. <param name="flags">The message flags to set.</param>
  34092. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34093. <param name="cancellationToken">The cancellation token.</param>
  34094. </member>
  34095. <member name="M:MailKit.IMailFolder.SetFlagsAsync(MailKit.UniqueId,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34096. <summary>
  34097. Asynchronously set the flags of the specified message.
  34098. </summary>
  34099. <remarks>
  34100. Asynchronously sets the flags of the specified message.
  34101. </remarks>
  34102. <returns>An asynchronous task context.</returns>
  34103. <param name="uid">The UID of the message.</param>
  34104. <param name="flags">The message flags to set.</param>
  34105. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34106. <param name="cancellationToken">The cancellation token.</param>
  34107. </member>
  34108. <member name="M:MailKit.IMailFolder.SetFlags(MailKit.UniqueId,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34109. <summary>
  34110. Set the flags of the specified message.
  34111. </summary>
  34112. <remarks>
  34113. Sets the flags of the specified message.
  34114. </remarks>
  34115. <param name="uid">The UID of the message.</param>
  34116. <param name="flags">The message flags to set.</param>
  34117. <param name="keywords">A set of user-defined flags to set.</param>
  34118. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34119. <param name="cancellationToken">The cancellation token.</param>
  34120. </member>
  34121. <member name="M:MailKit.IMailFolder.SetFlagsAsync(MailKit.UniqueId,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34122. <summary>
  34123. Asynchronously set the flags of the specified message.
  34124. </summary>
  34125. <remarks>
  34126. Asynchronously sets the flags of the specified message.
  34127. </remarks>
  34128. <returns>An asynchronous task context.</returns>
  34129. <param name="uid">The UID of the message.</param>
  34130. <param name="flags">The message flags to set.</param>
  34131. <param name="keywords">A set of user-defined flags to set.</param>
  34132. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34133. <param name="cancellationToken">The cancellation token.</param>
  34134. </member>
  34135. <member name="M:MailKit.IMailFolder.SetFlags(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34136. <summary>
  34137. Set the flags of the specified messages.
  34138. </summary>
  34139. <remarks>
  34140. Sets the flags of the specified messages.
  34141. </remarks>
  34142. <param name="uids">The UIDs of the messages.</param>
  34143. <param name="flags">The message flags to set.</param>
  34144. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34145. <param name="cancellationToken">The cancellation token.</param>
  34146. </member>
  34147. <member name="M:MailKit.IMailFolder.SetFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34148. <summary>
  34149. Asynchronously set the flags of the specified messages.
  34150. </summary>
  34151. <remarks>
  34152. Asynchronously sets the flags of the specified messages.
  34153. </remarks>
  34154. <returns>An asynchronous task context.</returns>
  34155. <param name="uids">The UIDs of the messages.</param>
  34156. <param name="flags">The message flags to set.</param>
  34157. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34158. <param name="cancellationToken">The cancellation token.</param>
  34159. </member>
  34160. <member name="M:MailKit.IMailFolder.SetFlags(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34161. <summary>
  34162. Set the flags of the specified messages.
  34163. </summary>
  34164. <remarks>
  34165. Sets the flags of the specified messages.
  34166. </remarks>
  34167. <param name="uids">The UIDs of the messages.</param>
  34168. <param name="flags">The message flags to set.</param>
  34169. <param name="keywords">A set of user-defined flags to set.</param>
  34170. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34171. <param name="cancellationToken">The cancellation token.</param>
  34172. </member>
  34173. <member name="M:MailKit.IMailFolder.SetFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34174. <summary>
  34175. Asynchronously set the flags of the specified messages.
  34176. </summary>
  34177. <remarks>
  34178. Asynchronously sets the flags of the specified messages.
  34179. </remarks>
  34180. <returns>An asynchronous task context.</returns>
  34181. <param name="uids">The UIDs of the messages.</param>
  34182. <param name="flags">The message flags to set.</param>
  34183. <param name="keywords">A set of user-defined flags to set.</param>
  34184. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34185. <param name="cancellationToken">The cancellation token.</param>
  34186. </member>
  34187. <member name="M:MailKit.IMailFolder.AddFlags(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34188. <summary>
  34189. Add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34190. </summary>
  34191. <remarks>
  34192. Adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34193. </remarks>
  34194. <returns>The unique IDs of the messages that were not updated.</returns>
  34195. <param name="uids">The UIDs of the messages.</param>
  34196. <param name="modseq">The mod-sequence value.</param>
  34197. <param name="flags">The message flags to add.</param>
  34198. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34199. <param name="cancellationToken">The cancellation token.</param>
  34200. </member>
  34201. <member name="M:MailKit.IMailFolder.AddFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34202. <summary>
  34203. Asynchronously add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34204. </summary>
  34205. <remarks>
  34206. Asynchronously adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34207. </remarks>
  34208. <returns>The unique IDs of the messages that were not updated.</returns>
  34209. <param name="uids">The UIDs of the messages.</param>
  34210. <param name="modseq">The mod-sequence value.</param>
  34211. <param name="flags">The message flags to add.</param>
  34212. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34213. <param name="cancellationToken">The cancellation token.</param>
  34214. </member>
  34215. <member name="M:MailKit.IMailFolder.AddFlags(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34216. <summary>
  34217. Add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34218. </summary>
  34219. <remarks>
  34220. Adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34221. </remarks>
  34222. <returns>The unique IDs of the messages that were not updated.</returns>
  34223. <param name="uids">The UIDs of the messages.</param>
  34224. <param name="modseq">The mod-sequence value.</param>
  34225. <param name="flags">The message flags to add.</param>
  34226. <param name="keywords">A set of user-defined flags to set.</param>
  34227. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34228. <param name="cancellationToken">The cancellation token.</param>
  34229. </member>
  34230. <member name="M:MailKit.IMailFolder.AddFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34231. <summary>
  34232. Asynchronously add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34233. </summary>
  34234. <remarks>
  34235. Asynchronously adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34236. </remarks>
  34237. <returns>The unique IDs of the messages that were not updated.</returns>
  34238. <param name="uids">The UIDs of the messages.</param>
  34239. <param name="modseq">The mod-sequence value.</param>
  34240. <param name="flags">The message flags to add.</param>
  34241. <param name="keywords">A set of user-defined flags to set.</param>
  34242. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34243. <param name="cancellationToken">The cancellation token.</param>
  34244. </member>
  34245. <member name="M:MailKit.IMailFolder.RemoveFlags(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34246. <summary>
  34247. Remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34248. </summary>
  34249. <remarks>
  34250. Removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34251. </remarks>
  34252. <returns>The unique IDs of the messages that were not updated.</returns>
  34253. <param name="uids">The UIDs of the messages.</param>
  34254. <param name="modseq">The mod-sequence value.</param>
  34255. <param name="flags">The message flags to remove.</param>
  34256. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34257. <param name="cancellationToken">The cancellation token.</param>
  34258. </member>
  34259. <member name="M:MailKit.IMailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34260. <summary>
  34261. Asynchronously remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34262. </summary>
  34263. <remarks>
  34264. Asynchronously removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34265. </remarks>
  34266. <returns>The unique IDs of the messages that were not updated.</returns>
  34267. <param name="uids">The UIDs of the messages.</param>
  34268. <param name="modseq">The mod-sequence value.</param>
  34269. <param name="flags">The message flags to remove.</param>
  34270. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34271. <param name="cancellationToken">The cancellation token.</param>
  34272. </member>
  34273. <member name="M:MailKit.IMailFolder.RemoveFlags(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34274. <summary>
  34275. Remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34276. </summary>
  34277. <remarks>
  34278. Removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34279. </remarks>
  34280. <returns>The unique IDs of the messages that were not updated.</returns>
  34281. <param name="uids">The UIDs of the messages.</param>
  34282. <param name="modseq">The mod-sequence value.</param>
  34283. <param name="flags">The message flags to remove.</param>
  34284. <param name="keywords">A set of user-defined flags to remove.</param>
  34285. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34286. <param name="cancellationToken">The cancellation token.</param>
  34287. </member>
  34288. <member name="M:MailKit.IMailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34289. <summary>
  34290. Asynchronously remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34291. </summary>
  34292. <remarks>
  34293. Asynchronously removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34294. </remarks>
  34295. <returns>The unique IDs of the messages that were not updated.</returns>
  34296. <param name="uids">The UIDs of the messages.</param>
  34297. <param name="modseq">The mod-sequence value.</param>
  34298. <param name="flags">The message flags to remove.</param>
  34299. <param name="keywords">A set of user-defined flags to remove.</param>
  34300. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34301. <param name="cancellationToken">The cancellation token.</param>
  34302. </member>
  34303. <member name="M:MailKit.IMailFolder.SetFlags(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34304. <summary>
  34305. Set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34306. </summary>
  34307. <remarks>
  34308. Sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34309. </remarks>
  34310. <returns>The unique IDs of the messages that were not updated.</returns>
  34311. <param name="uids">The UIDs of the messages.</param>
  34312. <param name="modseq">The mod-sequence value.</param>
  34313. <param name="flags">The message flags to set.</param>
  34314. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34315. <param name="cancellationToken">The cancellation token.</param>
  34316. </member>
  34317. <member name="M:MailKit.IMailFolder.SetFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34318. <summary>
  34319. Asynchronously set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34320. </summary>
  34321. <remarks>
  34322. Asynchronously sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34323. </remarks>
  34324. <returns>The unique IDs of the messages that were not updated.</returns>
  34325. <param name="uids">The UIDs of the messages.</param>
  34326. <param name="modseq">The mod-sequence value.</param>
  34327. <param name="flags">The message flags to set.</param>
  34328. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34329. <param name="cancellationToken">The cancellation token.</param>
  34330. </member>
  34331. <member name="M:MailKit.IMailFolder.SetFlags(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34332. <summary>
  34333. Set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34334. </summary>
  34335. <remarks>
  34336. Sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34337. </remarks>
  34338. <returns>The unique IDs of the messages that were not updated.</returns>
  34339. <param name="uids">The UIDs of the messages.</param>
  34340. <param name="modseq">The mod-sequence value.</param>
  34341. <param name="flags">The message flags to set.</param>
  34342. <param name="keywords">A set of user-defined flags to set.</param>
  34343. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34344. <param name="cancellationToken">The cancellation token.</param>
  34345. </member>
  34346. <member name="M:MailKit.IMailFolder.SetFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34347. <summary>
  34348. Asynchronously set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34349. </summary>
  34350. <remarks>
  34351. Asynchronously sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34352. </remarks>
  34353. <returns>The unique IDs of the messages that were not updated.</returns>
  34354. <param name="uids">The UIDs of the messages.</param>
  34355. <param name="modseq">The mod-sequence value.</param>
  34356. <param name="flags">The message flags to set.</param>
  34357. <param name="keywords">A set of user-defined flags to set.</param>
  34358. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34359. <param name="cancellationToken">The cancellation token.</param>
  34360. </member>
  34361. <member name="M:MailKit.IMailFolder.AddFlags(System.Int32,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34362. <summary>
  34363. Add a set of flags to the specified message.
  34364. </summary>
  34365. <remarks>
  34366. Adds a set of flags to the specified message.
  34367. </remarks>
  34368. <param name="index">The index of the message.</param>
  34369. <param name="flags">The message flags to add.</param>
  34370. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34371. <param name="cancellationToken">The cancellation token.</param>
  34372. </member>
  34373. <member name="M:MailKit.IMailFolder.AddFlagsAsync(System.Int32,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34374. <summary>
  34375. Asynchronously add a set of flags to the specified message.
  34376. </summary>
  34377. <remarks>
  34378. Asynchronously adds a set of flags to the specified message.
  34379. </remarks>
  34380. <returns>An asynchronous task context.</returns>
  34381. <param name="index">The index of the message.</param>
  34382. <param name="flags">The message flags to add.</param>
  34383. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34384. <param name="cancellationToken">The cancellation token.</param>
  34385. </member>
  34386. <member name="M:MailKit.IMailFolder.AddFlags(System.Int32,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34387. <summary>
  34388. Add a set of flags to the specified message.
  34389. </summary>
  34390. <remarks>
  34391. Adds a set of flags to the specified message.
  34392. </remarks>
  34393. <param name="index">The index of the message.</param>
  34394. <param name="flags">The message flags to add.</param>
  34395. <param name="keywords">A set of user-defined flags to add.</param>
  34396. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34397. <param name="cancellationToken">The cancellation token.</param>
  34398. </member>
  34399. <member name="M:MailKit.IMailFolder.AddFlagsAsync(System.Int32,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34400. <summary>
  34401. Asynchronously add a set of flags to the specified message.
  34402. </summary>
  34403. <remarks>
  34404. Asynchronously adds a set of flags to the specified message.
  34405. </remarks>
  34406. <returns>An asynchronous task context.</returns>
  34407. <param name="index">The index of the message.</param>
  34408. <param name="flags">The message flags to add.</param>
  34409. <param name="keywords">A set of user-defined flags to add.</param>
  34410. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34411. <param name="cancellationToken">The cancellation token.</param>
  34412. </member>
  34413. <member name="M:MailKit.IMailFolder.AddFlags(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34414. <summary>
  34415. Add a set of flags to the specified messages.
  34416. </summary>
  34417. <remarks>
  34418. Adds a set of flags to the specified messages.
  34419. </remarks>
  34420. <param name="indexes">The indexes of the messages.</param>
  34421. <param name="flags">The message flags to add.</param>
  34422. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34423. <param name="cancellationToken">The cancellation token.</param>
  34424. </member>
  34425. <member name="M:MailKit.IMailFolder.AddFlagsAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34426. <summary>
  34427. Asynchronously add a set of flags to the specified messages.
  34428. </summary>
  34429. <remarks>
  34430. Asynchronously adds a set of flags to the specified messages.
  34431. </remarks>
  34432. <returns>An asynchronous task context.</returns>
  34433. <param name="indexes">The indexes of the messages.</param>
  34434. <param name="flags">The message flags to add.</param>
  34435. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34436. <param name="cancellationToken">The cancellation token.</param>
  34437. </member>
  34438. <member name="M:MailKit.IMailFolder.AddFlags(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34439. <summary>
  34440. Add a set of flags to the specified messages.
  34441. </summary>
  34442. <remarks>
  34443. Adds a set of flags to the specified messages.
  34444. </remarks>
  34445. <param name="indexes">The indexes of the messages.</param>
  34446. <param name="flags">The message flags to add.</param>
  34447. <param name="keywords">A set of user-defined flags to add.</param>
  34448. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34449. <param name="cancellationToken">The cancellation token.</param>
  34450. </member>
  34451. <member name="M:MailKit.IMailFolder.AddFlagsAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34452. <summary>
  34453. Asynchronously add a set of flags to the specified messages.
  34454. </summary>
  34455. <remarks>
  34456. Asynchronously adds a set of flags to the specified messages.
  34457. </remarks>
  34458. <returns>An asynchronous task context.</returns>
  34459. <param name="indexes">The indexes of the messages.</param>
  34460. <param name="flags">The message flags to add.</param>
  34461. <param name="keywords">A set of user-defined flags to add.</param>
  34462. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34463. <param name="cancellationToken">The cancellation token.</param>
  34464. </member>
  34465. <member name="M:MailKit.IMailFolder.RemoveFlags(System.Int32,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34466. <summary>
  34467. Remove a set of flags from the specified message.
  34468. </summary>
  34469. <remarks>
  34470. Removes a set of flags from the specified message.
  34471. </remarks>
  34472. <param name="index">The index of the message.</param>
  34473. <param name="flags">The message flags to remove.</param>
  34474. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34475. <param name="cancellationToken">The cancellation token.</param>
  34476. </member>
  34477. <member name="M:MailKit.IMailFolder.RemoveFlagsAsync(System.Int32,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34478. <summary>
  34479. Asynchronously remove a set of flags from the specified message.
  34480. </summary>
  34481. <remarks>
  34482. Asynchronously removes a set of flags from the specified message.
  34483. </remarks>
  34484. <returns>An asynchronous task context.</returns>
  34485. <param name="index">The index of the message.</param>
  34486. <param name="flags">The message flags to remove.</param>
  34487. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34488. <param name="cancellationToken">The cancellation token.</param>
  34489. </member>
  34490. <member name="M:MailKit.IMailFolder.RemoveFlags(System.Int32,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34491. <summary>
  34492. Remove a set of flags from the specified message.
  34493. </summary>
  34494. <remarks>
  34495. Removes a set of flags from the specified message.
  34496. </remarks>
  34497. <param name="index">The index of the message.</param>
  34498. <param name="flags">The message flags to remove.</param>
  34499. <param name="keywords">A set of user-defined flags to remove.</param>
  34500. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34501. <param name="cancellationToken">The cancellation token.</param>
  34502. </member>
  34503. <member name="M:MailKit.IMailFolder.RemoveFlagsAsync(System.Int32,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34504. <summary>
  34505. Asynchronously remove a set of flags from the specified message.
  34506. </summary>
  34507. <remarks>
  34508. Asynchronously removes a set of flags from the specified message.
  34509. </remarks>
  34510. <returns>An asynchronous task context.</returns>
  34511. <param name="index">The index of the message.</param>
  34512. <param name="flags">The message flags to remove.</param>
  34513. <param name="keywords">A set of user-defined flags to remove.</param>
  34514. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34515. <param name="cancellationToken">The cancellation token.</param>
  34516. </member>
  34517. <member name="M:MailKit.IMailFolder.RemoveFlags(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34518. <summary>
  34519. Remove a set of flags from the specified messages.
  34520. </summary>
  34521. <remarks>
  34522. Removes a set of flags from the specified messages.
  34523. </remarks>
  34524. <param name="indexes">The indexes of the messages.</param>
  34525. <param name="flags">The message flags to remove.</param>
  34526. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34527. <param name="cancellationToken">The cancellation token.</param>
  34528. </member>
  34529. <member name="M:MailKit.IMailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34530. <summary>
  34531. Asynchronously remove a set of flags from the specified messages.
  34532. </summary>
  34533. <remarks>
  34534. Asynchronously removes a set of flags from the specified messages.
  34535. </remarks>
  34536. <returns>An asynchronous task context.</returns>
  34537. <param name="indexes">The indexes of the messages.</param>
  34538. <param name="flags">The message flags to remove.</param>
  34539. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34540. <param name="cancellationToken">The cancellation token.</param>
  34541. </member>
  34542. <member name="M:MailKit.IMailFolder.RemoveFlags(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34543. <summary>
  34544. Remove a set of flags from the specified messages.
  34545. </summary>
  34546. <remarks>
  34547. Removes a set of flags from the specified messages.
  34548. </remarks>
  34549. <param name="indexes">The indexes of the messages.</param>
  34550. <param name="flags">The message flags to remove.</param>
  34551. <param name="keywords">A set of user-defined flags to remove.</param>
  34552. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34553. <param name="cancellationToken">The cancellation token.</param>
  34554. </member>
  34555. <member name="M:MailKit.IMailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34556. <summary>
  34557. Asynchronously remove a set of flags from the specified messages.
  34558. </summary>
  34559. <remarks>
  34560. Asynchronously removes a set of flags from the specified messages.
  34561. </remarks>
  34562. <returns>An asynchronous task context.</returns>
  34563. <param name="indexes">The indexes of the messages.</param>
  34564. <param name="flags">The message flags to remove.</param>
  34565. <param name="keywords">A set of user-defined flags to remove.</param>
  34566. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34567. <param name="cancellationToken">The cancellation token.</param>
  34568. </member>
  34569. <member name="M:MailKit.IMailFolder.SetFlags(System.Int32,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34570. <summary>
  34571. Set the flags of the specified message.
  34572. </summary>
  34573. <remarks>
  34574. Sets the flags of the specified message.
  34575. </remarks>
  34576. <param name="index">The index of the message.</param>
  34577. <param name="flags">The message flags to set.</param>
  34578. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34579. <param name="cancellationToken">The cancellation token.</param>
  34580. </member>
  34581. <member name="M:MailKit.IMailFolder.SetFlagsAsync(System.Int32,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34582. <summary>
  34583. Asynchronously set the flags of the specified message.
  34584. </summary>
  34585. <remarks>
  34586. Asynchronously sets the flags of the specified message.
  34587. </remarks>
  34588. <returns>An asynchronous task context.</returns>
  34589. <param name="index">The index of the message.</param>
  34590. <param name="flags">The message flags to set.</param>
  34591. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34592. <param name="cancellationToken">The cancellation token.</param>
  34593. </member>
  34594. <member name="M:MailKit.IMailFolder.SetFlags(System.Int32,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34595. <summary>
  34596. Set the flags of the specified message.
  34597. </summary>
  34598. <remarks>
  34599. Sets the flags of the specified message.
  34600. </remarks>
  34601. <param name="index">The index of the message.</param>
  34602. <param name="flags">The message flags to set.</param>
  34603. <param name="keywords">A set of user-defined flags to set.</param>
  34604. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34605. <param name="cancellationToken">The cancellation token.</param>
  34606. </member>
  34607. <member name="M:MailKit.IMailFolder.SetFlagsAsync(System.Int32,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34608. <summary>
  34609. Asynchronously set the flags of the specified message.
  34610. </summary>
  34611. <remarks>
  34612. Asynchronously sets the flags of the specified message.
  34613. </remarks>
  34614. <returns>An asynchronous task context.</returns>
  34615. <param name="index">The index of the message.</param>
  34616. <param name="flags">The message flags to set.</param>
  34617. <param name="keywords">A set of user-defined flags to set.</param>
  34618. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34619. <param name="cancellationToken">The cancellation token.</param>
  34620. </member>
  34621. <member name="M:MailKit.IMailFolder.SetFlags(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34622. <summary>
  34623. Set the flags of the specified messages.
  34624. </summary>
  34625. <remarks>
  34626. Sets the flags of the specified messages.
  34627. </remarks>
  34628. <param name="indexes">The indexes of the messages.</param>
  34629. <param name="flags">The message flags to set.</param>
  34630. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34631. <param name="cancellationToken">The cancellation token.</param>
  34632. </member>
  34633. <member name="M:MailKit.IMailFolder.SetFlagsAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34634. <summary>
  34635. Asynchronously set the flags of the specified messages.
  34636. </summary>
  34637. <remarks>
  34638. Asynchronously sets the flags of the specified messages.
  34639. </remarks>
  34640. <returns>An asynchronous task context.</returns>
  34641. <param name="indexes">The indexes of the messages.</param>
  34642. <param name="flags">The message flags to set.</param>
  34643. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34644. <param name="cancellationToken">The cancellation token.</param>
  34645. </member>
  34646. <member name="M:MailKit.IMailFolder.SetFlags(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34647. <summary>
  34648. Set the flags of the specified messages.
  34649. </summary>
  34650. <remarks>
  34651. Sets the flags of the specified messages.
  34652. </remarks>
  34653. <param name="indexes">The indexes of the messages.</param>
  34654. <param name="flags">The message flags to set.</param>
  34655. <param name="keywords">A set of user-defined flags to set.</param>
  34656. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34657. <param name="cancellationToken">The cancellation token.</param>
  34658. </member>
  34659. <member name="M:MailKit.IMailFolder.SetFlagsAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34660. <summary>
  34661. Asynchronously set the flags of the specified messages.
  34662. </summary>
  34663. <remarks>
  34664. Asynchronously sets the flags of the specified messages.
  34665. </remarks>
  34666. <returns>An asynchronous task context.</returns>
  34667. <param name="indexes">The indexes of the messages.</param>
  34668. <param name="flags">The message flags to set.</param>
  34669. <param name="keywords">A set of user-defined flags to set.</param>
  34670. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34671. <param name="cancellationToken">The cancellation token.</param>
  34672. </member>
  34673. <member name="M:MailKit.IMailFolder.AddFlags(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34674. <summary>
  34675. Add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34676. </summary>
  34677. <remarks>
  34678. Adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34679. </remarks>
  34680. <returns>The indexes of the messages that were not updated.</returns>
  34681. <param name="indexes">The indexes of the messages.</param>
  34682. <param name="modseq">The mod-sequence value.</param>
  34683. <param name="flags">The message flags to add.</param>
  34684. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34685. <param name="cancellationToken">The cancellation token.</param>
  34686. </member>
  34687. <member name="M:MailKit.IMailFolder.AddFlagsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34688. <summary>
  34689. Asynchronously add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34690. </summary>
  34691. <remarks>
  34692. Asynchronously adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34693. </remarks>
  34694. <returns>The indexes of the messages that were not updated.</returns>
  34695. <param name="indexes">The indexes of the messages.</param>
  34696. <param name="modseq">The mod-sequence value.</param>
  34697. <param name="flags">The message flags to add.</param>
  34698. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34699. <param name="cancellationToken">The cancellation token.</param>
  34700. </member>
  34701. <member name="M:MailKit.IMailFolder.AddFlags(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34702. <summary>
  34703. Add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34704. </summary>
  34705. <remarks>
  34706. Adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34707. </remarks>
  34708. <returns>The indexes of the messages that were not updated.</returns>
  34709. <param name="indexes">The indexes of the messages.</param>
  34710. <param name="modseq">The mod-sequence value.</param>
  34711. <param name="flags">The message flags to add.</param>
  34712. <param name="keywords">A set of user-defined flags to add.</param>
  34713. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34714. <param name="cancellationToken">The cancellation token.</param>
  34715. </member>
  34716. <member name="M:MailKit.IMailFolder.AddFlagsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34717. <summary>
  34718. Asynchronously add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34719. </summary>
  34720. <remarks>
  34721. Asynchronously adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  34722. </remarks>
  34723. <returns>The indexes of the messages that were not updated.</returns>
  34724. <param name="indexes">The indexes of the messages.</param>
  34725. <param name="modseq">The mod-sequence value.</param>
  34726. <param name="flags">The message flags to add.</param>
  34727. <param name="keywords">A set of user-defined flags to add.</param>
  34728. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34729. <param name="cancellationToken">The cancellation token.</param>
  34730. </member>
  34731. <member name="M:MailKit.IMailFolder.RemoveFlags(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34732. <summary>
  34733. Remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34734. </summary>
  34735. <remarks>
  34736. Removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34737. </remarks>
  34738. <returns>The indexes of the messages that were not updated.</returns>
  34739. <param name="indexes">The indexes of the messages.</param>
  34740. <param name="modseq">The mod-sequence value.</param>
  34741. <param name="flags">The message flags to remove.</param>
  34742. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34743. <param name="cancellationToken">The cancellation token.</param>
  34744. </member>
  34745. <member name="M:MailKit.IMailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34746. <summary>
  34747. Asynchronously remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34748. </summary>
  34749. <remarks>
  34750. Asynchronously removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34751. </remarks>
  34752. <returns>The indexes of the messages that were not updated.</returns>
  34753. <param name="indexes">The indexes of the messages.</param>
  34754. <param name="modseq">The mod-sequence value.</param>
  34755. <param name="flags">The message flags to remove.</param>
  34756. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34757. <param name="cancellationToken">The cancellation token.</param>
  34758. </member>
  34759. <member name="M:MailKit.IMailFolder.RemoveFlags(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34760. <summary>
  34761. Remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34762. </summary>
  34763. <remarks>
  34764. Removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34765. </remarks>
  34766. <returns>The indexes of the messages that were not updated.</returns>
  34767. <param name="indexes">The indexes of the messages.</param>
  34768. <param name="modseq">The mod-sequence value.</param>
  34769. <param name="flags">The message flags to remove.</param>
  34770. <param name="keywords">A set of user-defined flags to remove.</param>
  34771. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34772. <param name="cancellationToken">The cancellation token.</param>
  34773. </member>
  34774. <member name="M:MailKit.IMailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34775. <summary>
  34776. Asynchronously remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34777. </summary>
  34778. <remarks>
  34779. Asynchronously removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  34780. </remarks>
  34781. <returns>The indexes of the messages that were not updated.</returns>
  34782. <param name="indexes">The indexes of the messages.</param>
  34783. <param name="modseq">The mod-sequence value.</param>
  34784. <param name="flags">The message flags to remove.</param>
  34785. <param name="keywords">A set of user-defined flags to remove.</param>
  34786. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34787. <param name="cancellationToken">The cancellation token.</param>
  34788. </member>
  34789. <member name="M:MailKit.IMailFolder.SetFlags(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34790. <summary>
  34791. Set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34792. </summary>
  34793. <remarks>
  34794. Sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34795. </remarks>
  34796. <returns>The indexes of the messages that were not updated.</returns>
  34797. <param name="indexes">The indexes of the messages.</param>
  34798. <param name="modseq">The mod-sequence value.</param>
  34799. <param name="flags">The message flags to set.</param>
  34800. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34801. <param name="cancellationToken">The cancellation token.</param>
  34802. </member>
  34803. <member name="M:MailKit.IMailFolder.SetFlagsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  34804. <summary>
  34805. Asynchronously set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34806. </summary>
  34807. <remarks>
  34808. Asynchronously sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34809. </remarks>
  34810. <returns>The indexes of the messages that were not updated.</returns>
  34811. <param name="indexes">The indexes of the messages.</param>
  34812. <param name="modseq">The mod-sequence value.</param>
  34813. <param name="flags">The message flags to set.</param>
  34814. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34815. <param name="cancellationToken">The cancellation token.</param>
  34816. </member>
  34817. <member name="M:MailKit.IMailFolder.SetFlags(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34818. <summary>
  34819. Set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34820. </summary>
  34821. <remarks>
  34822. Sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34823. </remarks>
  34824. <returns>The indexes of the messages that were not updated.</returns>
  34825. <param name="indexes">The indexes of the messages.</param>
  34826. <param name="modseq">The mod-sequence value.</param>
  34827. <param name="flags">The message flags to set.</param>
  34828. <param name="keywords">A set of user-defined flags to set.</param>
  34829. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34830. <param name="cancellationToken">The cancellation token.</param>
  34831. </member>
  34832. <member name="M:MailKit.IMailFolder.SetFlagsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  34833. <summary>
  34834. Asynchronously set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34835. </summary>
  34836. <remarks>
  34837. Asynchronously sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  34838. </remarks>
  34839. <returns>The indexes of the messages that were not updated.</returns>
  34840. <param name="indexes">The indexes of the messages.</param>
  34841. <param name="modseq">The mod-sequence value.</param>
  34842. <param name="flags">The message flags to set.</param>
  34843. <param name="keywords">A set of user-defined flags to set.</param>
  34844. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34845. <param name="cancellationToken">The cancellation token.</param>
  34846. </member>
  34847. <member name="M:MailKit.IMailFolder.AddLabels(MailKit.UniqueId,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  34848. <summary>
  34849. Add a set of labels to the specified message.
  34850. </summary>
  34851. <remarks>
  34852. Adds a set of labels to the specified message.
  34853. </remarks>
  34854. <param name="uid">The UID of the message.</param>
  34855. <param name="labels">The labels to add.</param>
  34856. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  34857. <param name="cancellationToken">The cancellation token.</param>
  34858. </member>
  34859. <member name="M:MailKit.IMailFolder.AddLabelsAsync(MailKit.UniqueId,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  34860. <summary>
  34861. Asynchronously add a set of labels to the specified message.
  34862. </summary>
  34863. <remarks>
  34864. Asynchronously adds a set of labels to the specified message.
  34865. </remarks>
  34866. <returns>An asynchronous task context.</returns>
  34867. <param name="uid">The UIDs of the message.</param>
  34868. <param name="labels">The labels to add.</param>
  34869. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  34870. <param name="cancellationToken">The cancellation token.</param>
  34871. </member>
  34872. <member name="M:MailKit.IMailFolder.AddLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  34873. <summary>
  34874. Add a set of labels to the specified messages.
  34875. </summary>
  34876. <remarks>
  34877. Adds a set of labels to the specified messages.
  34878. </remarks>
  34879. <param name="uids">The UIDs of the messages.</param>
  34880. <param name="labels">The labels to add.</param>
  34881. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  34882. <param name="cancellationToken">The cancellation token.</param>
  34883. </member>
  34884. <member name="M:MailKit.IMailFolder.AddLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  34885. <summary>
  34886. Asynchronously add a set of labels to the specified messages.
  34887. </summary>
  34888. <remarks>
  34889. Asynchronously adds a set of labels to the specified messages.
  34890. </remarks>
  34891. <returns>An asynchronous task context.</returns>
  34892. <param name="uids">The UIDs of the messages.</param>
  34893. <param name="labels">The labels to add.</param>
  34894. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  34895. <param name="cancellationToken">The cancellation token.</param>
  34896. </member>
  34897. <member name="M:MailKit.IMailFolder.RemoveLabels(MailKit.UniqueId,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  34898. <summary>
  34899. Remove a set of labels from the specified message.
  34900. </summary>
  34901. <remarks>
  34902. Removes a set of labels from the specified message.
  34903. </remarks>
  34904. <param name="uid">The UID of the message.</param>
  34905. <param name="labels">The labels to remove.</param>
  34906. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  34907. <param name="cancellationToken">The cancellation token.</param>
  34908. </member>
  34909. <member name="M:MailKit.IMailFolder.RemoveLabelsAsync(MailKit.UniqueId,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  34910. <summary>
  34911. Asynchronously remove a set of labels from the specified message.
  34912. </summary>
  34913. <remarks>
  34914. Asynchronously removes a set of labels from the specified message.
  34915. </remarks>
  34916. <returns>An asynchronous task context.</returns>
  34917. <param name="uid">The UID of the message.</param>
  34918. <param name="labels">The labels to remove.</param>
  34919. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  34920. <param name="cancellationToken">The cancellation token.</param>
  34921. </member>
  34922. <member name="M:MailKit.IMailFolder.RemoveLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  34923. <summary>
  34924. Remove a set of labels from the specified messages.
  34925. </summary>
  34926. <remarks>
  34927. Removes a set of labels from the specified messages.
  34928. </remarks>
  34929. <param name="uids">The UIDs of the messages.</param>
  34930. <param name="labels">The labels to remove.</param>
  34931. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  34932. <param name="cancellationToken">The cancellation token.</param>
  34933. </member>
  34934. <member name="M:MailKit.IMailFolder.RemoveLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  34935. <summary>
  34936. Asynchronously remove a set of labels from the specified messages.
  34937. </summary>
  34938. <remarks>
  34939. Asynchronously removes a set of labels from the specified messages.
  34940. </remarks>
  34941. <returns>An asynchronous task context.</returns>
  34942. <param name="uids">The UIDs of the messages.</param>
  34943. <param name="labels">The labels to remove.</param>
  34944. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  34945. <param name="cancellationToken">The cancellation token.</param>
  34946. </member>
  34947. <member name="M:MailKit.IMailFolder.SetLabels(MailKit.UniqueId,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  34948. <summary>
  34949. Set the labels of the specified message.
  34950. </summary>
  34951. <remarks>
  34952. Sets the labels of the specified message.
  34953. </remarks>
  34954. <param name="uid">The UID of the message.</param>
  34955. <param name="labels">The labels to set.</param>
  34956. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  34957. <param name="cancellationToken">The cancellation token.</param>
  34958. </member>
  34959. <member name="M:MailKit.IMailFolder.SetLabelsAsync(MailKit.UniqueId,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  34960. <summary>
  34961. Asynchronously set the labels of the specified message.
  34962. </summary>
  34963. <remarks>
  34964. Asynchronously sets the labels of the specified message.
  34965. </remarks>
  34966. <returns>An asynchronous task context.</returns>
  34967. <param name="uid">The UID of the message.</param>
  34968. <param name="labels">The labels to set.</param>
  34969. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  34970. <param name="cancellationToken">The cancellation token.</param>
  34971. </member>
  34972. <member name="M:MailKit.IMailFolder.SetLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  34973. <summary>
  34974. Set the labels of the specified messages.
  34975. </summary>
  34976. <remarks>
  34977. Sets the labels of the specified messages.
  34978. </remarks>
  34979. <param name="uids">The UIDs of the messages.</param>
  34980. <param name="labels">The labels to set.</param>
  34981. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  34982. <param name="cancellationToken">The cancellation token.</param>
  34983. </member>
  34984. <member name="M:MailKit.IMailFolder.SetLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  34985. <summary>
  34986. Asynchronously set the labels of the specified messages.
  34987. </summary>
  34988. <remarks>
  34989. Asynchronously sets the labels of the specified messages.
  34990. </remarks>
  34991. <returns>An asynchronous task context.</returns>
  34992. <param name="uids">The UIDs of the messages.</param>
  34993. <param name="labels">The labels to set.</param>
  34994. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  34995. <param name="cancellationToken">The cancellation token.</param>
  34996. </member>
  34997. <member name="M:MailKit.IMailFolder.AddLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  34998. <summary>
  34999. Add a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  35000. </summary>
  35001. <remarks>
  35002. Adds a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  35003. </remarks>
  35004. <returns>The unique IDs of the messages that were not updated.</returns>
  35005. <param name="uids">The UIDs of the messages.</param>
  35006. <param name="modseq">The mod-sequence value.</param>
  35007. <param name="labels">The labels to add.</param>
  35008. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35009. <param name="cancellationToken">The cancellation token.</param>
  35010. </member>
  35011. <member name="M:MailKit.IMailFolder.AddLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35012. <summary>
  35013. Asynchronously add a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  35014. </summary>
  35015. <remarks>
  35016. Asynchronously adds a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  35017. </remarks>
  35018. <returns>The unique IDs of the messages that were not updated.</returns>
  35019. <param name="uids">The UIDs of the messages.</param>
  35020. <param name="modseq">The mod-sequence value.</param>
  35021. <param name="labels">The labels to add.</param>
  35022. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35023. <param name="cancellationToken">The cancellation token.</param>
  35024. </member>
  35025. <member name="M:MailKit.IMailFolder.RemoveLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35026. <summary>
  35027. Remove a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  35028. </summary>
  35029. <remarks>
  35030. Removes a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  35031. </remarks>
  35032. <returns>The unique IDs of the messages that were not updated.</returns>
  35033. <param name="uids">The UIDs of the messages.</param>
  35034. <param name="modseq">The mod-sequence value.</param>
  35035. <param name="labels">The labels to remove.</param>
  35036. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35037. <param name="cancellationToken">The cancellation token.</param>
  35038. </member>
  35039. <member name="M:MailKit.IMailFolder.RemoveLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35040. <summary>
  35041. Asynchronously remove a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  35042. </summary>
  35043. <remarks>
  35044. Asynchronously removes a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  35045. </remarks>
  35046. <returns>The unique IDs of the messages that were not updated.</returns>
  35047. <param name="uids">The UIDs of the messages.</param>
  35048. <param name="modseq">The mod-sequence value.</param>
  35049. <param name="labels">The labels to remove.</param>
  35050. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35051. <param name="cancellationToken">The cancellation token.</param>
  35052. </member>
  35053. <member name="M:MailKit.IMailFolder.SetLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35054. <summary>
  35055. Set the labels of the specified messages only if their mod-sequence value is less than the specified value.
  35056. </summary>
  35057. <remarks>
  35058. Sets the labels of the specified messages only if their mod-sequence value is less than the specified value.
  35059. </remarks>
  35060. <returns>The unique IDs of the messages that were not updated.</returns>
  35061. <param name="uids">The UIDs of the messages.</param>
  35062. <param name="modseq">The mod-sequence value.</param>
  35063. <param name="labels">The labels to set.</param>
  35064. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35065. <param name="cancellationToken">The cancellation token.</param>
  35066. </member>
  35067. <member name="M:MailKit.IMailFolder.SetLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35068. <summary>
  35069. Asynchronously set the labels of the specified messages only if their mod-sequence value is less than the specified value.
  35070. </summary>
  35071. <remarks>
  35072. Asynchronously sets the labels of the specified messages only if their mod-sequence value is less than the specified value.
  35073. </remarks>
  35074. <returns>The unique IDs of the messages that were not updated.</returns>
  35075. <param name="uids">The UIDs of the messages.</param>
  35076. <param name="modseq">The mod-sequence value.</param>
  35077. <param name="labels">The labels to set.</param>
  35078. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35079. <param name="cancellationToken">The cancellation token.</param>
  35080. </member>
  35081. <member name="M:MailKit.IMailFolder.AddLabels(System.Int32,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35082. <summary>
  35083. Add a set of labels to the specified message.
  35084. </summary>
  35085. <remarks>
  35086. Adds a set of labels to the specified message.
  35087. </remarks>
  35088. <param name="index">The index of the message.</param>
  35089. <param name="labels">The labels to add.</param>
  35090. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35091. <param name="cancellationToken">The cancellation token.</param>
  35092. </member>
  35093. <member name="M:MailKit.IMailFolder.AddLabelsAsync(System.Int32,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35094. <summary>
  35095. Asynchronously add a set of labels to the specified message.
  35096. </summary>
  35097. <remarks>
  35098. Asynchronously adds a set of labels to the specified message.
  35099. </remarks>
  35100. <returns>An asynchronous task context.</returns>
  35101. <param name="index">The index of the message.</param>
  35102. <param name="labels">The labels to add.</param>
  35103. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35104. <param name="cancellationToken">The cancellation token.</param>
  35105. </member>
  35106. <member name="M:MailKit.IMailFolder.AddLabels(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35107. <summary>
  35108. Add a set of labels to the specified messages.
  35109. </summary>
  35110. <remarks>
  35111. Adds a set of labels to the specified messages.
  35112. </remarks>
  35113. <param name="indexes">The indexes of the messages.</param>
  35114. <param name="labels">The labels to add.</param>
  35115. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35116. <param name="cancellationToken">The cancellation token.</param>
  35117. </member>
  35118. <member name="M:MailKit.IMailFolder.AddLabelsAsync(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35119. <summary>
  35120. Asynchronously add a set of labels to the specified messages.
  35121. </summary>
  35122. <remarks>
  35123. Asynchronously adds a set of labels to the specified messages.
  35124. </remarks>
  35125. <returns>An asynchronous task context.</returns>
  35126. <param name="indexes">The indexes of the messages.</param>
  35127. <param name="labels">The labels to add.</param>
  35128. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35129. <param name="cancellationToken">The cancellation token.</param>
  35130. </member>
  35131. <member name="M:MailKit.IMailFolder.RemoveLabels(System.Int32,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35132. <summary>
  35133. Remove a set of labels from the specified message.
  35134. </summary>
  35135. <remarks>
  35136. Removes a set of labels from the specified message.
  35137. </remarks>
  35138. <param name="index">The index of the message.</param>
  35139. <param name="labels">The labels to remove.</param>
  35140. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35141. <param name="cancellationToken">The cancellation token.</param>
  35142. </member>
  35143. <member name="M:MailKit.IMailFolder.RemoveLabelsAsync(System.Int32,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35144. <summary>
  35145. Asynchronously remove a set of labels from the specified message.
  35146. </summary>
  35147. <remarks>
  35148. Asynchronously removes a set of labels from the specified message.
  35149. </remarks>
  35150. <returns>An asynchronous task context.</returns>
  35151. <param name="index">The index of the message.</param>
  35152. <param name="labels">The labels to remove.</param>
  35153. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35154. <param name="cancellationToken">The cancellation token.</param>
  35155. </member>
  35156. <member name="M:MailKit.IMailFolder.RemoveLabels(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35157. <summary>
  35158. Remove a set of labels from the specified messages.
  35159. </summary>
  35160. <remarks>
  35161. Removes a set of labels from the specified messages.
  35162. </remarks>
  35163. <param name="indexes">The indexes of the messages.</param>
  35164. <param name="labels">The labels to remove.</param>
  35165. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35166. <param name="cancellationToken">The cancellation token.</param>
  35167. </member>
  35168. <member name="M:MailKit.IMailFolder.RemoveLabelsAsync(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35169. <summary>
  35170. Asynchronously remove a set of labels from the specified messages.
  35171. </summary>
  35172. <remarks>
  35173. Asynchronously removes a set of labels from the specified messages.
  35174. </remarks>
  35175. <returns>An asynchronous task context.</returns>
  35176. <param name="indexes">The indexes of the messages.</param>
  35177. <param name="labels">The labels to remove.</param>
  35178. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35179. <param name="cancellationToken">The cancellation token.</param>
  35180. </member>
  35181. <member name="M:MailKit.IMailFolder.SetLabels(System.Int32,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35182. <summary>
  35183. Set the labels of the specified message.
  35184. </summary>
  35185. <remarks>
  35186. Sets the labels of the specified message.
  35187. </remarks>
  35188. <param name="index">The index of the message.</param>
  35189. <param name="labels">The labels to set.</param>
  35190. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35191. <param name="cancellationToken">The cancellation token.</param>
  35192. </member>
  35193. <member name="M:MailKit.IMailFolder.SetLabelsAsync(System.Int32,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35194. <summary>
  35195. Asynchronously set the labels of the specified message.
  35196. </summary>
  35197. <remarks>
  35198. Asynchronously sets the labels of the specified message.
  35199. </remarks>
  35200. <returns>An asynchronous task context.</returns>
  35201. <param name="index">The index of the message.</param>
  35202. <param name="labels">The labels to set.</param>
  35203. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35204. <param name="cancellationToken">The cancellation token.</param>
  35205. </member>
  35206. <member name="M:MailKit.IMailFolder.SetLabels(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35207. <summary>
  35208. Set the labels of the specified messages.
  35209. </summary>
  35210. <remarks>
  35211. Sets the labels of the specified messages.
  35212. </remarks>
  35213. <param name="indexes">The indexes of the messages.</param>
  35214. <param name="labels">The labels to set.</param>
  35215. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35216. <param name="cancellationToken">The cancellation token.</param>
  35217. </member>
  35218. <member name="M:MailKit.IMailFolder.SetLabelsAsync(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35219. <summary>
  35220. Asynchronously set the labels of the specified messages.
  35221. </summary>
  35222. <remarks>
  35223. Asynchronously sets the labels of the specified messages.
  35224. </remarks>
  35225. <returns>An asynchronous task context.</returns>
  35226. <param name="indexes">The indexes of the messages.</param>
  35227. <param name="labels">The labels to set.</param>
  35228. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35229. <param name="cancellationToken">The cancellation token.</param>
  35230. </member>
  35231. <member name="M:MailKit.IMailFolder.AddLabels(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35232. <summary>
  35233. Add a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  35234. </summary>
  35235. <remarks>
  35236. Adds a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  35237. </remarks>
  35238. <returns>The indexes of the messages that were not updated.</returns>
  35239. <param name="indexes">The indexes of the messages.</param>
  35240. <param name="modseq">The mod-sequence value.</param>
  35241. <param name="labels">The labels to add.</param>
  35242. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35243. <param name="cancellationToken">The cancellation token.</param>
  35244. </member>
  35245. <member name="M:MailKit.IMailFolder.AddLabelsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35246. <summary>
  35247. Asynchronously add a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  35248. </summary>
  35249. <remarks>
  35250. Asynchronously adds a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  35251. </remarks>
  35252. <returns>The indexes of the messages that were not updated.</returns>
  35253. <param name="indexes">The indexes of the messages.</param>
  35254. <param name="modseq">The mod-sequence value.</param>
  35255. <param name="labels">The labels to add.</param>
  35256. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35257. <param name="cancellationToken">The cancellation token.</param>
  35258. </member>
  35259. <member name="M:MailKit.IMailFolder.RemoveLabels(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35260. <summary>
  35261. Remove a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  35262. </summary>
  35263. <remarks>
  35264. Removes a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  35265. </remarks>
  35266. <returns>The indexes of the messages that were not updated.</returns>
  35267. <param name="indexes">The indexes of the messages.</param>
  35268. <param name="modseq">The mod-sequence value.</param>
  35269. <param name="labels">The labels to remove.</param>
  35270. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35271. <param name="cancellationToken">The cancellation token.</param>
  35272. </member>
  35273. <member name="M:MailKit.IMailFolder.RemoveLabelsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35274. <summary>
  35275. Asynchronously remove a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  35276. </summary>
  35277. <remarks>
  35278. Asynchronously removes a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  35279. </remarks>
  35280. <returns>The indexes of the messages that were not updated.</returns>
  35281. <param name="indexes">The indexes of the messages.</param>
  35282. <param name="modseq">The mod-sequence value.</param>
  35283. <param name="labels">The labels to remove.</param>
  35284. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35285. <param name="cancellationToken">The cancellation token.</param>
  35286. </member>
  35287. <member name="M:MailKit.IMailFolder.SetLabels(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35288. <summary>
  35289. Set the labels of the specified messages only if their mod-sequence value is less than the specified value.
  35290. </summary>
  35291. <remarks>
  35292. Sets the labels of the specified messages only if their mod-sequence value is less than the specified value.
  35293. </remarks>
  35294. <returns>The indexes of the messages that were not updated.</returns>
  35295. <param name="indexes">The indexes of the messages.</param>
  35296. <param name="modseq">The mod-sequence value.</param>
  35297. <param name="labels">The labels to set.</param>
  35298. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35299. <param name="cancellationToken">The cancellation token.</param>
  35300. </member>
  35301. <member name="M:MailKit.IMailFolder.SetLabelsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  35302. <summary>
  35303. Asynchronously set the labels of the specified messages only if their mod-sequence value is less than the specified value.
  35304. </summary>
  35305. <remarks>
  35306. Asynchronously sets the labels of the specified messages only if their mod-sequence value is less than the specified value.
  35307. </remarks>
  35308. <returns>The indexes of the messages that were not updated.</returns>
  35309. <param name="indexes">The indexes of the messages.</param>
  35310. <param name="modseq">The mod-sequence value.</param>
  35311. <param name="labels">The labels to set.</param>
  35312. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  35313. <param name="cancellationToken">The cancellation token.</param>
  35314. </member>
  35315. <member name="M:MailKit.IMailFolder.Store(MailKit.UniqueId,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  35316. <summary>
  35317. Store the annotations for the specified message.
  35318. </summary>
  35319. <remarks>
  35320. Stores the annotations for the specified message.
  35321. </remarks>
  35322. <param name="uid">The UID of the message.</param>
  35323. <param name="annotations">The annotations to store.</param>
  35324. <param name="cancellationToken">The cancellation token.</param>
  35325. </member>
  35326. <member name="M:MailKit.IMailFolder.StoreAsync(MailKit.UniqueId,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  35327. <summary>
  35328. Asynchronously store the annotations for the specified message.
  35329. </summary>
  35330. <remarks>
  35331. Asynchronously stores the annotations for the specified message.
  35332. </remarks>
  35333. <returns>An asynchronous task context.</returns>
  35334. <param name="uid">The UID of the message.</param>
  35335. <param name="annotations">The annotations to store.</param>
  35336. <param name="cancellationToken">The cancellation token.</param>
  35337. </member>
  35338. <member name="M:MailKit.IMailFolder.Store(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  35339. <summary>
  35340. Store the annotations for the specified messages.
  35341. </summary>
  35342. <remarks>
  35343. Stores the annotations for the specified messages.
  35344. </remarks>
  35345. <param name="uids">The UIDs of the messages.</param>
  35346. <param name="annotations">The annotations to store.</param>
  35347. <param name="cancellationToken">The cancellation token.</param>
  35348. </member>
  35349. <member name="M:MailKit.IMailFolder.StoreAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  35350. <summary>
  35351. Asynchronously store the annotations for the specified messages.
  35352. </summary>
  35353. <remarks>
  35354. Asynchronously stores the annotations for the specified messages.
  35355. </remarks>
  35356. <returns>An asynchronous task context.</returns>
  35357. <param name="uids">The UIDs of the messages.</param>
  35358. <param name="annotations">The annotations to store.</param>
  35359. <param name="cancellationToken">The cancellation token.</param>
  35360. </member>
  35361. <member name="M:MailKit.IMailFolder.Store(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  35362. <summary>
  35363. Store the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  35364. </summary>
  35365. <remarks>
  35366. Stores the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  35367. </remarks>
  35368. <returns>The unique IDs of the messages that were not updated.</returns>
  35369. <param name="uids">The UIDs of the messages.</param>
  35370. <param name="modseq">The mod-sequence value.</param>
  35371. <param name="annotations">The annotations to store.</param>
  35372. <param name="cancellationToken">The cancellation token.</param>
  35373. </member>
  35374. <member name="M:MailKit.IMailFolder.StoreAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  35375. <summary>
  35376. Asynchronously store the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  35377. </summary>
  35378. <remarks>
  35379. Asynchronously stores the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  35380. </remarks>
  35381. <returns>The unique IDs of the messages that were not updated.</returns>
  35382. <param name="uids">The UIDs of the messages.</param>
  35383. <param name="modseq">The mod-sequence value.</param>
  35384. <param name="annotations">The annotations to store.</param>
  35385. <param name="cancellationToken">The cancellation token.</param>
  35386. </member>
  35387. <member name="M:MailKit.IMailFolder.Store(System.Int32,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  35388. <summary>
  35389. Store the annotations for the specified message.
  35390. </summary>
  35391. <remarks>
  35392. Stores the annotations for the specified message.
  35393. </remarks>
  35394. <param name="index">The index of the message.</param>
  35395. <param name="annotations">The annotations to store.</param>
  35396. <param name="cancellationToken">The cancellation token.</param>
  35397. </member>
  35398. <member name="M:MailKit.IMailFolder.StoreAsync(System.Int32,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  35399. <summary>
  35400. Asynchronously store the annotations for the specified message.
  35401. </summary>
  35402. <remarks>
  35403. Asynchronously stores the annotations for the specified message.
  35404. </remarks>
  35405. <returns>An asynchronous task context.</returns>
  35406. <param name="index">The indexes of the message.</param>
  35407. <param name="annotations">The annotations to store.</param>
  35408. <param name="cancellationToken">The cancellation token.</param>
  35409. </member>
  35410. <member name="M:MailKit.IMailFolder.Store(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  35411. <summary>
  35412. Store the annotations for the specified messages.
  35413. </summary>
  35414. <remarks>
  35415. Stores the annotations for the specified messages.
  35416. </remarks>
  35417. <param name="indexes">The indexes of the messages.</param>
  35418. <param name="annotations">The annotations to store.</param>
  35419. <param name="cancellationToken">The cancellation token.</param>
  35420. </member>
  35421. <member name="M:MailKit.IMailFolder.StoreAsync(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  35422. <summary>
  35423. Asynchronously store the annotations for the specified messages.
  35424. </summary>
  35425. <remarks>
  35426. Asynchronously stores the annotations for the specified messages.
  35427. </remarks>
  35428. <returns>An asynchronous task context.</returns>
  35429. <param name="indexes">The indexes of the messages.</param>
  35430. <param name="annotations">The annotations to store.</param>
  35431. <param name="cancellationToken">The cancellation token.</param>
  35432. </member>
  35433. <member name="M:MailKit.IMailFolder.Store(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  35434. <summary>
  35435. Store the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  35436. </summary>
  35437. <remarks>
  35438. Stores the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  35439. </remarks>
  35440. <returns>The indexes of the messages that were not updated.</returns>
  35441. <param name="indexes">The indexes of the messages.</param>
  35442. <param name="modseq">The mod-sequence value.</param>
  35443. <param name="annotations">The annotations to store.</param>
  35444. <param name="cancellationToken">The cancellation token.</param>
  35445. </member>
  35446. <member name="M:MailKit.IMailFolder.StoreAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  35447. <summary>
  35448. Asynchronously store the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  35449. </summary>
  35450. <remarks>
  35451. Asynchronously stores the annotations for the specified messages only if their mod-sequence value is less than the specified value.s
  35452. </remarks>
  35453. <returns>The indexes of the messages that were not updated.</returns>
  35454. <param name="indexes">The indexes of the messages.</param>
  35455. <param name="modseq">The mod-sequence value.</param>
  35456. <param name="annotations">The annotations to store.</param>
  35457. <param name="cancellationToken">The cancellation token.</param>
  35458. </member>
  35459. <member name="M:MailKit.IMailFolder.Search(MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  35460. <summary>
  35461. Search the folder for messages matching the specified query.
  35462. </summary>
  35463. <remarks>
  35464. The returned array of unique identifiers can be used with methods such as
  35465. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  35466. </remarks>
  35467. <returns>An array of matching UIDs.</returns>
  35468. <param name="query">The search query.</param>
  35469. <param name="cancellationToken">The cancellation token.</param>
  35470. </member>
  35471. <member name="M:MailKit.IMailFolder.SearchAsync(MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  35472. <summary>
  35473. Asynchronously search the folder for messages matching the specified query.
  35474. </summary>
  35475. <remarks>
  35476. The returned array of unique identifiers can be used with methods such as
  35477. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  35478. </remarks>
  35479. <returns>An array of matching UIDs.</returns>
  35480. <param name="query">The search query.</param>
  35481. <param name="cancellationToken">The cancellation token.</param>
  35482. </member>
  35483. <member name="M:MailKit.IMailFolder.Search(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  35484. <summary>
  35485. Search the subset of UIDs in the folder for messages matching the specified query.
  35486. </summary>
  35487. <remarks>
  35488. The returned array of unique identifiers can be used with methods such as
  35489. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  35490. </remarks>
  35491. <returns>An array of matching UIDs.</returns>
  35492. <param name="uids">The subset of UIDs</param>
  35493. <param name="query">The search query.</param>
  35494. <param name="cancellationToken">The cancellation token.</param>
  35495. </member>
  35496. <member name="M:MailKit.IMailFolder.SearchAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  35497. <summary>
  35498. Asynchronously search the subset of UIDs in the folder for messages matching the specified query.
  35499. </summary>
  35500. <remarks>
  35501. The returned array of unique identifiers can be used with methods such as
  35502. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  35503. </remarks>
  35504. <returns>An array of matching UIDs.</returns>
  35505. <param name="uids">The subset of UIDs</param>
  35506. <param name="query">The search query.</param>
  35507. <param name="cancellationToken">The cancellation token.</param>
  35508. </member>
  35509. <member name="M:MailKit.IMailFolder.Search(MailKit.Search.SearchOptions,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  35510. <summary>
  35511. Search the folder for messages matching the specified query.
  35512. </summary>
  35513. <remarks>
  35514. Searches the folder for messages matching the specified query,
  35515. returning only the specified search results.
  35516. </remarks>
  35517. <returns>The search results.</returns>
  35518. <param name="options">The search options.</param>
  35519. <param name="query">The search query.</param>
  35520. <param name="cancellationToken">The cancellation token.</param>
  35521. </member>
  35522. <member name="M:MailKit.IMailFolder.SearchAsync(MailKit.Search.SearchOptions,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  35523. <summary>
  35524. Asynchronously search the folder for messages matching the specified query.
  35525. </summary>
  35526. <remarks>
  35527. Asynchronously searches the folder for messages matching the specified query,
  35528. returning only the specified search results.
  35529. </remarks>
  35530. <returns>The search results.</returns>
  35531. <param name="options">The search options.</param>
  35532. <param name="query">The search query.</param>
  35533. <param name="cancellationToken">The cancellation token.</param>
  35534. </member>
  35535. <member name="M:MailKit.IMailFolder.Search(MailKit.Search.SearchOptions,System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  35536. <summary>
  35537. Search the subset of UIDs in the folder for messages matching the specified query.
  35538. </summary>
  35539. <remarks>
  35540. Searches the fsubset of UIDs in the folder for messages matching the specified query,
  35541. returning only the specified search results.
  35542. </remarks>
  35543. <returns>The search results.</returns>
  35544. <param name="options">The search options.</param>
  35545. <param name="uids">The subset of UIDs</param>
  35546. <param name="query">The search query.</param>
  35547. <param name="cancellationToken">The cancellation token.</param>
  35548. </member>
  35549. <member name="M:MailKit.IMailFolder.SearchAsync(MailKit.Search.SearchOptions,System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  35550. <summary>
  35551. Asynchronously search the subset of UIDs in the folder for messages matching the specified query.
  35552. </summary>
  35553. <remarks>
  35554. Asynchronously searches the fsubset of UIDs in the folder for messages matching the specified query,
  35555. returning only the specified search results.
  35556. </remarks>
  35557. <returns>The search results.</returns>
  35558. <param name="options">The search options.</param>
  35559. <param name="uids">The subset of UIDs</param>
  35560. <param name="query">The search query.</param>
  35561. <param name="cancellationToken">The cancellation token.</param>
  35562. </member>
  35563. <member name="M:MailKit.IMailFolder.Sort(MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  35564. <summary>
  35565. Sort messages matching the specified query.
  35566. </summary>
  35567. <remarks>
  35568. The returned array of unique identifiers will be sorted in the preferred order and
  35569. can be used with <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  35570. </remarks>
  35571. <returns>An array of matching UIDs in the specified sort order.</returns>
  35572. <param name="query">The search query.</param>
  35573. <param name="orderBy">The sort order.</param>
  35574. <param name="cancellationToken">The cancellation token.</param>
  35575. </member>
  35576. <member name="M:MailKit.IMailFolder.SortAsync(MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  35577. <summary>
  35578. Asynchronously sort messages matching the specified query.
  35579. </summary>
  35580. <remarks>
  35581. The returned array of unique identifiers will be sorted in the preferred order and
  35582. can be used with <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  35583. </remarks>
  35584. <returns>An array of matching UIDs in the specified sort order.</returns>
  35585. <param name="query">The search query.</param>
  35586. <param name="orderBy">The sort order.</param>
  35587. <param name="cancellationToken">The cancellation token.</param>
  35588. </member>
  35589. <member name="M:MailKit.IMailFolder.Sort(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  35590. <summary>
  35591. Sort messages matching the specified query.
  35592. </summary>
  35593. <remarks>
  35594. The returned array of unique identifiers will be sorted in the preferred order and
  35595. can be used with <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  35596. </remarks>
  35597. <returns>An array of matching UIDs in the specified sort order.</returns>
  35598. <param name="uids">The subset of UIDs</param>
  35599. <param name="query">The search query.</param>
  35600. <param name="orderBy">The sort order.</param>
  35601. <param name="cancellationToken">The cancellation token.</param>
  35602. </member>
  35603. <member name="M:MailKit.IMailFolder.SortAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  35604. <summary>
  35605. Asynchronously sort messages matching the specified query.
  35606. </summary>
  35607. <remarks>
  35608. The returned array of unique identifiers will be sorted in the preferred order and
  35609. can be used with <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  35610. </remarks>
  35611. <returns>An array of matching UIDs in the specified sort order.</returns>
  35612. <param name="uids">The subset of UIDs</param>
  35613. <param name="query">The search query.</param>
  35614. <param name="orderBy">The sort order.</param>
  35615. <param name="cancellationToken">The cancellation token.</param>
  35616. </member>
  35617. <member name="M:MailKit.IMailFolder.Sort(MailKit.Search.SearchOptions,MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  35618. <summary>
  35619. Sort messages matching the specified query.
  35620. </summary>
  35621. <remarks>
  35622. Searches the folder for messages matching the specified query, returning the search results in the specified sort order.
  35623. </remarks>
  35624. <returns>The search results.</returns>
  35625. <param name="options">The search options.</param>
  35626. <param name="query">The search query.</param>
  35627. <param name="orderBy">The sort order.</param>
  35628. <param name="cancellationToken">The cancellation token.</param>
  35629. </member>
  35630. <member name="M:MailKit.IMailFolder.SortAsync(MailKit.Search.SearchOptions,MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  35631. <summary>
  35632. Asynchronously sort messages matching the specified query.
  35633. </summary>
  35634. <remarks>
  35635. Asynchronously searches the folder for messages matching the specified query, returning the search results in the specified sort order.
  35636. </remarks>
  35637. <returns>The search results.</returns>
  35638. <param name="options">The search options.</param>
  35639. <param name="query">The search query.</param>
  35640. <param name="orderBy">The sort order.</param>
  35641. <param name="cancellationToken">The cancellation token.</param>
  35642. </member>
  35643. <member name="M:MailKit.IMailFolder.Sort(MailKit.Search.SearchOptions,System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  35644. <summary>
  35645. Sort messages matching the specified query.
  35646. </summary>
  35647. <remarks>
  35648. Searches the folder for messages matching the specified query, returning the search results in the specified sort order.
  35649. </remarks>
  35650. <returns>The search results.</returns>
  35651. <param name="options">The search options.</param>
  35652. <param name="uids">The subset of UIDs</param>
  35653. <param name="query">The search query.</param>
  35654. <param name="orderBy">The sort order.</param>
  35655. <param name="cancellationToken">The cancellation token.</param>
  35656. </member>
  35657. <member name="M:MailKit.IMailFolder.SortAsync(MailKit.Search.SearchOptions,System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  35658. <summary>
  35659. Asynchronously sort messages matching the specified query.
  35660. </summary>
  35661. <remarks>
  35662. Asynchronously searches the folder for messages matching the specified query,
  35663. returning the search results in the specified sort order.
  35664. </remarks>
  35665. <returns>The search results.</returns>
  35666. <param name="options">The search options.</param>
  35667. <param name="uids">The subset of UIDs</param>
  35668. <param name="query">The search query.</param>
  35669. <param name="orderBy">The sort order.</param>
  35670. <param name="cancellationToken">The cancellation token.</param>
  35671. </member>
  35672. <member name="M:MailKit.IMailFolder.Thread(MailKit.ThreadingAlgorithm,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  35673. <summary>
  35674. Thread the messages in the folder that match the search query using the specified threading algorithm.
  35675. </summary>
  35676. <remarks>
  35677. The <see cref="P:MailKit.MessageThread.UniqueId"/> can be used with methods such as
  35678. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  35679. </remarks>
  35680. <returns>An array of message threads.</returns>
  35681. <param name="algorithm">The threading algorithm to use.</param>
  35682. <param name="query">The search query.</param>
  35683. <param name="cancellationToken">The cancellation token.</param>
  35684. </member>
  35685. <member name="M:MailKit.IMailFolder.ThreadAsync(MailKit.ThreadingAlgorithm,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  35686. <summary>
  35687. Asynchronously thread the messages in the folder that match the search query using the specified threading algorithm.
  35688. </summary>
  35689. <remarks>
  35690. The <see cref="P:MailKit.MessageThread.UniqueId"/> can be used with methods such as
  35691. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  35692. </remarks>
  35693. <returns>An array of message threads.</returns>
  35694. <param name="algorithm">The threading algorithm to use.</param>
  35695. <param name="query">The search query.</param>
  35696. <param name="cancellationToken">The cancellation token.</param>
  35697. </member>
  35698. <member name="M:MailKit.IMailFolder.Thread(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.ThreadingAlgorithm,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  35699. <summary>
  35700. Thread the messages in the folder that match the search query using the specified threading algorithm.
  35701. </summary>
  35702. <remarks>
  35703. The <see cref="P:MailKit.MessageThread.UniqueId"/> can be used with methods such as
  35704. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  35705. </remarks>
  35706. <returns>An array of message threads.</returns>
  35707. <param name="uids">The subset of UIDs</param>
  35708. <param name="algorithm">The threading algorithm to use.</param>
  35709. <param name="query">The search query.</param>
  35710. <param name="cancellationToken">The cancellation token.</param>
  35711. </member>
  35712. <member name="M:MailKit.IMailFolder.ThreadAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.ThreadingAlgorithm,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  35713. <summary>
  35714. Asynchronously thread the messages in the folder that match the search query using the specified threading algorithm.
  35715. </summary>
  35716. <remarks>
  35717. The <see cref="P:MailKit.MessageThread.UniqueId"/> can be used with methods such as
  35718. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  35719. </remarks>
  35720. <returns>An array of message threads.</returns>
  35721. <param name="uids">The subset of UIDs</param>
  35722. <param name="algorithm">The threading algorithm to use.</param>
  35723. <param name="query">The search query.</param>
  35724. <param name="cancellationToken">The cancellation token.</param>
  35725. </member>
  35726. <member name="E:MailKit.IMailFolder.Opened">
  35727. <summary>
  35728. Occurs when the folder is opened.
  35729. </summary>
  35730. <remarks>
  35731. Emitted when the folder is opened.
  35732. </remarks>
  35733. </member>
  35734. <member name="E:MailKit.IMailFolder.Closed">
  35735. <summary>
  35736. Occurs when the folder is closed.
  35737. </summary>
  35738. <remarks>
  35739. Emitted when the folder is closed.
  35740. </remarks>
  35741. </member>
  35742. <member name="E:MailKit.IMailFolder.Deleted">
  35743. <summary>
  35744. Occurs when the folder is deleted.
  35745. </summary>
  35746. <remarks>
  35747. Emitted when the folder is deleted.
  35748. </remarks>
  35749. </member>
  35750. <member name="E:MailKit.IMailFolder.Renamed">
  35751. <summary>
  35752. Occurs when the folder is renamed.
  35753. </summary>
  35754. <remarks>
  35755. Emitted when the folder is renamed.
  35756. </remarks>
  35757. </member>
  35758. <member name="E:MailKit.IMailFolder.Subscribed">
  35759. <summary>
  35760. Occurs when the folder is subscribed.
  35761. </summary>
  35762. <remarks>
  35763. Emitted when the folder is subscribed.
  35764. </remarks>
  35765. </member>
  35766. <member name="E:MailKit.IMailFolder.Unsubscribed">
  35767. <summary>
  35768. Occurs when the folder is unsubscribed.
  35769. </summary>
  35770. <remarks>
  35771. Emitted when the folder is unsubscribed.
  35772. </remarks>
  35773. </member>
  35774. <member name="E:MailKit.IMailFolder.MessageExpunged">
  35775. <summary>
  35776. Occurs when a message is expunged from the folder.
  35777. </summary>
  35778. <remarks>
  35779. Emitted when a message is expunged from the folder.
  35780. </remarks>
  35781. <example>
  35782. <code language="c#" source="Examples\ImapIdleExample.cs"/>
  35783. </example>
  35784. </member>
  35785. <member name="E:MailKit.IMailFolder.MessagesVanished">
  35786. <summary>
  35787. Occurs when messages vanish from the folder.
  35788. </summary>
  35789. <remarks>
  35790. Emitted when a messages vanish from the folder.
  35791. </remarks>
  35792. </member>
  35793. <member name="E:MailKit.IMailFolder.MessageFlagsChanged">
  35794. <summary>
  35795. Occurs when flags changed on a message.
  35796. </summary>
  35797. <remarks>
  35798. Emitted when flags changed on a message.
  35799. </remarks>
  35800. <example>
  35801. <code language="c#" source="Examples\ImapIdleExample.cs"/>
  35802. </example>
  35803. </member>
  35804. <member name="E:MailKit.IMailFolder.MessageLabelsChanged">
  35805. <summary>
  35806. Occurs when labels changed on a message.
  35807. </summary>
  35808. <remarks>
  35809. Emitted when labels changed on a message.
  35810. </remarks>
  35811. </member>
  35812. <member name="E:MailKit.IMailFolder.AnnotationsChanged">
  35813. <summary>
  35814. Occurs when annotations changed on a message.
  35815. </summary>
  35816. <remarks>
  35817. Emitted when annotations changed on a message.
  35818. </remarks>
  35819. </member>
  35820. <member name="E:MailKit.IMailFolder.MessageSummaryFetched">
  35821. <summary>
  35822. Occurs when a message summary is fetched from the folder.
  35823. </summary>
  35824. <remarks>
  35825. <para>Emitted when a message summary is fetched from the folder.</para>
  35826. <para>When multiple message summaries are being fetched from a remote folder,
  35827. it is possible that the connection will drop or some other exception will
  35828. occur, causing the Fetch method to fail, requiring the client to request the
  35829. same set of message summaries again after it reconnects. This is obviously
  35830. inefficient. To alleviate this potential problem, this event will be emitted
  35831. as soon as the <see cref="T:MailKit.IMailFolder"/> successfully retrieves the complete
  35832. <see cref="T:MailKit.IMessageSummary"/> for each requested message.</para>
  35833. <note type="note">The <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  35834. methods will return a list of all message summaries that any information was
  35835. retrieved for, regardless of whether or not all of the requested items were fetched,
  35836. therefore there may be a discrepency between the number of times this event is
  35837. emitetd and the number of summary items returned from the Fetch method.</note>
  35838. </remarks>
  35839. </member>
  35840. <member name="E:MailKit.IMailFolder.MetadataChanged">
  35841. <summary>
  35842. Occurs when metadata changes.
  35843. </summary>
  35844. <remarks>
  35845. The <see cref="E:MailKit.IMailFolder.MetadataChanged"/> event is emitted when metadata changes.
  35846. </remarks>
  35847. </member>
  35848. <member name="E:MailKit.IMailFolder.ModSeqChanged">
  35849. <summary>
  35850. Occurs when the mod-sequence changed on a message.
  35851. </summary>
  35852. <remarks>
  35853. Emitted when the mod-sequence changed on a message.
  35854. </remarks>
  35855. </member>
  35856. <member name="E:MailKit.IMailFolder.HighestModSeqChanged">
  35857. <summary>
  35858. Occurs when the highest mod-sequence changes.
  35859. </summary>
  35860. <remarks>
  35861. The <see cref="E:MailKit.IMailFolder.HighestModSeqChanged"/> event is emitted whenever the <see cref="P:MailKit.IMailFolder.HighestModSeq"/> value changes.
  35862. </remarks>
  35863. </member>
  35864. <member name="E:MailKit.IMailFolder.UidNextChanged">
  35865. <summary>
  35866. Occurs when the next UID changes.
  35867. </summary>
  35868. <remarks>
  35869. Emitted when the <see cref="P:MailKit.IMailFolder.UidNext"/> property changes.
  35870. </remarks>
  35871. </member>
  35872. <member name="E:MailKit.IMailFolder.UidValidityChanged">
  35873. <summary>
  35874. Occurs when the UID validity changes.
  35875. </summary>
  35876. <remarks>
  35877. Emitted when the <see cref="P:MailKit.IMailFolder.UidValidity"/> property changes.
  35878. </remarks>
  35879. </member>
  35880. <member name="E:MailKit.IMailFolder.IdChanged">
  35881. <summary>
  35882. Occurs when the ID changes.
  35883. </summary>
  35884. <remarks>
  35885. Emitted when the <see cref="P:MailKit.IMailFolder.Id"/> property changes.
  35886. </remarks>
  35887. </member>
  35888. <member name="E:MailKit.IMailFolder.SizeChanged">
  35889. <summary>
  35890. Occurs when the size of the folder changes.
  35891. </summary>
  35892. <remarks>
  35893. Emitted when the <see cref="P:MailKit.IMailFolder.Size"/> property changes.
  35894. </remarks>
  35895. </member>
  35896. <member name="E:MailKit.IMailFolder.CountChanged">
  35897. <summary>
  35898. Occurs when the message count changes.
  35899. </summary>
  35900. <remarks>
  35901. Emitted when the <see cref="P:MailKit.IMailFolder.Count"/> property changes.
  35902. </remarks>
  35903. <example>
  35904. <code language="c#" source="Examples\ImapIdleExample.cs"/>
  35905. </example>
  35906. </member>
  35907. <member name="E:MailKit.IMailFolder.RecentChanged">
  35908. <summary>
  35909. Occurs when the recent message count changes.
  35910. </summary>
  35911. <remarks>
  35912. Emitted when the <see cref="P:MailKit.IMailFolder.Recent"/> property changes.
  35913. </remarks>
  35914. </member>
  35915. <member name="E:MailKit.IMailFolder.UnreadChanged">
  35916. <summary>
  35917. Occurs when the message unread count changes.
  35918. </summary>
  35919. <remarks>
  35920. Emitted when the <see cref="P:MailKit.IMailFolder.Unread"/> property changes.
  35921. </remarks>
  35922. </member>
  35923. <member name="T:MailKit.IMailService">
  35924. <summary>
  35925. An interface for message services such as SMTP, POP3, or IMAP.
  35926. </summary>
  35927. <remarks>
  35928. Implemented by <see cref="T:MailKit.Net.Smtp.SmtpClient"/>
  35929. and <see cref="T:MailKit.Net.Pop3.Pop3Client"/>.
  35930. </remarks>
  35931. </member>
  35932. <member name="P:MailKit.IMailService.SyncRoot">
  35933. <summary>
  35934. Gets an object that can be used to synchronize access to the folder.
  35935. </summary>
  35936. <remarks>
  35937. Gets an object that can be used to synchronize access to the folder.
  35938. </remarks>
  35939. <value>The sync root.</value>
  35940. </member>
  35941. <member name="P:MailKit.IMailService.SslProtocols">
  35942. <summary>
  35943. Gets or sets the SSL and TLS protocol versions that the client is allowed to use.
  35944. </summary>
  35945. <remarks>
  35946. <para>Gets or sets the SSL and TLS protocol versions that the client is allowed to use.</para>
  35947. <para>By default, MailKit initializes this value to support only TLS v1.0 and greater and
  35948. does not support any version of SSL due to those protocols no longer being considered
  35949. secure.</para>
  35950. <para>This property should be set before calling any of the
  35951. <a href="Overload_MailKit_IMailService_Connect.htm">Connect</a> methods.</para>
  35952. </remarks>
  35953. <value>The SSL and TLS protocol versions that are supported.</value>
  35954. </member>
  35955. <member name="P:MailKit.IMailService.ClientCertificates">
  35956. <summary>
  35957. Get or set the client SSL certificates.
  35958. </summary>
  35959. <remarks>
  35960. <para>Some servers may require the client SSL certificates in order
  35961. to allow the user to connect.</para>
  35962. <para>This property should be set before calling any of the
  35963. <a href="Overload_MailKit_IMailService_Connect.htm">Connect</a> methods.</para>
  35964. </remarks>
  35965. <value>The client SSL certificates.</value>
  35966. </member>
  35967. <member name="P:MailKit.IMailService.CheckCertificateRevocation">
  35968. <summary>
  35969. Get or set whether connecting via SSL/TLS should check certificate revocation.
  35970. </summary>
  35971. <remarks>
  35972. <para>Gets or sets whether connecting via SSL/TLS should check certificate revocation.</para>
  35973. <para>Normally, the value of this property should be set to <c>true</c> (the default) for security
  35974. reasons, but there are times when it may be necessary to set it to <c>false</c>.</para>
  35975. <para>For example, most Certificate Authorities are probably pretty good at keeping their CRL and/or
  35976. OCSP servers up 24/7, but occasionally they do go down or are otherwise unreachable due to other
  35977. network problems between the client and the Certificate Authority. When this happens, it becomes
  35978. impossible to check the revocation status of one or more of the certificates in the chain
  35979. resulting in an <see cref="T:MailKit.Security.SslHandshakeException"/> being thrown in the
  35980. <a href="Overload_MailKit_IMailService_Connect.htm">Connect</a> method. If this becomes a problem,
  35981. it may become desirable to set <see cref="P:MailKit.IMailService.CheckCertificateRevocation"/> to <c>false</c>.</para>
  35982. </remarks>
  35983. <value><c>true</c> if certificate revocation should be checked; otherwise, <c>false</c>.</value>
  35984. </member>
  35985. <member name="P:MailKit.IMailService.ServerCertificateValidationCallback">
  35986. <summary>
  35987. Get or sets a callback function to validate the server certificate.
  35988. </summary>
  35989. <remarks>
  35990. <para>Gets or sets a callback function to validate the server certificate.</para>
  35991. <para>This property should be set before calling any of the
  35992. <a href="Overload_MailKit_IMailService_Connect.htm">Connect</a> methods.</para>
  35993. </remarks>
  35994. <example>
  35995. <code language="c#" source="Examples\SslCertificateValidation.cs"/>
  35996. </example>
  35997. <value>The server certificate validation callback function.</value>
  35998. </member>
  35999. <member name="P:MailKit.IMailService.LocalEndPoint">
  36000. <summary>
  36001. Get or set the local IP end point to use when connecting to a remote host.
  36002. </summary>
  36003. <remarks>
  36004. Gets or sets the local IP end point to use when connecting to a remote host.
  36005. </remarks>
  36006. <value>The local IP end point or <c>null</c> to use the default end point.</value>
  36007. </member>
  36008. <member name="P:MailKit.IMailService.ProxyClient">
  36009. <summary>
  36010. Get or set the proxy client to use when connecting to a remote host.
  36011. </summary>
  36012. <remarks>
  36013. Gets or sets the proxy client to use when connecting to a remote host via any of the
  36014. <a href="Overload_MailKit_IMailService_Connect.htm">Connect</a> methods.
  36015. </remarks>
  36016. <value>The proxy client.</value>
  36017. </member>
  36018. <member name="P:MailKit.IMailService.AuthenticationMechanisms">
  36019. <summary>
  36020. Get the authentication mechanisms supported by the message service.
  36021. </summary>
  36022. <remarks>
  36023. The authentication mechanisms are queried durring the
  36024. <a href="Overload_MailKit_IMailService_Connect.htm">Connect</a> method.
  36025. </remarks>
  36026. <value>The supported authentication mechanisms.</value>
  36027. </member>
  36028. <member name="P:MailKit.IMailService.IsAuthenticated">
  36029. <summary>
  36030. Get whether or not the client is currently authenticated with the mail server.
  36031. </summary>
  36032. <remarks>
  36033. <para>Gets whether or not the client is currently authenticated with the mail server.</para>
  36034. <para>To authenticate with the mail server, use one of the
  36035. <a href="Overload_MailKit_MailService_Authenticate.htm">Authenticate</a> methods
  36036. or any of the Async alternatives.</para>
  36037. </remarks>
  36038. <value><c>true</c> if the client is authenticated; otherwise, <c>false</c>.</value>
  36039. </member>
  36040. <member name="P:MailKit.IMailService.IsConnected">
  36041. <summary>
  36042. Get whether or not the service is currently connected.
  36043. </summary>
  36044. <remarks>
  36045. <para>The <see cref="P:MailKit.IMailService.IsConnected"/> state is set to <c>true</c> immediately after
  36046. one of the <a href="Overload_MailKit_IMailService_Connect.htm">Connect</a>
  36047. methods succeeds and is not set back to <c>false</c> until either the client
  36048. is disconnected via <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/> or until a
  36049. <see cref="T:MailKit.ProtocolException"/> is thrown while attempting to read or write to
  36050. the underlying network socket.</para>
  36051. <para>When an <see cref="T:MailKit.ProtocolException"/> is caught, the connection state of the
  36052. <see cref="T:MailKit.IMailService"/> should be checked before continuing.</para>
  36053. </remarks>
  36054. <value><c>true</c> if the service connected; otherwise, <c>false</c>.</value>
  36055. </member>
  36056. <member name="P:MailKit.IMailService.IsSecure">
  36057. <summary>
  36058. Get whether or not the connection is secure (typically via SSL or TLS).
  36059. </summary>
  36060. <remarks>
  36061. Gets whether or not the connection is secure (typically via SSL or TLS).
  36062. </remarks>
  36063. <value><c>true</c> if the connection is secure; otherwise, <c>false</c>.</value>
  36064. </member>
  36065. <member name="P:MailKit.IMailService.Timeout">
  36066. <summary>
  36067. Get or set the timeout for network streaming operations, in milliseconds.
  36068. </summary>
  36069. <remarks>
  36070. Gets or sets the underlying socket stream's <see cref="P:System.IO.Stream.ReadTimeout"/>
  36071. and <see cref="P:System.IO.Stream.WriteTimeout"/> values.
  36072. </remarks>
  36073. <value>The timeout in milliseconds.</value>
  36074. </member>
  36075. <member name="M:MailKit.IMailService.Connect(System.String,System.Int32,System.Boolean,System.Threading.CancellationToken)">
  36076. <summary>
  36077. Establish a connection to the specified mail server.
  36078. </summary>
  36079. <remarks>
  36080. <para>Establish a connection to the specified mail server.</para>
  36081. <para>If a successful connection is made, the <see cref="P:MailKit.IMailService.AuthenticationMechanisms"/>
  36082. property will be populated.</para>
  36083. </remarks>
  36084. <param name="host">The host name to connect to.</param>
  36085. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  36086. <param name="useSsl"><value>true</value> if the client should make an SSL-wrapped connection to the server; otherwise, <value>false</value>.</param>
  36087. <param name="cancellationToken">The cancellation token.</param>
  36088. <exception cref="T:System.ArgumentNullException">
  36089. <paramref name="host"/> is <c>null</c>.
  36090. </exception>
  36091. <exception cref="T:System.ArgumentOutOfRangeException">
  36092. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  36093. </exception>
  36094. <exception cref="T:System.ArgumentException">
  36095. The <paramref name="host"/> is a zero-length string.
  36096. </exception>
  36097. <exception cref="T:System.InvalidOperationException">
  36098. The <see cref="T:MailKit.IMailService"/> is already connected.
  36099. </exception>
  36100. <exception cref="T:System.OperationCanceledException">
  36101. The operation was canceled via the cancellation token.
  36102. </exception>
  36103. <exception cref="T:System.IO.IOException">
  36104. An I/O error occurred.
  36105. </exception>
  36106. <exception cref="T:MailKit.CommandException">
  36107. The command was rejected by the mail server.
  36108. </exception>
  36109. <exception cref="T:MailKit.ProtocolException">
  36110. The server responded with an unexpected token.
  36111. </exception>
  36112. </member>
  36113. <member name="M:MailKit.IMailService.ConnectAsync(System.String,System.Int32,System.Boolean,System.Threading.CancellationToken)">
  36114. <summary>
  36115. Asynchronously establish a connection to the specified mail server.
  36116. </summary>
  36117. <remarks>
  36118. <para>Asynchronously establishes a connection to the specified mail server.</para>
  36119. <para>If a successful connection is made, the <see cref="P:MailKit.IMailService.AuthenticationMechanisms"/>
  36120. property will be populated.</para>
  36121. </remarks>
  36122. <returns>An asynchronous task context.</returns>
  36123. <param name="host">The host name to connect to.</param>
  36124. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  36125. <param name="useSsl"><value>true</value> if the client should make an SSL-wrapped connection to the server; otherwise, <value>false</value>.</param>
  36126. <param name="cancellationToken">The cancellation token.</param>
  36127. <exception cref="T:System.ArgumentNullException">
  36128. The <paramref name="host"/> is <c>null</c>.
  36129. </exception>
  36130. <exception cref="T:System.ArgumentOutOfRangeException">
  36131. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  36132. </exception>
  36133. <exception cref="T:System.ArgumentException">
  36134. The <paramref name="host"/> is a zero-length string.
  36135. </exception>
  36136. <exception cref="T:System.ObjectDisposedException">
  36137. The <see cref="T:MailKit.IMailService"/> has been disposed.
  36138. </exception>
  36139. <exception cref="T:System.InvalidOperationException">
  36140. The <see cref="T:MailKit.IMailService"/> is already connected.
  36141. </exception>
  36142. <exception cref="T:System.OperationCanceledException">
  36143. The operation was canceled via the cancellation token.
  36144. </exception>
  36145. <exception cref="T:System.IO.IOException">
  36146. An I/O error occurred.
  36147. </exception>
  36148. <exception cref="T:MailKit.ProtocolException">
  36149. A protocol error occurred.
  36150. </exception>
  36151. </member>
  36152. <member name="M:MailKit.IMailService.Connect(System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  36153. <summary>
  36154. Establish a connection to the specified mail server.
  36155. </summary>
  36156. <remarks>
  36157. <para>Establish a connection to the specified mail server.</para>
  36158. <para>If a successful connection is made, the <see cref="P:MailKit.IMailService.AuthenticationMechanisms"/>
  36159. property will be populated.</para>
  36160. </remarks>
  36161. <param name="host">The host name to connect to.</param>
  36162. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  36163. <param name="options">The secure socket options to when connecting.</param>
  36164. <param name="cancellationToken">The cancellation token.</param>
  36165. <exception cref="T:System.ArgumentNullException">
  36166. <paramref name="host"/> is <c>null</c>.
  36167. </exception>
  36168. <exception cref="T:System.ArgumentOutOfRangeException">
  36169. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  36170. </exception>
  36171. <exception cref="T:System.ArgumentException">
  36172. The <paramref name="host"/> is a zero-length string.
  36173. </exception>
  36174. <exception cref="T:System.InvalidOperationException">
  36175. The <see cref="T:MailKit.IMailService"/> is already connected.
  36176. </exception>
  36177. <exception cref="T:System.OperationCanceledException">
  36178. The operation was canceled via the cancellation token.
  36179. </exception>
  36180. <exception cref="T:System.IO.IOException">
  36181. An I/O error occurred.
  36182. </exception>
  36183. <exception cref="T:MailKit.CommandException">
  36184. The command was rejected by the mail server.
  36185. </exception>
  36186. <exception cref="T:MailKit.ProtocolException">
  36187. The server responded with an unexpected token.
  36188. </exception>
  36189. </member>
  36190. <member name="M:MailKit.IMailService.ConnectAsync(System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  36191. <summary>
  36192. Asynchronously establish a connection to the specified mail server.
  36193. </summary>
  36194. <remarks>
  36195. <para>Asynchronously establishes a connection to the specified mail server.</para>
  36196. <para>If a successful connection is made, the <see cref="P:MailKit.IMailService.AuthenticationMechanisms"/>
  36197. property will be populated.</para>
  36198. </remarks>
  36199. <returns>An asynchronous task context.</returns>
  36200. <param name="host">The host name to connect to.</param>
  36201. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  36202. <param name="options">The secure socket options to when connecting.</param>
  36203. <param name="cancellationToken">The cancellation token.</param>
  36204. <exception cref="T:System.ArgumentNullException">
  36205. The <paramref name="host"/> is <c>null</c>.
  36206. </exception>
  36207. <exception cref="T:System.ArgumentOutOfRangeException">
  36208. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  36209. </exception>
  36210. <exception cref="T:System.ArgumentException">
  36211. The <paramref name="host"/> is a zero-length string.
  36212. </exception>
  36213. <exception cref="T:System.ObjectDisposedException">
  36214. The <see cref="T:MailKit.IMailService"/> has been disposed.
  36215. </exception>
  36216. <exception cref="T:System.InvalidOperationException">
  36217. The <see cref="T:MailKit.IMailService"/> is already connected.
  36218. </exception>
  36219. <exception cref="T:System.OperationCanceledException">
  36220. The operation was canceled via the cancellation token.
  36221. </exception>
  36222. <exception cref="T:System.IO.IOException">
  36223. An I/O error occurred.
  36224. </exception>
  36225. <exception cref="T:MailKit.ProtocolException">
  36226. A protocol error occurred.
  36227. </exception>
  36228. </member>
  36229. <member name="M:MailKit.IMailService.Connect(System.Net.Sockets.Socket,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  36230. <summary>
  36231. Establish a connection to the specified mail server using the provided socket.
  36232. </summary>
  36233. <remarks>
  36234. <para>Establish a connection to the specified mail server using the provided socket.</para>
  36235. <para>If a successful connection is made, the <see cref="P:MailKit.IMailService.AuthenticationMechanisms"/>
  36236. property will be populated.</para>
  36237. </remarks>
  36238. <param name="socket">The socket to use for the connection.</param>
  36239. <param name="host">The host name to connect to.</param>
  36240. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  36241. <param name="options">The secure socket options to when connecting.</param>
  36242. <param name="cancellationToken">The cancellation token.</param>
  36243. <exception cref="T:System.ArgumentNullException">
  36244. <para><paramref name="socket"/> is <c>null</c>.</para>
  36245. <para>-or-</para>
  36246. <para><paramref name="host"/> is <c>null</c>.</para>
  36247. </exception>
  36248. <exception cref="T:System.ArgumentOutOfRangeException">
  36249. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  36250. </exception>
  36251. <exception cref="T:System.ArgumentException">
  36252. <para><paramref name="socket"/> is not connected.</para>
  36253. <para>-or-</para>
  36254. <para>The <paramref name="host"/> is a zero-length string.</para>
  36255. </exception>
  36256. <exception cref="T:System.InvalidOperationException">
  36257. The <see cref="T:MailKit.IMailService"/> is already connected.
  36258. </exception>
  36259. <exception cref="T:System.OperationCanceledException">
  36260. The operation was canceled via the cancellation token.
  36261. </exception>
  36262. <exception cref="T:System.IO.IOException">
  36263. An I/O error occurred.
  36264. </exception>
  36265. <exception cref="T:MailKit.CommandException">
  36266. The command was rejected by the mail server.
  36267. </exception>
  36268. <exception cref="T:MailKit.ProtocolException">
  36269. The server responded with an unexpected token.
  36270. </exception>
  36271. </member>
  36272. <member name="M:MailKit.IMailService.ConnectAsync(System.Net.Sockets.Socket,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  36273. <summary>
  36274. Asynchronously establish a connection to the specified mail server using the provided socket.
  36275. </summary>
  36276. <remarks>
  36277. <para>Asynchronously establishes a connection to the specified mail server using the provided socket.</para>
  36278. <para>If a successful connection is made, the <see cref="P:MailKit.IMailService.AuthenticationMechanisms"/>
  36279. property will be populated.</para>
  36280. </remarks>
  36281. <returns>An asynchronous task context.</returns>
  36282. <param name="socket">The socket to use for the connection.</param>
  36283. <param name="host">The host name to connect to.</param>
  36284. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  36285. <param name="options">The secure socket options to when connecting.</param>
  36286. <param name="cancellationToken">The cancellation token.</param>
  36287. <exception cref="T:System.ArgumentNullException">
  36288. <para><paramref name="socket"/> is <c>null</c>.</para>
  36289. <para>-or-</para>
  36290. <para><paramref name="host"/> is <c>null</c>.</para>
  36291. </exception>
  36292. <exception cref="T:System.ArgumentOutOfRangeException">
  36293. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  36294. </exception>
  36295. <exception cref="T:System.ArgumentException">
  36296. <para><paramref name="socket"/> is not connected.</para>
  36297. <para>-or-</para>
  36298. <para>The <paramref name="host"/> is a zero-length string.</para>
  36299. </exception>
  36300. <exception cref="T:System.InvalidOperationException">
  36301. The <see cref="T:MailKit.IMailService"/> is already connected.
  36302. </exception>
  36303. <exception cref="T:System.OperationCanceledException">
  36304. The operation was canceled via the cancellation token.
  36305. </exception>
  36306. <exception cref="T:System.IO.IOException">
  36307. An I/O error occurred.
  36308. </exception>
  36309. <exception cref="T:MailKit.CommandException">
  36310. The command was rejected by the mail server.
  36311. </exception>
  36312. <exception cref="T:MailKit.ProtocolException">
  36313. The server responded with an unexpected token.
  36314. </exception>
  36315. </member>
  36316. <member name="M:MailKit.IMailService.Connect(System.IO.Stream,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  36317. <summary>
  36318. Establish a connection to the specified mail server using the provided stream.
  36319. </summary>
  36320. <remarks>
  36321. <para>Establish a connection to the specified mail server using the provided stream.</para>
  36322. <para>If a successful connection is made, the <see cref="P:MailKit.IMailService.AuthenticationMechanisms"/>
  36323. property will be populated.</para>
  36324. </remarks>
  36325. <param name="stream">The stream to use for the connection.</param>
  36326. <param name="host">The host name to connect to.</param>
  36327. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  36328. <param name="options">The secure socket options to when connecting.</param>
  36329. <param name="cancellationToken">The cancellation token.</param>
  36330. <exception cref="T:System.ArgumentNullException">
  36331. <para><paramref name="stream"/> is <c>null</c>.</para>
  36332. <para>-or-</para>
  36333. <para><paramref name="host"/> is <c>null</c>.</para>
  36334. </exception>
  36335. <exception cref="T:System.ArgumentOutOfRangeException">
  36336. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  36337. </exception>
  36338. <exception cref="T:System.ArgumentException">
  36339. The <paramref name="host"/> is a zero-length string.
  36340. </exception>
  36341. <exception cref="T:System.InvalidOperationException">
  36342. The <see cref="T:MailKit.IMailService"/> is already connected.
  36343. </exception>
  36344. <exception cref="T:System.OperationCanceledException">
  36345. The operation was canceled via the cancellation token.
  36346. </exception>
  36347. <exception cref="T:System.IO.IOException">
  36348. An I/O error occurred.
  36349. </exception>
  36350. <exception cref="T:MailKit.CommandException">
  36351. The command was rejected by the mail server.
  36352. </exception>
  36353. <exception cref="T:MailKit.ProtocolException">
  36354. The server responded with an unexpected token.
  36355. </exception>
  36356. </member>
  36357. <member name="M:MailKit.IMailService.ConnectAsync(System.IO.Stream,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  36358. <summary>
  36359. Asynchronously establish a connection to the specified mail server using the provided stream.
  36360. </summary>
  36361. <remarks>
  36362. <para>Asynchronously establishes a connection to the specified mail server using the provided stream.</para>
  36363. <para>If a successful connection is made, the <see cref="P:MailKit.IMailService.AuthenticationMechanisms"/>
  36364. property will be populated.</para>
  36365. </remarks>
  36366. <returns>An asynchronous task context.</returns>
  36367. <param name="stream">The stream to use for the connection.</param>
  36368. <param name="host">The host name to connect to.</param>
  36369. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  36370. <param name="options">The secure socket options to when connecting.</param>
  36371. <param name="cancellationToken">The cancellation token.</param>
  36372. <exception cref="T:System.ArgumentNullException">
  36373. <para><paramref name="stream"/> is <c>null</c>.</para>
  36374. <para>-or-</para>
  36375. <para><paramref name="host"/> is <c>null</c>.</para>
  36376. </exception>
  36377. <exception cref="T:System.ArgumentOutOfRangeException">
  36378. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  36379. </exception>
  36380. <exception cref="T:System.ArgumentException">
  36381. The <paramref name="host"/> is a zero-length string.
  36382. </exception>
  36383. <exception cref="T:System.InvalidOperationException">
  36384. The <see cref="T:MailKit.IMailService"/> is already connected.
  36385. </exception>
  36386. <exception cref="T:System.OperationCanceledException">
  36387. The operation was canceled via the cancellation token.
  36388. </exception>
  36389. <exception cref="T:System.IO.IOException">
  36390. An I/O error occurred.
  36391. </exception>
  36392. <exception cref="T:MailKit.CommandException">
  36393. The command was rejected by the mail server.
  36394. </exception>
  36395. <exception cref="T:MailKit.ProtocolException">
  36396. The server responded with an unexpected token.
  36397. </exception>
  36398. </member>
  36399. <member name="M:MailKit.IMailService.Authenticate(System.Net.ICredentials,System.Threading.CancellationToken)">
  36400. <summary>
  36401. Authenticate using the supplied credentials.
  36402. </summary>
  36403. <remarks>
  36404. <para>Authenticates using the supplied credentials.</para>
  36405. <para>If the server supports one or more SASL authentication mechanisms, then
  36406. the SASL mechanisms that both the client and server support are tried
  36407. in order of greatest security to weakest security. Once a SASL
  36408. authentication mechanism is found that both client and server support,
  36409. the credentials are used to authenticate.</para>
  36410. <para>If the server does not support SASL or if no common SASL mechanisms
  36411. can be found, then the default login command is used as a fallback.</para>
  36412. </remarks>
  36413. <param name="credentials">The user's credentials.</param>
  36414. <param name="cancellationToken">The cancellation token.</param>
  36415. <exception cref="T:System.ArgumentNullException">
  36416. <paramref name="credentials"/> is <c>null</c>.
  36417. </exception>
  36418. <exception cref="T:System.ObjectDisposedException">
  36419. The <see cref="T:MailKit.IMailService"/> has been disposed.
  36420. </exception>
  36421. <exception cref="T:MailKit.ServiceNotConnectedException">
  36422. The <see cref="T:MailKit.IMailService"/> is not connected.
  36423. </exception>
  36424. <exception cref="T:System.InvalidOperationException">
  36425. The <see cref="T:MailKit.IMailService"/> is already authenticated.
  36426. </exception>
  36427. <exception cref="T:System.OperationCanceledException">
  36428. The operation was canceled via the cancellation token.
  36429. </exception>
  36430. <exception cref="T:MailKit.Security.AuthenticationException">
  36431. Authentication using the supplied credentials has failed.
  36432. </exception>
  36433. <exception cref="T:MailKit.Security.SaslException">
  36434. A SASL authentication error occurred.
  36435. </exception>
  36436. <exception cref="T:System.IO.IOException">
  36437. An I/O error occurred.
  36438. </exception>
  36439. <exception cref="T:MailKit.ProtocolException">
  36440. A protocol error occurred.
  36441. </exception>
  36442. </member>
  36443. <member name="M:MailKit.IMailService.AuthenticateAsync(System.Net.ICredentials,System.Threading.CancellationToken)">
  36444. <summary>
  36445. Asynchronously authenticate using the supplied credentials.
  36446. </summary>
  36447. <remarks>
  36448. <para>Asynchronously authenticates using the supplied credentials.</para>
  36449. <para>If the server supports one or more SASL authentication mechanisms, then
  36450. the SASL mechanisms that both the client and server support are tried
  36451. in order of greatest security to weakest security. Once a SASL
  36452. authentication mechanism is found that both client and server support,
  36453. the credentials are used to authenticate.</para>
  36454. <para>If the server does not support SASL or if no common SASL mechanisms
  36455. can be found, then the default login command is used as a fallback.</para>
  36456. </remarks>
  36457. <returns>An asynchronous task context.</returns>
  36458. <param name="credentials">The user's credentials.</param>
  36459. <param name="cancellationToken">The cancellation token.</param>
  36460. <exception cref="T:System.ArgumentNullException">
  36461. <paramref name="credentials"/> is <c>null</c>.
  36462. </exception>
  36463. <exception cref="T:System.ObjectDisposedException">
  36464. The <see cref="T:MailKit.IMailService"/> has been disposed.
  36465. </exception>
  36466. <exception cref="T:MailKit.ServiceNotConnectedException">
  36467. The <see cref="T:MailKit.IMailService"/> is not connected.
  36468. </exception>
  36469. <exception cref="T:System.InvalidOperationException">
  36470. The <see cref="T:MailKit.IMailService"/> is already authenticated.
  36471. </exception>
  36472. <exception cref="T:System.OperationCanceledException">
  36473. The operation was canceled via the cancellation token.
  36474. </exception>
  36475. <exception cref="T:MailKit.Security.AuthenticationException">
  36476. Authentication using the supplied credentials has failed.
  36477. </exception>
  36478. <exception cref="T:MailKit.Security.SaslException">
  36479. A SASL authentication error occurred.
  36480. </exception>
  36481. <exception cref="T:System.IO.IOException">
  36482. An I/O error occurred.
  36483. </exception>
  36484. <exception cref="T:MailKit.ProtocolException">
  36485. A protocol error occurred.
  36486. </exception>
  36487. </member>
  36488. <member name="M:MailKit.IMailService.Authenticate(System.Text.Encoding,System.Net.ICredentials,System.Threading.CancellationToken)">
  36489. <summary>
  36490. Authenticate using the supplied credentials.
  36491. </summary>
  36492. <remarks>
  36493. <para>Authenticates using the supplied credentials.</para>
  36494. <para>If the server supports one or more SASL authentication mechanisms, then
  36495. the SASL mechanisms that both the client and server support are tried
  36496. in order of greatest security to weakest security. Once a SASL
  36497. authentication mechanism is found that both client and server support,
  36498. the credentials are used to authenticate.</para>
  36499. <para>If the server does not support SASL or if no common SASL mechanisms
  36500. can be found, then the default login command is used as a fallback.</para>
  36501. </remarks>
  36502. <param name="encoding">The encoding to use for the user's credentials.</param>
  36503. <param name="credentials">The user's credentials.</param>
  36504. <param name="cancellationToken">The cancellation token.</param>
  36505. <exception cref="T:System.ArgumentNullException">
  36506. <para><paramref name="encoding"/> is <c>null</c>.</para>
  36507. <para>-or-</para>
  36508. <para><paramref name="credentials"/> is <c>null</c>.</para>
  36509. </exception>
  36510. <exception cref="T:System.ObjectDisposedException">
  36511. The <see cref="T:MailKit.IMailService"/> has been disposed.
  36512. </exception>
  36513. <exception cref="T:MailKit.ServiceNotConnectedException">
  36514. The <see cref="T:MailKit.IMailService"/> is not connected.
  36515. </exception>
  36516. <exception cref="T:System.InvalidOperationException">
  36517. The <see cref="T:MailKit.IMailService"/> is already authenticated.
  36518. </exception>
  36519. <exception cref="T:System.OperationCanceledException">
  36520. The operation was canceled via the cancellation token.
  36521. </exception>
  36522. <exception cref="T:MailKit.Security.AuthenticationException">
  36523. Authentication using the supplied credentials has failed.
  36524. </exception>
  36525. <exception cref="T:MailKit.Security.SaslException">
  36526. A SASL authentication error occurred.
  36527. </exception>
  36528. <exception cref="T:System.IO.IOException">
  36529. An I/O error occurred.
  36530. </exception>
  36531. <exception cref="T:MailKit.ProtocolException">
  36532. A protocol error occurred.
  36533. </exception>
  36534. </member>
  36535. <member name="M:MailKit.IMailService.AuthenticateAsync(System.Text.Encoding,System.Net.ICredentials,System.Threading.CancellationToken)">
  36536. <summary>
  36537. Asynchronously authenticate using the supplied credentials.
  36538. </summary>
  36539. <remarks>
  36540. <para>Asynchronously authenticates using the supplied credentials.</para>
  36541. <para>If the server supports one or more SASL authentication mechanisms, then
  36542. the SASL mechanisms that both the client and server support are tried
  36543. in order of greatest security to weakest security. Once a SASL
  36544. authentication mechanism is found that both client and server support,
  36545. the credentials are used to authenticate.</para>
  36546. <para>If the server does not support SASL or if no common SASL mechanisms
  36547. can be found, then the default login command is used as a fallback.</para>
  36548. </remarks>
  36549. <returns>An asynchronous task context.</returns>
  36550. <param name="encoding">The encoding to use for the user's credentials.</param>
  36551. <param name="credentials">The user's credentials.</param>
  36552. <param name="cancellationToken">The cancellation token.</param>
  36553. <exception cref="T:System.ArgumentNullException">
  36554. <para><paramref name="encoding"/> is <c>null</c>.</para>
  36555. <para>-or-</para>
  36556. <para><paramref name="credentials"/> is <c>null</c>.</para>
  36557. </exception>
  36558. <exception cref="T:System.ObjectDisposedException">
  36559. The <see cref="T:MailKit.IMailService"/> has been disposed.
  36560. </exception>
  36561. <exception cref="T:MailKit.ServiceNotConnectedException">
  36562. The <see cref="T:MailKit.IMailService"/> is not connected.
  36563. </exception>
  36564. <exception cref="T:System.InvalidOperationException">
  36565. The <see cref="T:MailKit.IMailService"/> is already authenticated.
  36566. </exception>
  36567. <exception cref="T:System.OperationCanceledException">
  36568. The operation was canceled via the cancellation token.
  36569. </exception>
  36570. <exception cref="T:MailKit.Security.AuthenticationException">
  36571. Authentication using the supplied credentials has failed.
  36572. </exception>
  36573. <exception cref="T:MailKit.Security.SaslException">
  36574. A SASL authentication error occurred.
  36575. </exception>
  36576. <exception cref="T:System.IO.IOException">
  36577. An I/O error occurred.
  36578. </exception>
  36579. <exception cref="T:MailKit.ProtocolException">
  36580. A protocol error occurred.
  36581. </exception>
  36582. </member>
  36583. <member name="M:MailKit.IMailService.Authenticate(System.Text.Encoding,System.String,System.String,System.Threading.CancellationToken)">
  36584. <summary>
  36585. Authenticate using the specified user name and password.
  36586. </summary>
  36587. <remarks>
  36588. <para>If the server supports one or more SASL authentication mechanisms,
  36589. then the SASL mechanisms that both the client and server support are tried
  36590. in order of greatest security to weakest security. Once a SASL
  36591. authentication mechanism is found that both client and server support,
  36592. the credentials are used to authenticate.</para>
  36593. <para>If the server does not support SASL or if no common SASL mechanisms
  36594. can be found, then the default login command is used as a fallback.</para>
  36595. <note type="tip">To prevent the usage of certain authentication mechanisms,
  36596. simply remove them from the <see cref="P:MailKit.IMailService.AuthenticationMechanisms"/> hash set
  36597. before calling this method.</note>
  36598. </remarks>
  36599. <param name="encoding">The encoding to use for the user's credentials.</param>
  36600. <param name="userName">The user name.</param>
  36601. <param name="password">The password.</param>
  36602. <param name="cancellationToken">The cancellation token.</param>
  36603. <exception cref="T:System.ArgumentNullException">
  36604. <para><paramref name="encoding"/> is <c>null</c>.</para>
  36605. <para>-or-</para>
  36606. <para><paramref name="userName"/> is <c>null</c>.</para>
  36607. <para>-or-</para>
  36608. <para><paramref name="password"/> is <c>null</c>.</para>
  36609. </exception>
  36610. <exception cref="T:System.ObjectDisposedException">
  36611. The <see cref="T:MailKit.MailService"/> has been disposed.
  36612. </exception>
  36613. <exception cref="T:System.InvalidOperationException">
  36614. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  36615. </exception>
  36616. <exception cref="T:System.OperationCanceledException">
  36617. The operation was canceled via the cancellation token.
  36618. </exception>
  36619. <exception cref="T:MailKit.Security.AuthenticationException">
  36620. Authentication using the supplied credentials has failed.
  36621. </exception>
  36622. <exception cref="T:MailKit.Security.SaslException">
  36623. A SASL authentication error occurred.
  36624. </exception>
  36625. <exception cref="T:System.IO.IOException">
  36626. An I/O error occurred.
  36627. </exception>
  36628. <exception cref="T:MailKit.ProtocolException">
  36629. A protocol error occurred.
  36630. </exception>
  36631. </member>
  36632. <member name="M:MailKit.IMailService.AuthenticateAsync(System.Text.Encoding,System.String,System.String,System.Threading.CancellationToken)">
  36633. <summary>
  36634. Asynchronously authenticate using the specified user name and password.
  36635. </summary>
  36636. <remarks>
  36637. <para>If the server supports one or more SASL authentication mechanisms,
  36638. then the SASL mechanisms that both the client and server support are tried
  36639. in order of greatest security to weakest security. Once a SASL
  36640. authentication mechanism is found that both client and server support,
  36641. the credentials are used to authenticate.</para>
  36642. <para>If the server does not support SASL or if no common SASL mechanisms
  36643. can be found, then the default login command is used as a fallback.</para>
  36644. <note type="tip">To prevent the usage of certain authentication mechanisms,
  36645. simply remove them from the <see cref="P:MailKit.IMailService.AuthenticationMechanisms"/> hash set
  36646. before calling this method.</note>
  36647. </remarks>
  36648. <returns>An asynchronous task context.</returns>
  36649. <param name="encoding">The encoding to use for the user's credentials.</param>
  36650. <param name="userName">The user name.</param>
  36651. <param name="password">The password.</param>
  36652. <param name="cancellationToken">The cancellation token.</param>
  36653. <exception cref="T:System.ArgumentNullException">
  36654. <para><paramref name="encoding"/> is <c>null</c>.</para>
  36655. <para>-or-</para>
  36656. <para><paramref name="userName"/> is <c>null</c>.</para>
  36657. <para>-or-</para>
  36658. <para><paramref name="password"/> is <c>null</c>.</para>
  36659. </exception>
  36660. <exception cref="T:System.ObjectDisposedException">
  36661. The <see cref="T:MailKit.MailService"/> has been disposed.
  36662. </exception>
  36663. <exception cref="T:System.InvalidOperationException">
  36664. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  36665. </exception>
  36666. <exception cref="T:System.OperationCanceledException">
  36667. The operation was canceled via the cancellation token.
  36668. </exception>
  36669. <exception cref="T:MailKit.Security.AuthenticationException">
  36670. Authentication using the supplied credentials has failed.
  36671. </exception>
  36672. <exception cref="T:MailKit.Security.SaslException">
  36673. A SASL authentication error occurred.
  36674. </exception>
  36675. <exception cref="T:System.IO.IOException">
  36676. An I/O error occurred.
  36677. </exception>
  36678. <exception cref="T:MailKit.ProtocolException">
  36679. A protocol error occurred.
  36680. </exception>
  36681. </member>
  36682. <member name="M:MailKit.IMailService.Authenticate(System.String,System.String,System.Threading.CancellationToken)">
  36683. <summary>
  36684. Authenticate using the specified user name and password.
  36685. </summary>
  36686. <remarks>
  36687. <para>If the server supports one or more SASL authentication mechanisms,
  36688. then the SASL mechanisms that both the client and server support are tried
  36689. in order of greatest security to weakest security. Once a SASL
  36690. authentication mechanism is found that both client and server support,
  36691. the credentials are used to authenticate.</para>
  36692. <para>If the server does not support SASL or if no common SASL mechanisms
  36693. can be found, then the default login command is used as a fallback.</para>
  36694. <note type="tip">To prevent the usage of certain authentication mechanisms,
  36695. simply remove them from the <see cref="P:MailKit.IMailService.AuthenticationMechanisms"/> hash set
  36696. before calling this method.</note>
  36697. </remarks>
  36698. <example>
  36699. <code language="c#" source="Examples\SmtpExamples.cs" region="SendMessage"/>
  36700. </example>
  36701. <param name="userName">The user name.</param>
  36702. <param name="password">The password.</param>
  36703. <param name="cancellationToken">The cancellation token.</param>
  36704. <exception cref="T:System.ArgumentNullException">
  36705. <para><paramref name="userName"/> is <c>null</c>.</para>
  36706. <para>-or-</para>
  36707. <para><paramref name="password"/> is <c>null</c>.</para>
  36708. </exception>
  36709. <exception cref="T:System.ObjectDisposedException">
  36710. The <see cref="T:MailKit.MailService"/> has been disposed.
  36711. </exception>
  36712. <exception cref="T:System.InvalidOperationException">
  36713. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  36714. </exception>
  36715. <exception cref="T:System.OperationCanceledException">
  36716. The operation was canceled via the cancellation token.
  36717. </exception>
  36718. <exception cref="T:MailKit.Security.AuthenticationException">
  36719. Authentication using the supplied credentials has failed.
  36720. </exception>
  36721. <exception cref="T:MailKit.Security.SaslException">
  36722. A SASL authentication error occurred.
  36723. </exception>
  36724. <exception cref="T:System.IO.IOException">
  36725. An I/O error occurred.
  36726. </exception>
  36727. <exception cref="T:MailKit.ProtocolException">
  36728. A protocol error occurred.
  36729. </exception>
  36730. </member>
  36731. <member name="M:MailKit.IMailService.AuthenticateAsync(System.String,System.String,System.Threading.CancellationToken)">
  36732. <summary>
  36733. Asynchronously authenticate using the specified user name and password.
  36734. </summary>
  36735. <remarks>
  36736. <para>If the server supports one or more SASL authentication mechanisms,
  36737. then the SASL mechanisms that both the client and server support are tried
  36738. in order of greatest security to weakest security. Once a SASL
  36739. authentication mechanism is found that both client and server support,
  36740. the credentials are used to authenticate.</para>
  36741. <para>If the server does not support SASL or if no common SASL mechanisms
  36742. can be found, then the default login command is used as a fallback.</para>
  36743. <note type="tip">To prevent the usage of certain authentication mechanisms,
  36744. simply remove them from the <see cref="P:MailKit.IMailService.AuthenticationMechanisms"/> hash set
  36745. before calling this method.</note>
  36746. </remarks>
  36747. <returns>An asynchronous task context.</returns>
  36748. <param name="userName">The user name.</param>
  36749. <param name="password">The password.</param>
  36750. <param name="cancellationToken">The cancellation token.</param>
  36751. <exception cref="T:System.ArgumentNullException">
  36752. <para><paramref name="userName"/> is <c>null</c>.</para>
  36753. <para>-or-</para>
  36754. <para><paramref name="password"/> is <c>null</c>.</para>
  36755. </exception>
  36756. <exception cref="T:System.ObjectDisposedException">
  36757. The <see cref="T:MailKit.MailService"/> has been disposed.
  36758. </exception>
  36759. <exception cref="T:System.InvalidOperationException">
  36760. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  36761. </exception>
  36762. <exception cref="T:System.OperationCanceledException">
  36763. The operation was canceled via the cancellation token.
  36764. </exception>
  36765. <exception cref="T:MailKit.Security.AuthenticationException">
  36766. Authentication using the supplied credentials has failed.
  36767. </exception>
  36768. <exception cref="T:MailKit.Security.SaslException">
  36769. A SASL authentication error occurred.
  36770. </exception>
  36771. <exception cref="T:System.IO.IOException">
  36772. An I/O error occurred.
  36773. </exception>
  36774. <exception cref="T:MailKit.ProtocolException">
  36775. A protocol error occurred.
  36776. </exception>
  36777. </member>
  36778. <member name="M:MailKit.IMailService.Authenticate(MailKit.Security.SaslMechanism,System.Threading.CancellationToken)">
  36779. <summary>
  36780. Authenticate using the specified SASL mechanism.
  36781. </summary>
  36782. <remarks>
  36783. <para>Authenticates using the specified SASL mechanism.</para>
  36784. <para>For a list of available SASL authentication mechanisms supported by the server,
  36785. check the <see cref="P:MailKit.IMailService.AuthenticationMechanisms"/> property after the service has been
  36786. connected.</para>
  36787. </remarks>
  36788. <param name="mechanism">The SASL mechanism.</param>
  36789. <param name="cancellationToken">The cancellation token.</param>
  36790. <exception cref="T:System.ArgumentNullException">
  36791. <paramref name="mechanism"/> is <c>null</c>.
  36792. </exception>
  36793. <exception cref="T:System.ObjectDisposedException">
  36794. The <see cref="T:MailKit.MailService"/> has been disposed.
  36795. </exception>
  36796. <exception cref="T:System.InvalidOperationException">
  36797. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  36798. </exception>
  36799. <exception cref="T:System.OperationCanceledException">
  36800. The operation was canceled via the cancellation token.
  36801. </exception>
  36802. <exception cref="T:MailKit.Security.AuthenticationException">
  36803. Authentication using the supplied credentials has failed.
  36804. </exception>
  36805. <exception cref="T:MailKit.Security.SaslException">
  36806. A SASL authentication error occurred.
  36807. </exception>
  36808. <exception cref="T:System.IO.IOException">
  36809. An I/O error occurred.
  36810. </exception>
  36811. <exception cref="T:MailKit.ProtocolException">
  36812. A protocol error occurred.
  36813. </exception>
  36814. </member>
  36815. <member name="M:MailKit.IMailService.AuthenticateAsync(MailKit.Security.SaslMechanism,System.Threading.CancellationToken)">
  36816. <summary>
  36817. Asynchronously authenticate using the specified SASL mechanism.
  36818. </summary>
  36819. <remarks>
  36820. <para>Authenticates using the specified SASL mechanism.</para>
  36821. <para>For a list of available SASL authentication mechanisms supported by the server,
  36822. check the <see cref="P:MailKit.IMailService.AuthenticationMechanisms"/> property after the service has been
  36823. connected.</para>
  36824. </remarks>
  36825. <returns>An asynchronous task context.</returns>
  36826. <param name="mechanism">The SASL mechanism.</param>
  36827. <param name="cancellationToken">The cancellation token.</param>
  36828. <exception cref="T:System.ArgumentNullException">
  36829. <paramref name="mechanism"/> is <c>null</c>.
  36830. </exception>
  36831. <exception cref="T:System.ObjectDisposedException">
  36832. The <see cref="T:MailKit.MailService"/> has been disposed.
  36833. </exception>
  36834. <exception cref="T:System.InvalidOperationException">
  36835. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  36836. </exception>
  36837. <exception cref="T:System.OperationCanceledException">
  36838. The operation was canceled via the cancellation token.
  36839. </exception>
  36840. <exception cref="T:MailKit.Security.AuthenticationException">
  36841. Authentication using the supplied credentials has failed.
  36842. </exception>
  36843. <exception cref="T:MailKit.Security.SaslException">
  36844. A SASL authentication error occurred.
  36845. </exception>
  36846. <exception cref="T:System.IO.IOException">
  36847. An I/O error occurred.
  36848. </exception>
  36849. <exception cref="T:MailKit.ProtocolException">
  36850. A protocol error occurred.
  36851. </exception>
  36852. </member>
  36853. <member name="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)">
  36854. <summary>
  36855. Disconnect the service.
  36856. </summary>
  36857. <remarks>
  36858. <para>Disconnects from the service.</para>
  36859. <para>If <paramref name="quit"/> is <c>true</c>, a "QUIT" command will be issued in order to disconnect cleanly.</para>
  36860. </remarks>
  36861. <param name="quit">If set to <c>true</c>, a "QUIT" command will be issued in order to disconnect cleanly.</param>
  36862. <param name="cancellationToken">The cancellation token.</param>
  36863. <exception cref="T:System.ObjectDisposedException">
  36864. The <see cref="T:MailKit.IMailService"/> has been disposed.
  36865. </exception>
  36866. <exception cref="T:MailKit.ServiceNotConnectedException">
  36867. The <see cref="T:MailKit.IMailService"/> is not connected.
  36868. </exception>
  36869. <exception cref="T:System.OperationCanceledException">
  36870. The operation was canceled via the cancellation token.
  36871. </exception>
  36872. <exception cref="T:System.IO.IOException">
  36873. An I/O error occurred.
  36874. </exception>
  36875. <exception cref="T:MailKit.CommandException">
  36876. The command was rejected by the mail server.
  36877. </exception>
  36878. <exception cref="T:MailKit.ProtocolException">
  36879. The server responded with an unexpected token.
  36880. </exception>
  36881. </member>
  36882. <member name="M:MailKit.IMailService.DisconnectAsync(System.Boolean,System.Threading.CancellationToken)">
  36883. <summary>
  36884. Asynchronously disconnect the service.
  36885. </summary>
  36886. <remarks>
  36887. <para>Asynchronously disconnects from the service.</para>
  36888. <para>If <paramref name="quit"/> is <c>true</c>, a "QUIT" command will be issued in order to disconnect cleanly.</para>
  36889. </remarks>
  36890. <returns>An asynchronous task context.</returns>
  36891. <param name="quit">If set to <c>true</c>, a logout/quit command will be issued in order to disconnect cleanly.</param>
  36892. <param name="cancellationToken">The cancellation token.</param>
  36893. <exception cref="T:System.ObjectDisposedException">
  36894. The <see cref="T:MailKit.IMailService"/> has been disposed.
  36895. </exception>
  36896. <exception cref="T:MailKit.ServiceNotConnectedException">
  36897. The <see cref="T:MailKit.IMailService"/> is not connected.
  36898. </exception>
  36899. <exception cref="T:System.OperationCanceledException">
  36900. The operation was canceled via the cancellation token.
  36901. </exception>
  36902. <exception cref="T:System.IO.IOException">
  36903. An I/O error occurred.
  36904. </exception>
  36905. <exception cref="T:MailKit.CommandException">
  36906. The command was rejected by the mail server.
  36907. </exception>
  36908. <exception cref="T:MailKit.ProtocolException">
  36909. The server responded with an unexpected token.
  36910. </exception>
  36911. </member>
  36912. <member name="M:MailKit.IMailService.NoOp(System.Threading.CancellationToken)">
  36913. <summary>
  36914. Ping the message service to keep the connection alive.
  36915. </summary>
  36916. <remarks>
  36917. Mail servers, if left idle for too long, will automatically drop the connection.
  36918. </remarks>
  36919. <param name="cancellationToken">The cancellation token.</param>
  36920. <exception cref="T:System.ObjectDisposedException">
  36921. The <see cref="T:MailKit.IMailService"/> has been disposed.
  36922. </exception>
  36923. <exception cref="T:MailKit.ServiceNotConnectedException">
  36924. The <see cref="T:MailKit.IMailService"/> is not connected.
  36925. </exception>
  36926. <exception cref="T:System.OperationCanceledException">
  36927. The operation was canceled via the cancellation token.
  36928. </exception>
  36929. <exception cref="T:System.IO.IOException">
  36930. An I/O error occurred.
  36931. </exception>
  36932. <exception cref="T:MailKit.CommandException">
  36933. The command was rejected by the mail server.
  36934. </exception>
  36935. <exception cref="T:MailKit.ProtocolException">
  36936. The server responded with an unexpected token.
  36937. </exception>
  36938. </member>
  36939. <member name="M:MailKit.IMailService.NoOpAsync(System.Threading.CancellationToken)">
  36940. <summary>
  36941. Asynchronously ping the mail server to keep the connection alive.
  36942. </summary>
  36943. <remarks>
  36944. Mail servers, if left idle for too long, will automatically drop the connection.
  36945. </remarks>
  36946. <returns>An asynchronous task context.</returns>
  36947. <param name="cancellationToken">The cancellation token.</param>
  36948. <exception cref="T:System.ObjectDisposedException">
  36949. The <see cref="T:MailKit.IMailService"/> has been disposed.
  36950. </exception>
  36951. <exception cref="T:MailKit.ServiceNotConnectedException">
  36952. The <see cref="T:MailKit.IMailService"/> is not connected.
  36953. </exception>
  36954. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  36955. The <see cref="T:MailKit.IMailService"/> is not authenticated.
  36956. </exception>
  36957. <exception cref="T:System.OperationCanceledException">
  36958. The operation was canceled via the cancellation token.
  36959. </exception>
  36960. <exception cref="T:System.IO.IOException">
  36961. An I/O error occurred.
  36962. </exception>
  36963. <exception cref="T:MailKit.CommandException">
  36964. The command was rejected by the mail server.
  36965. </exception>
  36966. <exception cref="T:MailKit.ProtocolException">
  36967. The server responded with an unexpected token.
  36968. </exception>
  36969. </member>
  36970. <member name="E:MailKit.IMailService.Connected">
  36971. <summary>
  36972. Occurs when the client has been successfully connected.
  36973. </summary>
  36974. <remarks>
  36975. The <see cref="E:MailKit.IMailService.Connected"/> event is raised when the client
  36976. successfully connects to the mail server.
  36977. </remarks>
  36978. </member>
  36979. <member name="E:MailKit.IMailService.Disconnected">
  36980. <summary>
  36981. Occurs when the client has been disconnected.
  36982. </summary>
  36983. <remarks>
  36984. The <see cref="E:MailKit.IMailService.Disconnected"/> event is raised whenever the client
  36985. has been disconnected.
  36986. </remarks>
  36987. </member>
  36988. <member name="E:MailKit.IMailService.Authenticated">
  36989. <summary>
  36990. Occurs when the client has been successfully authenticated.
  36991. </summary>
  36992. <remarks>
  36993. The <see cref="E:MailKit.IMailService.Authenticated"/> event is raised whenever the client
  36994. has been authenticated.
  36995. </remarks>
  36996. </member>
  36997. <member name="T:MailKit.IMailSpool">
  36998. <summary>
  36999. An interface for retreiving messages from a spool.
  37000. </summary>
  37001. <remarks>
  37002. An interface for retreiving messages from a spool.
  37003. </remarks>
  37004. </member>
  37005. <member name="P:MailKit.IMailSpool.Count">
  37006. <summary>
  37007. Get the number of messages available in the message spool.
  37008. </summary>
  37009. <remarks>
  37010. <para>Gets the number of messages available in the message spool.</para>
  37011. <para>Once authenticated, the <see cref="P:MailKit.IMailSpool.Count"/> property will be set
  37012. to the number of available messages in the spool.</para>
  37013. </remarks>
  37014. <value>The message count.</value>
  37015. </member>
  37016. <member name="P:MailKit.IMailSpool.SupportsUids">
  37017. <summary>
  37018. Get whether or not the service supports referencing messages by UIDs.
  37019. </summary>
  37020. <remarks>
  37021. <para>Not all servers support referencing messages by UID, so this property should
  37022. be checked before using <see cref="M:MailKit.IMailSpool.GetMessageUid(System.Int32,System.Threading.CancellationToken)"/>
  37023. and <see cref="M:MailKit.IMailSpool.GetMessageUids(System.Threading.CancellationToken)"/>.</para>
  37024. <para>If the server does not support UIDs, then all methods that take UID arguments
  37025. along with <see cref="M:MailKit.IMailSpool.GetMessageUid(System.Int32,System.Threading.CancellationToken)"/> and
  37026. <see cref="M:MailKit.IMailSpool.GetMessageUids(System.Threading.CancellationToken)"/> will fail.</para>
  37027. </remarks>
  37028. <value><c>true</c> if supports uids; otherwise, <c>false</c>.</value>
  37029. </member>
  37030. <member name="M:MailKit.IMailSpool.GetMessageCount(System.Threading.CancellationToken)">
  37031. <summary>
  37032. Get the message count.
  37033. </summary>
  37034. <remarks>
  37035. Gets the message count.
  37036. </remarks>
  37037. <returns>The message count.</returns>
  37038. </member>
  37039. <member name="M:MailKit.IMailSpool.GetMessageUid(System.Int32,System.Threading.CancellationToken)">
  37040. <summary>
  37041. Get the UID of the message at the specified index.
  37042. </summary>
  37043. <remarks>
  37044. Not all servers support UIDs, so you should first check
  37045. the <see cref="P:MailKit.IMailSpool.SupportsUids"/> property.
  37046. </remarks>
  37047. <returns>The message UID.</returns>
  37048. <param name="index">The message index.</param>
  37049. <param name="cancellationToken">The cancellation token.</param>
  37050. </member>
  37051. <member name="M:MailKit.IMailSpool.GetMessageUidAsync(System.Int32,System.Threading.CancellationToken)">
  37052. <summary>
  37053. Asynchronously get the UID of the message at the specified index.
  37054. </summary>
  37055. <remarks>
  37056. Not all servers support UIDs, so you should first check
  37057. the <see cref="P:MailKit.IMailSpool.SupportsUids"/> property.
  37058. </remarks>
  37059. <returns>The message UID.</returns>
  37060. <param name="index">The message index.</param>
  37061. <param name="cancellationToken">The cancellation token.</param>
  37062. </member>
  37063. <member name="M:MailKit.IMailSpool.GetMessageUids(System.Threading.CancellationToken)">
  37064. <summary>
  37065. Get the full list of available message UIDs.
  37066. </summary>
  37067. <remarks>
  37068. Not all servers support UIDs, so you should first check
  37069. the <see cref="P:MailKit.IMailSpool.SupportsUids"/> property.
  37070. </remarks>
  37071. <returns>The message UIDs.</returns>
  37072. <param name="cancellationToken">The cancellation token.</param>
  37073. </member>
  37074. <member name="M:MailKit.IMailSpool.GetMessageUidsAsync(System.Threading.CancellationToken)">
  37075. <summary>
  37076. Asynchronously get the full list of available message UIDs.
  37077. </summary>
  37078. <remarks>
  37079. Not all servers support UIDs, so you should first check
  37080. the <see cref="P:MailKit.IMailSpool.SupportsUids"/> property.
  37081. </remarks>
  37082. <returns>The message UIDs.</returns>
  37083. <param name="cancellationToken">The cancellation token.</param>
  37084. </member>
  37085. <member name="M:MailKit.IMailSpool.GetMessageSize(System.Int32,System.Threading.CancellationToken)">
  37086. <summary>
  37087. Get the size of the specified message, in bytes.
  37088. </summary>
  37089. <remarks>
  37090. Gets the size of the specified message, in bytes.
  37091. </remarks>
  37092. <returns>The message size, in bytes.</returns>
  37093. <param name="index">The index of the message.</param>
  37094. <param name="cancellationToken">The cancellation token.</param>
  37095. </member>
  37096. <member name="M:MailKit.IMailSpool.GetMessageSizeAsync(System.Int32,System.Threading.CancellationToken)">
  37097. <summary>
  37098. Asynchronously get the size of the specified message, in bytes.
  37099. </summary>
  37100. <remarks>
  37101. Asynchronously gets the size of the specified message, in bytes.
  37102. </remarks>
  37103. <returns>The message size, in bytes.</returns>
  37104. <param name="index">The index of the message.</param>
  37105. <param name="cancellationToken">The cancellation token.</param>
  37106. </member>
  37107. <member name="M:MailKit.IMailSpool.GetMessageSizes(System.Threading.CancellationToken)">
  37108. <summary>
  37109. Get the sizes for all available messages, in bytes.
  37110. </summary>
  37111. <remarks>
  37112. Gets the sizes for all available messages, in bytes.
  37113. </remarks>
  37114. <returns>The message sizes, in bytes.</returns>
  37115. <param name="cancellationToken">The cancellation token.</param>
  37116. </member>
  37117. <member name="M:MailKit.IMailSpool.GetMessageSizesAsync(System.Threading.CancellationToken)">
  37118. <summary>
  37119. Asynchronously get the sizes for all available messages, in bytes.
  37120. </summary>
  37121. <remarks>
  37122. Asynchronously gets the sizes for all available messages, in bytes.
  37123. </remarks>
  37124. <returns>The message sizes, in bytes.</returns>
  37125. <param name="cancellationToken">The cancellation token.</param>
  37126. </member>
  37127. <member name="M:MailKit.IMailSpool.GetMessageHeaders(System.Int32,System.Threading.CancellationToken)">
  37128. <summary>
  37129. Get the headers for the specified message.
  37130. </summary>
  37131. <remarks>
  37132. Gets the headers for the specified message.
  37133. </remarks>
  37134. <returns>The message headers.</returns>
  37135. <param name="index">The index of the message.</param>
  37136. <param name="cancellationToken">The cancellation token.</param>
  37137. </member>
  37138. <member name="M:MailKit.IMailSpool.GetMessageHeadersAsync(System.Int32,System.Threading.CancellationToken)">
  37139. <summary>
  37140. Asynchronously get the headers for the specified message.
  37141. </summary>
  37142. <remarks>
  37143. Asynchronously gets the headers for the specified message.
  37144. </remarks>
  37145. <returns>The message headers.</returns>
  37146. <param name="index">The index of the message.</param>
  37147. <param name="cancellationToken">The cancellation token.</param>
  37148. </member>
  37149. <member name="M:MailKit.IMailSpool.GetMessageHeaders(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken)">
  37150. <summary>
  37151. Get the headers for the specified messages.
  37152. </summary>
  37153. <remarks>
  37154. Gets the headers for the specified messages.
  37155. </remarks>
  37156. <returns>The headers for the specified messages.</returns>
  37157. <param name="indexes">The indexes of the messages.</param>
  37158. <param name="cancellationToken">The cancellation token.</param>
  37159. </member>
  37160. <member name="M:MailKit.IMailSpool.GetMessageHeadersAsync(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken)">
  37161. <summary>
  37162. Asynchronously get the headers for the specified messages.
  37163. </summary>
  37164. <remarks>
  37165. Asynchronously gets the headers for the specified messages.
  37166. </remarks>
  37167. <returns>The headers for the specified messages.</returns>
  37168. <param name="indexes">The indexes of the messages.</param>
  37169. <param name="cancellationToken">The cancellation token.</param>
  37170. </member>
  37171. <member name="M:MailKit.IMailSpool.GetMessageHeaders(System.Int32,System.Int32,System.Threading.CancellationToken)">
  37172. <summary>
  37173. Get the headers of the messages within the specified range.
  37174. </summary>
  37175. <remarks>
  37176. Gets the headers of the messages within the specified range.
  37177. </remarks>
  37178. <returns>The headers of the messages within the specified range.</returns>
  37179. <param name="startIndex">The index of the first message to get.</param>
  37180. <param name="count">The number of messages to get.</param>
  37181. <param name="cancellationToken">The cancellation token.</param>
  37182. </member>
  37183. <member name="M:MailKit.IMailSpool.GetMessageHeadersAsync(System.Int32,System.Int32,System.Threading.CancellationToken)">
  37184. <summary>
  37185. Get the headers of the messages within the specified range.
  37186. </summary>
  37187. <remarks>
  37188. Gets the headers of the messages within the specified range.
  37189. </remarks>
  37190. <returns>The headers of the messages within the specified range.</returns>
  37191. <param name="startIndex">The index of the first message to get.</param>
  37192. <param name="count">The number of messages to get.</param>
  37193. <param name="cancellationToken">The cancellation token.</param>
  37194. </member>
  37195. <member name="M:MailKit.IMailSpool.GetMessage(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  37196. <summary>
  37197. Get the message at the specified index.
  37198. </summary>
  37199. <remarks>
  37200. Gets the message at the specified index.
  37201. </remarks>
  37202. <returns>The message.</returns>
  37203. <param name="index">The index of the message.</param>
  37204. <param name="cancellationToken">The cancellation token.</param>
  37205. <param name="progress">The progress reporting mechanism.</param>
  37206. </member>
  37207. <member name="M:MailKit.IMailSpool.GetMessageAsync(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  37208. <summary>
  37209. Asynchronously get the message at the specified index.
  37210. </summary>
  37211. <remarks>
  37212. Asynchronously gets the message at the specified index.
  37213. </remarks>
  37214. <returns>The message.</returns>
  37215. <param name="index">The index of the message.</param>
  37216. <param name="cancellationToken">The cancellation token.</param>
  37217. <param name="progress">The progress reporting mechanism.</param>
  37218. </member>
  37219. <member name="M:MailKit.IMailSpool.GetMessages(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  37220. <summary>
  37221. Get the messages at the specified indexes.
  37222. </summary>
  37223. <remarks>
  37224. Gets the messages at the specified indexes.
  37225. </remarks>
  37226. <returns>The messages.</returns>
  37227. <param name="indexes">The indexes of the messages.</param>
  37228. <param name="cancellationToken">The cancellation token.</param>
  37229. <param name="progress">The progress reporting mechanism.</param>
  37230. </member>
  37231. <member name="M:MailKit.IMailSpool.GetMessagesAsync(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  37232. <summary>
  37233. Asynchronously get the messages at the specified indexes.
  37234. </summary>
  37235. <remarks>
  37236. Asynchronously gets the messages at the specified indexes.
  37237. </remarks>
  37238. <returns>The messages.</returns>
  37239. <param name="indexes">The indexes of the messages.</param>
  37240. <param name="cancellationToken">The cancellation token.</param>
  37241. <param name="progress">The progress reporting mechanism.</param>
  37242. </member>
  37243. <member name="M:MailKit.IMailSpool.GetMessages(System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  37244. <summary>
  37245. Get the messages within the specified range.
  37246. </summary>
  37247. <remarks>
  37248. Gets the messages within the specified range.
  37249. </remarks>
  37250. <returns>The messages.</returns>
  37251. <param name="startIndex">The index of the first message to get.</param>
  37252. <param name="count">The number of messages to get.</param>
  37253. <param name="cancellationToken">The cancellation token.</param>
  37254. <param name="progress">The progress reporting mechanism.</param>
  37255. </member>
  37256. <member name="M:MailKit.IMailSpool.GetMessagesAsync(System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  37257. <summary>
  37258. Asynchronously get the messages within the specified range.
  37259. </summary>
  37260. <remarks>
  37261. Asynchronously gets the messages within the specified range.
  37262. </remarks>
  37263. <returns>The messages.</returns>
  37264. <param name="startIndex">The index of the first message to get.</param>
  37265. <param name="count">The number of messages to get.</param>
  37266. <param name="cancellationToken">The cancellation token.</param>
  37267. <param name="progress">The progress reporting mechanism.</param>
  37268. </member>
  37269. <member name="M:MailKit.IMailSpool.GetStream(System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  37270. <summary>
  37271. Get the message or header stream at the specified index.
  37272. </summary>
  37273. <remarks>
  37274. Gets the message or header stream at the specified index.
  37275. </remarks>
  37276. <returns>The message or header stream.</returns>
  37277. <param name="index">The index of the message.</param>
  37278. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  37279. <param name="cancellationToken">The cancellation token.</param>
  37280. <param name="progress">The progress reporting mechanism.</param>
  37281. </member>
  37282. <member name="M:MailKit.IMailSpool.GetStreamAsync(System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  37283. <summary>
  37284. Asynchronously get the message or header stream at the specified index.
  37285. </summary>
  37286. <remarks>
  37287. Asynchronously gets the message or header stream at the specified index.
  37288. </remarks>
  37289. <returns>The message or header stream.</returns>
  37290. <param name="index">The index of the message.</param>
  37291. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  37292. <param name="cancellationToken">The cancellation token.</param>
  37293. <param name="progress">The progress reporting mechanism.</param>
  37294. </member>
  37295. <member name="M:MailKit.IMailSpool.GetStreams(System.Collections.Generic.IList{System.Int32},System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  37296. <summary>
  37297. Get the message or header streams at the specified index.
  37298. </summary>
  37299. <remarks>
  37300. Gets the message or header streams at the specified index.
  37301. </remarks>
  37302. <returns>The message or header streams.</returns>
  37303. <param name="indexes">The indexes of the messages.</param>
  37304. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  37305. <param name="cancellationToken">The cancellation token.</param>
  37306. <param name="progress">The progress reporting mechanism.</param>
  37307. </member>
  37308. <member name="M:MailKit.IMailSpool.GetStreamsAsync(System.Collections.Generic.IList{System.Int32},System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  37309. <summary>
  37310. Asynchronously get the message or header streams at the specified indexes.
  37311. </summary>
  37312. <remarks>
  37313. Asynchronously gets the message or header streams at the specified indexes.
  37314. </remarks>
  37315. <returns>The message or header streams.</returns>
  37316. <param name="indexes">The indexes of the messages.</param>
  37317. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  37318. <param name="cancellationToken">The cancellation token.</param>
  37319. <param name="progress">The progress reporting mechanism.</param>
  37320. </member>
  37321. <member name="M:MailKit.IMailSpool.GetStreams(System.Int32,System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  37322. <summary>
  37323. Get the message or header streams within the specified range.
  37324. </summary>
  37325. <remarks>
  37326. Gets the message or header streams within the specified range.
  37327. </remarks>
  37328. <returns>The message or header streams.</returns>
  37329. <param name="startIndex">The index of the first stream to get.</param>
  37330. <param name="count">The number of streams to get.</param>
  37331. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  37332. <param name="cancellationToken">The cancellation token.</param>
  37333. <param name="progress">The progress reporting mechanism.</param>
  37334. </member>
  37335. <member name="M:MailKit.IMailSpool.GetStreamsAsync(System.Int32,System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  37336. <summary>
  37337. Asynchronously get the message or header streams within the specified range.
  37338. </summary>
  37339. <remarks>
  37340. Asynchronously gets the message or header streams within the specified range.
  37341. </remarks>
  37342. <returns>The messages.</returns>
  37343. <param name="startIndex">The index of the first stream to get.</param>
  37344. <param name="count">The number of streams to get.</param>
  37345. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  37346. <param name="cancellationToken">The cancellation token.</param>
  37347. <param name="progress">The progress reporting mechanism.</param>
  37348. </member>
  37349. <member name="M:MailKit.IMailSpool.DeleteMessage(System.Int32,System.Threading.CancellationToken)">
  37350. <summary>
  37351. Mark the specified message for deletion.
  37352. </summary>
  37353. <remarks>
  37354. Messages marked for deletion are not actually deleted until the session
  37355. is cleanly disconnected
  37356. (see <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  37357. </remarks>
  37358. <param name="index">The index of the message.</param>
  37359. <param name="cancellationToken">The cancellation token.</param>
  37360. </member>
  37361. <member name="M:MailKit.IMailSpool.DeleteMessageAsync(System.Int32,System.Threading.CancellationToken)">
  37362. <summary>
  37363. Asynchronously mark the specified message for deletion.
  37364. </summary>
  37365. <remarks>
  37366. Messages marked for deletion are not actually deleted until the session
  37367. is cleanly disconnected
  37368. (see <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  37369. </remarks>
  37370. <returns>An asynchronous task context.</returns>
  37371. <param name="index">The index of the message.</param>
  37372. <param name="cancellationToken">The cancellation token.</param>
  37373. </member>
  37374. <member name="M:MailKit.IMailSpool.DeleteMessages(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken)">
  37375. <summary>
  37376. Mark the specified messages for deletion.
  37377. </summary>
  37378. <remarks>
  37379. Messages marked for deletion are not actually deleted until the session
  37380. is cleanly disconnected
  37381. (see <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  37382. </remarks>
  37383. <param name="indexes">The indexes of the messages.</param>
  37384. <param name="cancellationToken">The cancellation token.</param>
  37385. </member>
  37386. <member name="M:MailKit.IMailSpool.DeleteMessagesAsync(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken)">
  37387. <summary>
  37388. Asynchronously mark the specified messages for deletion.
  37389. </summary>
  37390. <remarks>
  37391. Messages marked for deletion are not actually deleted until the session
  37392. is cleanly disconnected
  37393. (see <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  37394. </remarks>
  37395. <returns>An asynchronous task context.</returns>
  37396. <param name="indexes">The indexes of the messages.</param>
  37397. <param name="cancellationToken">The cancellation token.</param>
  37398. </member>
  37399. <member name="M:MailKit.IMailSpool.DeleteMessages(System.Int32,System.Int32,System.Threading.CancellationToken)">
  37400. <summary>
  37401. Mark the specified range of messages for deletion.
  37402. </summary>
  37403. <remarks>
  37404. Messages marked for deletion are not actually deleted until the session
  37405. is cleanly disconnected
  37406. (see <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  37407. </remarks>
  37408. <param name="startIndex">The index of the first message to mark for deletion.</param>
  37409. <param name="count">The number of messages to mark for deletion.</param>
  37410. <param name="cancellationToken">The cancellation token.</param>
  37411. </member>
  37412. <member name="M:MailKit.IMailSpool.DeleteMessagesAsync(System.Int32,System.Int32,System.Threading.CancellationToken)">
  37413. <summary>
  37414. Asynchronously mark the specified range of messages for deletion.
  37415. </summary>
  37416. <remarks>
  37417. Messages marked for deletion are not actually deleted until the session
  37418. is cleanly disconnected
  37419. (see <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  37420. </remarks>
  37421. <returns>An asynchronous task context.</returns>
  37422. <param name="startIndex">The index of the first message to mark for deletion.</param>
  37423. <param name="count">The number of messages to mark for deletion.</param>
  37424. <param name="cancellationToken">The cancellation token.</param>
  37425. </member>
  37426. <member name="M:MailKit.IMailSpool.DeleteAllMessages(System.Threading.CancellationToken)">
  37427. <summary>
  37428. Mark all messages for deletion.
  37429. </summary>
  37430. <remarks>
  37431. Messages marked for deletion are not actually deleted until the session
  37432. is cleanly disconnected
  37433. (see <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  37434. </remarks>
  37435. <param name="cancellationToken">The cancellation token.</param>
  37436. </member>
  37437. <member name="M:MailKit.IMailSpool.DeleteAllMessagesAsync(System.Threading.CancellationToken)">
  37438. <summary>
  37439. Asynchronously mark all messages for deletion.
  37440. </summary>
  37441. <remarks>
  37442. Messages marked for deletion are not actually deleted until the session
  37443. is cleanly disconnected
  37444. (see <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  37445. </remarks>
  37446. <returns>An asynchronous task context.</returns>
  37447. <param name="cancellationToken">The cancellation token.</param>
  37448. </member>
  37449. <member name="M:MailKit.IMailSpool.Reset(System.Threading.CancellationToken)">
  37450. <summary>
  37451. Reset the state of all messages marked for deletion.
  37452. </summary>
  37453. <remarks>
  37454. Messages marked for deletion are not actually deleted until the session
  37455. is cleanly disconnected
  37456. (see <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  37457. </remarks>
  37458. <param name="cancellationToken">The cancellation token.</param>
  37459. </member>
  37460. <member name="M:MailKit.IMailSpool.ResetAsync(System.Threading.CancellationToken)">
  37461. <summary>
  37462. Asynchronously reset the state of all messages marked for deletion.
  37463. </summary>
  37464. <remarks>
  37465. Messages marked for deletion are not actually deleted until the session
  37466. is cleanly disconnected
  37467. (see <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  37468. </remarks>
  37469. <returns>An asynchronous task context.</returns>
  37470. <param name="cancellationToken">The cancellation token.</param>
  37471. </member>
  37472. <member name="T:MailKit.IMailStore">
  37473. <summary>
  37474. An interface for retreiving messages from a message store such as IMAP.
  37475. </summary>
  37476. <remarks>
  37477. Implemented by <see cref="T:MailKit.Net.Imap.ImapClient"/>.
  37478. </remarks>
  37479. </member>
  37480. <member name="P:MailKit.IMailStore.PersonalNamespaces">
  37481. <summary>
  37482. Get the personal namespaces.
  37483. </summary>
  37484. <remarks>
  37485. The personal folder namespaces contain a user's personal mailbox folders.
  37486. </remarks>
  37487. <value>The personal namespaces.</value>
  37488. </member>
  37489. <member name="P:MailKit.IMailStore.SharedNamespaces">
  37490. <summary>
  37491. Get the shared namespaces.
  37492. </summary>
  37493. <remarks>
  37494. The shared folder namespaces contain mailbox folders that are shared with the user.
  37495. </remarks>
  37496. <value>The shared namespaces.</value>
  37497. </member>
  37498. <member name="P:MailKit.IMailStore.OtherNamespaces">
  37499. <summary>
  37500. Get the other namespaces.
  37501. </summary>
  37502. <remarks>
  37503. The other folder namespaces contain other mailbox folders.
  37504. </remarks>
  37505. <value>The other namespaces.</value>
  37506. </member>
  37507. <member name="P:MailKit.IMailStore.SupportsQuotas">
  37508. <summary>
  37509. Get whether or not the mail store supports quotas.
  37510. </summary>
  37511. <remarks>
  37512. Gets whether or not the mail store supports quotas.
  37513. </remarks>
  37514. <value><c>true</c> if the mail store supports quotas; otherwise, <c>false</c>.</value>
  37515. </member>
  37516. <member name="P:MailKit.IMailStore.ThreadingAlgorithms">
  37517. <summary>
  37518. Get the threading algorithms supported by the mail store.
  37519. </summary>
  37520. <remarks>
  37521. The threading algorithms are queried as part of the
  37522. <a href="Overload_MailKit_IMailStore_Connect.htm">Connect</a>
  37523. and <a href="Overload_MailKit_IMailStore_Authenticate.htm">Authenticate</a> methods.
  37524. </remarks>
  37525. <example>
  37526. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  37527. </example>
  37528. <value>The threading algorithms.</value>
  37529. </member>
  37530. <member name="P:MailKit.IMailStore.Inbox">
  37531. <summary>
  37532. Get the Inbox folder.
  37533. </summary>
  37534. <remarks>
  37535. The Inbox folder is the default folder and is typically the folder
  37536. where all new messages are delivered.
  37537. </remarks>
  37538. <value>The Inbox folder.</value>
  37539. </member>
  37540. <member name="M:MailKit.IMailStore.EnableQuickResync(System.Threading.CancellationToken)">
  37541. <summary>
  37542. Enable the quick resynchronization feature.
  37543. </summary>
  37544. <remarks>
  37545. <para>Enables quick resynchronization when a folder is opened using the
  37546. <see cref="M:MailKit.IMailFolder.Open(MailKit.FolderAccess,System.UInt32,System.UInt64,System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)"/>
  37547. method.</para>
  37548. <para>If this feature is enabled, the <see cref="E:MailKit.IMailFolder.MessageExpunged"/> event
  37549. is replaced with the <see cref="E:MailKit.IMailFolder.MessagesVanished"/> event.</para>
  37550. <para>This method needs to be called immediately after
  37551. <see cref="M:MailKit.IMailService.Authenticate(System.Net.ICredentials,System.Threading.CancellationToken)"/>,
  37552. before the opening of any folders.</para>
  37553. </remarks>
  37554. <param name="cancellationToken">The cancellation token.</param>
  37555. <exception cref="T:System.ObjectDisposedException">
  37556. The <see cref="T:MailKit.MailStore"/> has been disposed.
  37557. </exception>
  37558. <exception cref="T:MailKit.ServiceNotConnectedException">
  37559. The <see cref="T:MailKit.IMailService"/> is not connected.
  37560. </exception>
  37561. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  37562. The <see cref="T:MailKit.IMailService"/> is not authenticated.
  37563. </exception>
  37564. <exception cref="T:System.InvalidOperationException">
  37565. Quick resynchronization needs to be enabled before selecting a folder.
  37566. </exception>
  37567. <exception cref="T:System.NotSupportedException">
  37568. The mail store does not support quick resynchronization.
  37569. </exception>
  37570. <exception cref="T:System.OperationCanceledException">
  37571. The operation was canceled via the cancellation token.
  37572. </exception>
  37573. <exception cref="T:System.IO.IOException">
  37574. An I/O error occurred.
  37575. </exception>
  37576. <exception cref="T:MailKit.ProtocolException">
  37577. A protocol error occurred.
  37578. </exception>
  37579. <exception cref="T:MailKit.CommandException">
  37580. The command failed.
  37581. </exception>
  37582. </member>
  37583. <member name="M:MailKit.IMailStore.EnableQuickResyncAsync(System.Threading.CancellationToken)">
  37584. <summary>
  37585. Asynchronously enable the quick resynchronization feature.
  37586. </summary>
  37587. <remarks>
  37588. <para>Enables quick resynchronization when a folder is opened using the
  37589. <see cref="M:MailKit.IMailFolder.Open(MailKit.FolderAccess,System.UInt32,System.UInt64,System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)"/>
  37590. method.</para>
  37591. <para>If this feature is enabled, the <see cref="E:MailKit.IMailFolder.MessageExpunged"/> event
  37592. is replaced with the <see cref="E:MailKit.IMailFolder.MessagesVanished"/> event.</para>
  37593. <para>This method needs to be called immediately after
  37594. <see cref="M:MailKit.IMailService.Authenticate(System.Net.ICredentials,System.Threading.CancellationToken)"/>,
  37595. before the opening of any folders.</para>
  37596. </remarks>
  37597. <returns>An asynchronous task context.</returns>
  37598. <param name="cancellationToken">The cancellation token.</param>
  37599. <exception cref="T:System.ObjectDisposedException">
  37600. The <see cref="T:MailKit.MailStore"/> has been disposed.
  37601. </exception>
  37602. <exception cref="T:MailKit.ServiceNotConnectedException">
  37603. The <see cref="T:MailKit.IMailService"/> is not connected.
  37604. </exception>
  37605. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  37606. The <see cref="T:MailKit.IMailService"/> is not authenticated.
  37607. </exception>
  37608. <exception cref="T:System.InvalidOperationException">
  37609. Quick resynchronization needs to be enabled before selecting a folder.
  37610. </exception>
  37611. <exception cref="T:System.NotSupportedException">
  37612. The mail store does not support quick resynchronization.
  37613. </exception>
  37614. <exception cref="T:System.OperationCanceledException">
  37615. The operation was canceled via the cancellation token.
  37616. </exception>
  37617. <exception cref="T:System.IO.IOException">
  37618. An I/O error occurred.
  37619. </exception>
  37620. <exception cref="T:MailKit.ProtocolException">
  37621. A protocol error occurred.
  37622. </exception>
  37623. <exception cref="T:MailKit.CommandException">
  37624. The command failed.
  37625. </exception>
  37626. </member>
  37627. <member name="M:MailKit.IMailStore.GetFolder(MailKit.SpecialFolder)">
  37628. <summary>
  37629. Get the specified special folder.
  37630. </summary>
  37631. <remarks>
  37632. Not all message stores support the concept of special folders,
  37633. so this method may return <c>null</c>.
  37634. </remarks>
  37635. <returns>The folder if available; otherwise <c>null</c>.</returns>
  37636. <param name="folder">The type of special folder.</param>
  37637. <exception cref="T:System.ArgumentOutOfRangeException">
  37638. <paramref name="folder"/> is out of range.
  37639. </exception>
  37640. </member>
  37641. <member name="M:MailKit.IMailStore.GetFolder(MailKit.FolderNamespace)">
  37642. <summary>
  37643. Get the folder for the specified namespace.
  37644. </summary>
  37645. <remarks>
  37646. The main reason to get the toplevel folder in a namespace is
  37647. to list its child folders.
  37648. </remarks>
  37649. <returns>The folder.</returns>
  37650. <param name="namespace">The namespace.</param>
  37651. <exception cref="T:System.ArgumentNullException">
  37652. <paramref name="namespace"/> is <c>null</c>.
  37653. </exception>
  37654. <exception cref="T:MailKit.FolderNotFoundException">
  37655. The folder could not be found.
  37656. </exception>
  37657. </member>
  37658. <member name="M:MailKit.IMailStore.GetFolders(MailKit.FolderNamespace,System.Boolean,System.Threading.CancellationToken)">
  37659. <summary>
  37660. Get all of the folders within the specified namespace.
  37661. </summary>
  37662. <remarks>
  37663. Gets all of the folders within the specified namespace.
  37664. </remarks>
  37665. <returns>The folders.</returns>
  37666. <param name="namespace">The namespace.</param>
  37667. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  37668. <param name="cancellationToken">The cancellation token.</param>
  37669. <exception cref="T:System.ArgumentNullException">
  37670. <paramref name="namespace"/> is <c>null</c>.
  37671. </exception>
  37672. <exception cref="T:System.ObjectDisposedException">
  37673. The <see cref="T:MailKit.IMailService"/> has been disposed.
  37674. </exception>
  37675. <exception cref="T:System.OperationCanceledException">
  37676. The operation was canceled via the cancellation token.
  37677. </exception>
  37678. <exception cref="T:MailKit.ServiceNotConnectedException">
  37679. The <see cref="T:MailKit.IMailService"/> is not connected.
  37680. </exception>
  37681. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  37682. The <see cref="T:MailKit.IMailService"/> is not authenticated.
  37683. </exception>
  37684. <exception cref="T:MailKit.FolderNotFoundException">
  37685. The namespace folder could not be found.
  37686. </exception>
  37687. <exception cref="T:System.IO.IOException">
  37688. An I/O error occurred.
  37689. </exception>
  37690. <exception cref="T:MailKit.ProtocolException">
  37691. A protocol error occurred.
  37692. </exception>
  37693. <exception cref="T:MailKit.CommandException">
  37694. The command failed.
  37695. </exception>
  37696. </member>
  37697. <member name="M:MailKit.IMailStore.GetFoldersAsync(MailKit.FolderNamespace,System.Boolean,System.Threading.CancellationToken)">
  37698. <summary>
  37699. Asynchronously get all of the folders within the specified namespace.
  37700. </summary>
  37701. <remarks>
  37702. Asynchronously gets all of the folders within the specified namespace.
  37703. </remarks>
  37704. <returns>The folders.</returns>
  37705. <param name="namespace">The namespace.</param>
  37706. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  37707. <param name="cancellationToken">The cancellation token.</param>
  37708. <exception cref="T:System.ArgumentNullException">
  37709. <paramref name="namespace"/> is <c>null</c>.
  37710. </exception>
  37711. <exception cref="T:System.ObjectDisposedException">
  37712. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  37713. </exception>
  37714. <exception cref="T:System.OperationCanceledException">
  37715. The operation was canceled via the cancellation token.
  37716. </exception>
  37717. <exception cref="T:MailKit.ServiceNotConnectedException">
  37718. The <see cref="T:MailKit.IMailService"/> is not connected.
  37719. </exception>
  37720. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  37721. The <see cref="T:MailKit.IMailService"/> is not authenticated.
  37722. </exception>
  37723. <exception cref="T:MailKit.FolderNotFoundException">
  37724. The namespace folder could not be found.
  37725. </exception>
  37726. <exception cref="T:System.IO.IOException">
  37727. An I/O error occurred.
  37728. </exception>
  37729. <exception cref="T:MailKit.ProtocolException">
  37730. A protocol error occurred.
  37731. </exception>
  37732. <exception cref="T:MailKit.CommandException">
  37733. The command failed.
  37734. </exception>
  37735. </member>
  37736. <member name="M:MailKit.IMailStore.GetFolders(MailKit.FolderNamespace,MailKit.StatusItems,System.Boolean,System.Threading.CancellationToken)">
  37737. <summary>
  37738. Get all of the folders within the specified namespace.
  37739. </summary>
  37740. <remarks>
  37741. Gets all of the folders within the specified namespace.
  37742. </remarks>
  37743. <returns>The folders.</returns>
  37744. <param name="namespace">The namespace.</param>
  37745. <param name="items">The status items to pre-populate.</param>
  37746. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  37747. <param name="cancellationToken">The cancellation token.</param>
  37748. <exception cref="T:System.ArgumentNullException">
  37749. <paramref name="namespace"/> is <c>null</c>.
  37750. </exception>
  37751. <exception cref="T:System.ObjectDisposedException">
  37752. The <see cref="T:MailKit.IMailService"/> has been disposed.
  37753. </exception>
  37754. <exception cref="T:System.OperationCanceledException">
  37755. The operation was canceled via the cancellation token.
  37756. </exception>
  37757. <exception cref="T:MailKit.ServiceNotConnectedException">
  37758. The <see cref="T:MailKit.IMailService"/> is not connected.
  37759. </exception>
  37760. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  37761. The <see cref="T:MailKit.IMailService"/> is not authenticated.
  37762. </exception>
  37763. <exception cref="T:MailKit.FolderNotFoundException">
  37764. The namespace folder could not be found.
  37765. </exception>
  37766. <exception cref="T:System.IO.IOException">
  37767. An I/O error occurred.
  37768. </exception>
  37769. <exception cref="T:MailKit.ProtocolException">
  37770. A protocol error occurred.
  37771. </exception>
  37772. <exception cref="T:MailKit.CommandException">
  37773. The command failed.
  37774. </exception>
  37775. </member>
  37776. <member name="M:MailKit.IMailStore.GetFoldersAsync(MailKit.FolderNamespace,MailKit.StatusItems,System.Boolean,System.Threading.CancellationToken)">
  37777. <summary>
  37778. Asynchronously get all of the folders within the specified namespace.
  37779. </summary>
  37780. <remarks>
  37781. Asynchronously gets all of the folders within the specified namespace.
  37782. </remarks>
  37783. <returns>The folders.</returns>
  37784. <param name="namespace">The namespace.</param>
  37785. <param name="items">The status items to pre-populate.</param>
  37786. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  37787. <param name="cancellationToken">The cancellation token.</param>
  37788. <exception cref="T:System.ArgumentNullException">
  37789. <paramref name="namespace"/> is <c>null</c>.
  37790. </exception>
  37791. <exception cref="T:System.ObjectDisposedException">
  37792. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  37793. </exception>
  37794. <exception cref="T:System.OperationCanceledException">
  37795. The operation was canceled via the cancellation token.
  37796. </exception>
  37797. <exception cref="T:MailKit.ServiceNotConnectedException">
  37798. The <see cref="T:MailKit.IMailService"/> is not connected.
  37799. </exception>
  37800. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  37801. The <see cref="T:MailKit.IMailService"/> is not authenticated.
  37802. </exception>
  37803. <exception cref="T:MailKit.FolderNotFoundException">
  37804. The namespace folder could not be found.
  37805. </exception>
  37806. <exception cref="T:System.IO.IOException">
  37807. An I/O error occurred.
  37808. </exception>
  37809. <exception cref="T:MailKit.ProtocolException">
  37810. A protocol error occurred.
  37811. </exception>
  37812. <exception cref="T:MailKit.CommandException">
  37813. The command failed.
  37814. </exception>
  37815. </member>
  37816. <member name="M:MailKit.IMailStore.GetFolder(System.String,System.Threading.CancellationToken)">
  37817. <summary>
  37818. Get the folder for the specified path.
  37819. </summary>
  37820. <remarks>
  37821. Gets the folder for the specified path.
  37822. </remarks>
  37823. <returns>The folder.</returns>
  37824. <param name="path">The folder path.</param>
  37825. <param name="cancellationToken">The cancellation token.</param>
  37826. <exception cref="T:System.ArgumentNullException">
  37827. <paramref name="path"/> is <c>null</c>.
  37828. </exception>
  37829. <exception cref="T:System.OperationCanceledException">
  37830. The operation was canceled via the cancellation token.
  37831. </exception>
  37832. <exception cref="T:MailKit.FolderNotFoundException">
  37833. The folder could not be found.
  37834. </exception>
  37835. <exception cref="T:System.IO.IOException">
  37836. An I/O error occurred.
  37837. </exception>
  37838. <exception cref="T:MailKit.ProtocolException">
  37839. A protocol error occurred.
  37840. </exception>
  37841. <exception cref="T:MailKit.CommandException">
  37842. The command failed.
  37843. </exception>
  37844. </member>
  37845. <member name="M:MailKit.IMailStore.GetFolderAsync(System.String,System.Threading.CancellationToken)">
  37846. <summary>
  37847. Asynchronously get the folder for the specified path.
  37848. </summary>
  37849. <remarks>
  37850. Asynchronously gets the folder for the specified path.
  37851. </remarks>
  37852. <returns>The folder.</returns>
  37853. <param name="path">The folder path.</param>
  37854. <param name="cancellationToken">The cancellation token.</param>
  37855. <exception cref="T:System.ArgumentNullException">
  37856. <paramref name="path"/> is <c>null</c>.
  37857. </exception>
  37858. <exception cref="T:System.OperationCanceledException">
  37859. The operation was canceled via the cancellation token.
  37860. </exception>
  37861. <exception cref="T:MailKit.FolderNotFoundException">
  37862. The folder could not be found.
  37863. </exception>
  37864. <exception cref="T:System.IO.IOException">
  37865. An I/O error occurred.
  37866. </exception>
  37867. <exception cref="T:MailKit.ProtocolException">
  37868. A protocol error occurred.
  37869. </exception>
  37870. <exception cref="T:MailKit.CommandException">
  37871. The command failed.
  37872. </exception>
  37873. </member>
  37874. <member name="M:MailKit.IMailStore.GetMetadata(MailKit.MetadataTag,System.Threading.CancellationToken)">
  37875. <summary>
  37876. Gets the specified metadata.
  37877. </summary>
  37878. <remarks>
  37879. Gets the specified metadata.
  37880. </remarks>
  37881. <returns>The requested metadata value.</returns>
  37882. <param name="tag">The metadata tag.</param>
  37883. <param name="cancellationToken">The cancellation token.</param>
  37884. </member>
  37885. <member name="M:MailKit.IMailStore.GetMetadataAsync(MailKit.MetadataTag,System.Threading.CancellationToken)">
  37886. <summary>
  37887. Asynchronously gets the specified metadata.
  37888. </summary>
  37889. <remarks>
  37890. Asynchronously gets the specified metadata.
  37891. </remarks>
  37892. <returns>The requested metadata value.</returns>
  37893. <param name="tag">The metadata tag.</param>
  37894. <param name="cancellationToken">The cancellation token.</param>
  37895. </member>
  37896. <member name="M:MailKit.IMailStore.GetMetadata(System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  37897. <summary>
  37898. Gets the specified metadata.
  37899. </summary>
  37900. <remarks>
  37901. Gets the specified metadata.
  37902. </remarks>
  37903. <returns>The requested metadata.</returns>
  37904. <param name="tags">The metadata tags.</param>
  37905. <param name="cancellationToken">The cancellation token.</param>
  37906. </member>
  37907. <member name="M:MailKit.IMailStore.GetMetadataAsync(System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  37908. <summary>
  37909. Asynchronously gets the specified metadata.
  37910. </summary>
  37911. <remarks>
  37912. Asynchronously gets the specified metadata.
  37913. </remarks>
  37914. <returns>The requested metadata.</returns>
  37915. <param name="tags">The metadata tags.</param>
  37916. <param name="cancellationToken">The cancellation token.</param>
  37917. </member>
  37918. <member name="M:MailKit.IMailStore.GetMetadata(MailKit.MetadataOptions,System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  37919. <summary>
  37920. Gets the specified metadata.
  37921. </summary>
  37922. <remarks>
  37923. Gets the specified metadata.
  37924. </remarks>
  37925. <returns>The requested metadata.</returns>
  37926. <param name="options">The metadata options.</param>
  37927. <param name="tags">The metadata tags.</param>
  37928. <param name="cancellationToken">The cancellation token.</param>
  37929. </member>
  37930. <member name="M:MailKit.IMailStore.GetMetadataAsync(MailKit.MetadataOptions,System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  37931. <summary>
  37932. Asynchronously gets the specified metadata.
  37933. </summary>
  37934. <remarks>
  37935. Asynchronously gets the specified metadata.
  37936. </remarks>
  37937. <returns>The requested metadata.</returns>
  37938. <param name="options">The metadata options.</param>
  37939. <param name="tags">The metadata tags.</param>
  37940. <param name="cancellationToken">The cancellation token.</param>
  37941. </member>
  37942. <member name="M:MailKit.IMailStore.SetMetadata(MailKit.MetadataCollection,System.Threading.CancellationToken)">
  37943. <summary>
  37944. Sets the specified metadata.
  37945. </summary>
  37946. <remarks>
  37947. Sets the specified metadata.
  37948. </remarks>
  37949. <param name="metadata">The metadata.</param>
  37950. <param name="cancellationToken">The cancellation token.</param>
  37951. </member>
  37952. <member name="M:MailKit.IMailStore.SetMetadataAsync(MailKit.MetadataCollection,System.Threading.CancellationToken)">
  37953. <summary>
  37954. Asynchronously sets the specified metadata.
  37955. </summary>
  37956. <remarks>
  37957. Asynchronously sets the specified metadata.
  37958. </remarks>
  37959. <returns>An asynchronous task context.</returns>
  37960. <param name="metadata">The metadata.</param>
  37961. <param name="cancellationToken">The cancellation token.</param>
  37962. </member>
  37963. <member name="E:MailKit.IMailStore.Alert">
  37964. <summary>
  37965. Occurs when a remote message store receives an alert message from the server.
  37966. </summary>
  37967. <remarks>
  37968. Some implementations, such as <see cref="T:MailKit.Net.Imap.ImapClient"/>,
  37969. will emit Alert events when they receive alert messages from the server.
  37970. </remarks>
  37971. </member>
  37972. <member name="E:MailKit.IMailStore.FolderCreated">
  37973. <summary>
  37974. Occurs when a folder is created.
  37975. </summary>
  37976. <remarks>
  37977. The <see cref="E:MailKit.IMailStore.FolderCreated"/> event is emitted when a new folder is created.
  37978. </remarks>
  37979. </member>
  37980. <member name="E:MailKit.IMailStore.MetadataChanged">
  37981. <summary>
  37982. Occurs when metadata changes.
  37983. </summary>
  37984. <remarks>
  37985. The <see cref="E:MailKit.IMailStore.MetadataChanged"/> event is emitted when metadata changes.
  37986. </remarks>
  37987. </member>
  37988. <member name="T:MailKit.IMailTransport">
  37989. <summary>
  37990. An interface for sending messages.
  37991. </summary>
  37992. <remarks>
  37993. An interface for sending messages.
  37994. </remarks>
  37995. </member>
  37996. <member name="M:MailKit.IMailTransport.Send(MimeKit.MimeMessage,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  37997. <summary>
  37998. Send the specified message.
  37999. </summary>
  38000. <remarks>
  38001. <para>Sends the specified message.</para>
  38002. <para>The sender address is determined by checking the following
  38003. message headers (in order of precedence): Resent-Sender,
  38004. Resent-From, Sender, and From.</para>
  38005. <para>If either the Resent-Sender or Resent-From addresses are present,
  38006. the recipients are collected from the Resent-To, Resent-Cc, and
  38007. Resent-Bcc headers, otherwise the To, Cc, and Bcc headers are used.</para>
  38008. </remarks>
  38009. <param name="message">The message.</param>
  38010. <param name="cancellationToken">The cancellation token.</param>
  38011. <param name="progress">The progress reporting mechanism.</param>
  38012. </member>
  38013. <member name="M:MailKit.IMailTransport.SendAsync(MimeKit.MimeMessage,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  38014. <summary>
  38015. Asynchronously send the specified message.
  38016. </summary>
  38017. <remarks>
  38018. <para>Asynchronously sends the specified message.</para>
  38019. <para>The sender address is determined by checking the following
  38020. message headers (in order of precedence): Resent-Sender,
  38021. Resent-From, Sender, and From.</para>
  38022. <para>If either the Resent-Sender or Resent-From addresses are present,
  38023. the recipients are collected from the Resent-To, Resent-Cc, and
  38024. Resent-Bcc headers, otherwise the To, Cc, and Bcc headers are used.</para>
  38025. </remarks>
  38026. <returns>An asynchronous task context.</returns>
  38027. <param name="message">The message.</param>
  38028. <param name="cancellationToken">The cancellation token.</param>
  38029. <param name="progress">The progress reporting mechanism.</param>
  38030. </member>
  38031. <member name="M:MailKit.IMailTransport.Send(MimeKit.MimeMessage,MimeKit.MailboxAddress,System.Collections.Generic.IEnumerable{MimeKit.MailboxAddress},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  38032. <summary>
  38033. Send the specified message using the supplied sender and recipients.
  38034. </summary>
  38035. <remarks>
  38036. Sends the specified message using the supplied sender and recipients.
  38037. </remarks>
  38038. <param name="message">The message.</param>
  38039. <param name="sender">The mailbox address to use for sending the message.</param>
  38040. <param name="recipients">The mailbox addresses that should receive the message.</param>
  38041. <param name="cancellationToken">The cancellation token.</param>
  38042. <param name="progress">The progress reporting mechanism.</param>
  38043. </member>
  38044. <member name="M:MailKit.IMailTransport.SendAsync(MimeKit.MimeMessage,MimeKit.MailboxAddress,System.Collections.Generic.IEnumerable{MimeKit.MailboxAddress},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  38045. <summary>
  38046. Asynchronously send the specified message using the supplied sender and recipients.
  38047. </summary>
  38048. <remarks>
  38049. Asynchronously sends the specified message using the supplied sender and recipients.
  38050. </remarks>
  38051. <returns>An asynchronous task context.</returns>
  38052. <param name="message">The message.</param>
  38053. <param name="sender">The mailbox address to use for sending the message.</param>
  38054. <param name="recipients">The mailbox addresses that should receive the message.</param>
  38055. <param name="cancellationToken">The cancellation token.</param>
  38056. <param name="progress">The progress reporting mechanism.</param>
  38057. </member>
  38058. <member name="M:MailKit.IMailTransport.Send(MimeKit.FormatOptions,MimeKit.MimeMessage,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  38059. <summary>
  38060. Send the specified message.
  38061. </summary>
  38062. <remarks>
  38063. <para>Sends the specified message.</para>
  38064. <para>The sender address is determined by checking the following
  38065. message headers (in order of precedence): Resent-Sender,
  38066. Resent-From, Sender, and From.</para>
  38067. <para>If either the Resent-Sender or Resent-From addresses are present,
  38068. the recipients are collected from the Resent-To, Resent-Cc, and
  38069. Resent-Bcc headers, otherwise the To, Cc, and Bcc headers are used.</para>
  38070. </remarks>
  38071. <param name="options">The formatting options.</param>
  38072. <param name="message">The message.</param>
  38073. <param name="cancellationToken">The cancellation token.</param>
  38074. <param name="progress">The progress reporting mechanism.</param>
  38075. </member>
  38076. <member name="M:MailKit.IMailTransport.SendAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  38077. <summary>
  38078. Asynchronously send the specified message.
  38079. </summary>
  38080. <remarks>
  38081. <para>Asynchronously sends the specified message.</para>
  38082. <para>The sender address is determined by checking the following
  38083. message headers (in order of precedence): Resent-Sender,
  38084. Resent-From, Sender, and From.</para>
  38085. <para>If either the Resent-Sender or Resent-From addresses are present,
  38086. the recipients are collected from the Resent-To, Resent-Cc, and
  38087. Resent-Bcc headers, otherwise the To, Cc, and Bcc headers are used.</para>
  38088. </remarks>
  38089. <returns>An asynchronous task context.</returns>
  38090. <param name="options">The formatting options.</param>
  38091. <param name="message">The message.</param>
  38092. <param name="cancellationToken">The cancellation token.</param>
  38093. <param name="progress">The progress reporting mechanism.</param>
  38094. </member>
  38095. <member name="M:MailKit.IMailTransport.Send(MimeKit.FormatOptions,MimeKit.MimeMessage,MimeKit.MailboxAddress,System.Collections.Generic.IEnumerable{MimeKit.MailboxAddress},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  38096. <summary>
  38097. Send the specified message using the supplied sender and recipients.
  38098. </summary>
  38099. <remarks>
  38100. Sends the specified message using the supplied sender and recipients.
  38101. </remarks>
  38102. <param name="options">The formatting options.</param>
  38103. <param name="message">The message.</param>
  38104. <param name="sender">The mailbox address to use for sending the message.</param>
  38105. <param name="recipients">The mailbox addresses that should receive the message.</param>
  38106. <param name="cancellationToken">The cancellation token.</param>
  38107. <param name="progress">The progress reporting mechanism.</param>
  38108. </member>
  38109. <member name="M:MailKit.IMailTransport.SendAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,MimeKit.MailboxAddress,System.Collections.Generic.IEnumerable{MimeKit.MailboxAddress},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  38110. <summary>
  38111. Asynchronously send the specified message using the supplied sender and recipients.
  38112. </summary>
  38113. <remarks>
  38114. Asynchronously sends the specified message using the supplied sender and recipients.
  38115. </remarks>
  38116. <returns>An asynchronous task context.</returns>
  38117. <param name="options">The formatting options.</param>
  38118. <param name="message">The message.</param>
  38119. <param name="sender">The mailbox address to use for sending the message.</param>
  38120. <param name="recipients">The mailbox addresses that should receive the message.</param>
  38121. <param name="cancellationToken">The cancellation token.</param>
  38122. <param name="progress">The progress reporting mechanism.</param>
  38123. </member>
  38124. <member name="E:MailKit.IMailTransport.MessageSent">
  38125. <summary>
  38126. Occurs when a message is successfully sent via the transport.
  38127. </summary>
  38128. <remarks>
  38129. The <see cref="E:MailKit.IMailTransport.MessageSent"/> event will be emitted each time a message is successfully sent.
  38130. </remarks>
  38131. </member>
  38132. <member name="T:MailKit.IMessageSummary">
  38133. <summary>
  38134. A summary of a message.
  38135. </summary>
  38136. <remarks>
  38137. A <see cref="T:MailKit.IMessageSummary"/> is returned by
  38138. <see cref="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Threading.CancellationToken)"/>.
  38139. The properties of the <see cref="T:MailKit.IMessageSummary"/> that will be available
  38140. depend on the <see cref="T:MailKit.MessageSummaryItems"/> passed to the aformentioned method.
  38141. </remarks>
  38142. </member>
  38143. <member name="P:MailKit.IMessageSummary.Fields">
  38144. <summary>
  38145. Get a bitmask of fields that have been populated.
  38146. </summary>
  38147. <remarks>
  38148. Gets a bitmask of fields that have been populated.
  38149. </remarks>
  38150. <value>The fields that have been populated.</value>
  38151. </member>
  38152. <member name="P:MailKit.IMessageSummary.Body">
  38153. <summary>
  38154. Gets the body structure of the message, if available.
  38155. </summary>
  38156. <remarks>
  38157. <para>The body will be one of <see cref="T:MailKit.BodyPartText"/>,
  38158. <see cref="T:MailKit.BodyPartMessage"/>, <see cref="T:MailKit.BodyPartBasic"/>,
  38159. or <see cref="T:MailKit.BodyPartMultipart"/>.</para>
  38160. <para>This property will only be set if either the
  38161. <see cref="F:MailKit.MessageSummaryItems.Body"/> flag or the
  38162. <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/> flag is passed to
  38163. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38164. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38165. methods.</para>
  38166. </remarks>
  38167. <value>The body structure of the message.</value>
  38168. </member>
  38169. <member name="P:MailKit.IMessageSummary.TextBody">
  38170. <summary>
  38171. Gets the text body part of the message if it exists.
  38172. </summary>
  38173. <remarks>
  38174. <para>Gets the <c>text/plain</c> body part of the message.</para>
  38175. <para>This property will only be usable if the
  38176. <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/> flag is passed to
  38177. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38178. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38179. methods.</para>
  38180. </remarks>
  38181. <example>
  38182. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  38183. </example>
  38184. <value>The text body if it exists; otherwise, <c>null</c>.</value>
  38185. </member>
  38186. <member name="P:MailKit.IMessageSummary.HtmlBody">
  38187. <summary>
  38188. Gets the html body part of the message if it exists.
  38189. </summary>
  38190. <remarks>
  38191. <para>Gets the <c>text/html</c> body part of the message.</para>
  38192. <para>This property will only be usable if the
  38193. <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/> flag is passed to
  38194. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38195. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38196. methods.</para>
  38197. </remarks>
  38198. <value>The html body if it exists; otherwise, <c>null</c>.</value>
  38199. </member>
  38200. <member name="P:MailKit.IMessageSummary.BodyParts">
  38201. <summary>
  38202. Gets the body parts of the message.
  38203. </summary>
  38204. <remarks>
  38205. <para>Traverses over the <see cref="P:MailKit.IMessageSummary.Body"/>, enumerating all of the
  38206. <see cref="T:MailKit.BodyPartBasic"/> objects.</para>
  38207. <para>This property will only be usable if either the
  38208. <see cref="F:MailKit.MessageSummaryItems.Body"/> flag or the
  38209. <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/> flag is passed to
  38210. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38211. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38212. methods.</para>
  38213. </remarks>
  38214. <value>The body parts.</value>
  38215. </member>
  38216. <member name="P:MailKit.IMessageSummary.Attachments">
  38217. <summary>
  38218. Gets the attachments.
  38219. </summary>
  38220. <remarks>
  38221. <para>Traverses over the <see cref="P:MailKit.IMessageSummary.Body"/>, enumerating all of the
  38222. <see cref="T:MailKit.BodyPartBasic"/> objects that have a <c>Content-Disposition</c>
  38223. header set to <c>"attachment"</c>.</para>
  38224. <para>This property will only be usable if the
  38225. <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/> flag is passed to
  38226. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38227. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38228. methods.</para>
  38229. </remarks>
  38230. <example>
  38231. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  38232. </example>
  38233. <value>The attachments.</value>
  38234. </member>
  38235. <member name="P:MailKit.IMessageSummary.PreviewText">
  38236. <summary>
  38237. Gets the preview text of the message.
  38238. </summary>
  38239. <remarks>
  38240. <para>The preview text is a short snippet of the beginning of the message
  38241. text, typically shown in a mail client's message list to provide the user
  38242. with a sense of what the message is about.</para>
  38243. <para>This property will only be set if the
  38244. <see cref="F:MailKit.MessageSummaryItems.PreviewText"/> flag is passed to
  38245. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38246. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38247. methods.</para>
  38248. </remarks>
  38249. <value>The preview text.</value>
  38250. </member>
  38251. <member name="P:MailKit.IMessageSummary.Envelope">
  38252. <summary>
  38253. Gets the envelope of the message, if available.
  38254. </summary>
  38255. <remarks>
  38256. <para>The envelope of a message contains information such as the
  38257. date the message was sent, the subject of the message,
  38258. the sender of the message, who the message was sent to,
  38259. which message(s) the message may be in reply to,
  38260. and the message id.</para>
  38261. <para>This property will only be set if the
  38262. <see cref="F:MailKit.MessageSummaryItems.Envelope"/> flag is passed to
  38263. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38264. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38265. methods.</para>
  38266. </remarks>
  38267. <value>The envelope of the message.</value>
  38268. </member>
  38269. <member name="P:MailKit.IMessageSummary.NormalizedSubject">
  38270. <summary>
  38271. Gets the normalized subject.
  38272. </summary>
  38273. <remarks>
  38274. <para>A normalized <c>Subject</c> header value where prefixes such as <c>"Re:"</c>, <c>"Re[#]:"</c> and <c>"FWD:"</c> have been pruned.</para>
  38275. <para>This property is typically used for threading messages by subject.</para>
  38276. </remarks>
  38277. <value>The normalized subject.</value>
  38278. </member>
  38279. <member name="P:MailKit.IMessageSummary.Date">
  38280. <summary>
  38281. Gets the Date header value.
  38282. </summary>
  38283. <remarks>
  38284. Gets the Date header value. If the Date header is not present, the arrival date is used.
  38285. If neither are known, <see cref="F:System.DateTimeOffset.MinValue"/> is returned.
  38286. </remarks>
  38287. <value>The date.</value>
  38288. </member>
  38289. <member name="P:MailKit.IMessageSummary.IsReply">
  38290. <summary>
  38291. Gets whether or not the message is a reply.
  38292. </summary>
  38293. <remarks>
  38294. This value should be based on whether the message subject contained any <c>"Re:"</c>, <c>"Re[#]:"</c> or <c>"FWD:"</c> prefixes.
  38295. </remarks>
  38296. <value><c>true</c> if the message is a reply; otherwise, <c>false</c>.</value>
  38297. </member>
  38298. <member name="P:MailKit.IMessageSummary.Flags">
  38299. <summary>
  38300. Gets the message flags, if available.
  38301. </summary>
  38302. <remarks>
  38303. <para>Gets the message flags, if available.</para>
  38304. <para>This property will only be set if the
  38305. <see cref="F:MailKit.MessageSummaryItems.Flags"/> flag is passed to
  38306. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38307. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38308. methods.</para>
  38309. </remarks>
  38310. <value>The message flags.</value>
  38311. </member>
  38312. <member name="P:MailKit.IMessageSummary.Keywords">
  38313. <summary>
  38314. Gets the user-defined message flags, if available.
  38315. </summary>
  38316. <remarks>
  38317. <para>Gets the user-defined message flags, if available.</para>
  38318. <para>This property will only be set if the
  38319. <see cref="F:MailKit.MessageSummaryItems.Flags"/> flag is passed to
  38320. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38321. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38322. methods.</para>
  38323. </remarks>
  38324. <value>The user-defined message flags.</value>
  38325. </member>
  38326. <member name="P:MailKit.IMessageSummary.UserFlags">
  38327. <summary>
  38328. Gets the user-defined message flags, if available.
  38329. </summary>
  38330. <remarks>
  38331. <para>Gets the user-defined message flags, if available.</para>
  38332. <para>This property will only be set if the
  38333. <see cref="F:MailKit.MessageSummaryItems.Flags"/> flag is passed to
  38334. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38335. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38336. methods.</para>
  38337. </remarks>
  38338. <value>The user-defined message flags.</value>
  38339. </member>
  38340. <member name="P:MailKit.IMessageSummary.Annotations">
  38341. <summary>
  38342. Gets the message annotations, if available.
  38343. </summary>
  38344. <remarks>
  38345. <para>Gets the message annotations, if available.</para>
  38346. <para>This property will only be set if the
  38347. <see cref="F:MailKit.MessageSummaryItems.Annotations"/> flag is passed to
  38348. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38349. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38350. methods.</para>
  38351. </remarks>
  38352. <value>The message annotations.</value>
  38353. </member>
  38354. <member name="P:MailKit.IMessageSummary.Headers">
  38355. <summary>
  38356. Gets the list of headers, if available.
  38357. </summary>
  38358. <remarks>
  38359. <para>Gets the list of headers, if available.</para>
  38360. <para>This property will only be set if <see cref="F:MailKit.MessageSummaryItems.Headers"/>
  38361. is specified in a call to one of the
  38362. <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38363. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38364. methods or specific headers are requested via a one of the Fetch or FetchAsync methods
  38365. that accept list of specific headers to request for each message such as
  38366. <see cref="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)"/>.
  38367. </para>
  38368. </remarks>
  38369. <value>The list of headers.</value>
  38370. </member>
  38371. <member name="P:MailKit.IMessageSummary.InternalDate">
  38372. <summary>
  38373. Gets the internal date of the message, if available.
  38374. </summary>
  38375. <remarks>
  38376. <para>Gets the internal date of the message (often the same date as found in the <c>Received</c> header), if available.</para>
  38377. <para>This property will only be set if the
  38378. <see cref="F:MailKit.MessageSummaryItems.InternalDate"/> flag is passed to
  38379. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38380. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38381. methods.</para>
  38382. </remarks>
  38383. <value>The internal date of the message.</value>
  38384. </member>
  38385. <member name="P:MailKit.IMessageSummary.Size">
  38386. <summary>
  38387. Gets the size of the message, in bytes, if available.
  38388. </summary>
  38389. <remarks>
  38390. <para>Gets the size of the message, in bytes, if available.</para>
  38391. <para>This property will only be set if the
  38392. <see cref="F:MailKit.MessageSummaryItems.Size"/> flag is passed to
  38393. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38394. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38395. methods.</para>
  38396. </remarks>
  38397. <value>The size of the message.</value>
  38398. </member>
  38399. <member name="P:MailKit.IMessageSummary.ModSeq">
  38400. <summary>
  38401. Gets the mod-sequence value for the message, if available.
  38402. </summary>
  38403. <remarks>
  38404. <para>Gets the mod-sequence value for the message, if available.</para>
  38405. <para>This property will only be set if the
  38406. <see cref="F:MailKit.MessageSummaryItems.ModSeq"/> flag is passed to
  38407. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38408. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38409. methods.</para>
  38410. </remarks>
  38411. <value>The mod-sequence value.</value>
  38412. </member>
  38413. <member name="P:MailKit.IMessageSummary.References">
  38414. <summary>
  38415. Gets the message-ids that the message references, if available.
  38416. </summary>
  38417. <remarks>
  38418. <para>Gets the message-ids that the message references, if available.</para>
  38419. <para>This property will only be set if the
  38420. <see cref="F:MailKit.MessageSummaryItems.References"/> flag is passed to
  38421. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38422. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38423. methods.</para>
  38424. </remarks>
  38425. <value>The references.</value>
  38426. </member>
  38427. <member name="P:MailKit.IMessageSummary.EmailId">
  38428. <summary>
  38429. Get the globally unique identifier for the message, if available.
  38430. </summary>
  38431. <remarks>
  38432. <para>Gets the globally unique identifier of the message, if available.</para>
  38433. <para>This property will only be set if the
  38434. <see cref="F:MailKit.MessageSummaryItems.EmailId"/> flag is passed to
  38435. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38436. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38437. methods.</para>
  38438. <note type="info">This property maps to the <c>EMAILID</c> value defined in the
  38439. <a href="https://tools.ietf.org/html/rfc8474">OBJECTID</a> extension.</note>
  38440. </remarks>
  38441. <value>The globally unique message identifier.</value>
  38442. </member>
  38443. <member name="P:MailKit.IMessageSummary.Id">
  38444. <summary>
  38445. Get the globally unique identifier for the message, if available.
  38446. </summary>
  38447. <remarks>
  38448. <para>Gets the globally unique identifier of the message, if available.</para>
  38449. <para>This property will only be set if the
  38450. <see cref="F:MailKit.MessageSummaryItems.EmailId"/> flag is passed to
  38451. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38452. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38453. methods.</para>
  38454. <note type="info">This property maps to the <c>EMAILID</c> value defined in the
  38455. <a href="https://tools.ietf.org/html/rfc8474">OBJECTID</a> extension.</note>
  38456. </remarks>
  38457. <value>The globally unique message identifier.</value>
  38458. </member>
  38459. <member name="P:MailKit.IMessageSummary.ThreadId">
  38460. <summary>
  38461. Get the globally unique thread identifier for the message, if available.
  38462. </summary>
  38463. <remarks>
  38464. <para>Gets the globally unique thread identifier for the message, if available.</para>
  38465. <para>This property will only be set if the
  38466. <see cref="F:MailKit.MessageSummaryItems.ThreadId"/> flag is passed to
  38467. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38468. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38469. methods.</para>
  38470. <note type="info">This property maps to the <c>THREADID</c> value defined in the
  38471. <a href="https://tools.ietf.org/html/rfc8474">OBJECTID</a> extension.</note>
  38472. </remarks>
  38473. <value>The globally unique thread identifier.</value>
  38474. </member>
  38475. <member name="P:MailKit.IMessageSummary.UniqueId">
  38476. <summary>
  38477. Gets the unique identifier of the message, if available.
  38478. </summary>
  38479. <remarks>
  38480. <para>Gets the unique identifier of the message, if available.</para>
  38481. <para>This property will only be set if the
  38482. <see cref="F:MailKit.MessageSummaryItems.UniqueId"/> flag is passed to
  38483. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38484. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38485. methods.</para>
  38486. </remarks>
  38487. <value>The uid of the message.</value>
  38488. </member>
  38489. <member name="P:MailKit.IMessageSummary.Index">
  38490. <summary>
  38491. Gets the index of the message.
  38492. </summary>
  38493. <remarks>
  38494. <para>Gets the index of the message.</para>
  38495. <para>This property is always set.</para>
  38496. </remarks>
  38497. <value>The index of the message.</value>
  38498. </member>
  38499. <member name="P:MailKit.IMessageSummary.GMailMessageId">
  38500. <summary>
  38501. Gets the GMail message identifier, if available.
  38502. </summary>
  38503. <remarks>
  38504. <para>Gets the GMail message identifier, if available.</para>
  38505. <para>This property will only be set if the
  38506. <see cref="F:MailKit.MessageSummaryItems.GMailMessageId"/> flag is passed to
  38507. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38508. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38509. methods.</para>
  38510. </remarks>
  38511. <value>The GMail message identifier.</value>
  38512. </member>
  38513. <member name="P:MailKit.IMessageSummary.GMailThreadId">
  38514. <summary>
  38515. Gets the GMail thread identifier, if available.
  38516. </summary>
  38517. <remarks>
  38518. <para>Gets the GMail thread identifier, if available.</para>
  38519. <para>This property will only be set if the
  38520. <see cref="F:MailKit.MessageSummaryItems.GMailThreadId"/> flag is passed to
  38521. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38522. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38523. methods.</para>
  38524. </remarks>
  38525. <value>The GMail thread identifier.</value>
  38526. </member>
  38527. <member name="P:MailKit.IMessageSummary.GMailLabels">
  38528. <summary>
  38529. Gets the list of GMail labels, if available.
  38530. </summary>
  38531. <remarks>
  38532. <para>Gets the list of GMail labels, if available.</para>
  38533. <para>This property will only be set if the
  38534. <see cref="F:MailKit.MessageSummaryItems.GMailLabels"/> flag is passed to
  38535. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  38536. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  38537. methods.</para>
  38538. </remarks>
  38539. <value>The GMail labels.</value>
  38540. </member>
  38541. <member name="T:MailKit.IProtocolLogger">
  38542. <summary>
  38543. An interface for logging the communication between a client and server.
  38544. </summary>
  38545. <remarks>
  38546. An interface for logging the communication between a client and server.
  38547. </remarks>
  38548. <example>
  38549. <code language="c#" source="Examples\SmtpExamples.cs" region="ProtocolLogger" />
  38550. </example>
  38551. </member>
  38552. <member name="M:MailKit.IProtocolLogger.LogConnect(System.Uri)">
  38553. <summary>
  38554. Logs a connection to the specified URI.
  38555. </summary>
  38556. <remarks>
  38557. Logs a connection to the specified URI.
  38558. </remarks>
  38559. <param name="uri">The URI.</param>
  38560. <exception cref="T:System.ArgumentNullException">
  38561. <paramref name="uri"/> is <c>null</c>.
  38562. </exception>
  38563. <exception cref="T:System.ObjectDisposedException">
  38564. The logger has been disposed.
  38565. </exception>
  38566. <exception cref="T:System.IO.IOException">
  38567. An I/O error occurred.
  38568. </exception>
  38569. </member>
  38570. <member name="M:MailKit.IProtocolLogger.LogClient(System.Byte[],System.Int32,System.Int32)">
  38571. <summary>
  38572. Logs a sequence of bytes sent by the client.
  38573. </summary>
  38574. <remarks>
  38575. <para>Logs a sequence of bytes sent by the client.</para>
  38576. <para><see cref="M:MailKit.IProtocolLogger.LogClient(System.Byte[],System.Int32,System.Int32)"/> is called by the <see cref="T:MailKit.IMailService"/> upon every successful
  38577. write operation to its underlying network stream, passing the exact same <paramref name="buffer"/>,
  38578. <paramref name="offset"/>, and <paramref name="count"/> arguments to the logging function.</para>
  38579. </remarks>
  38580. <param name='buffer'>The buffer to log.</param>
  38581. <param name='offset'>The offset of the first byte to log.</param>
  38582. <param name='count'>The number of bytes to log.</param>
  38583. <exception cref="T:System.ArgumentNullException">
  38584. <paramref name="buffer"/> is <c>null</c>.
  38585. </exception>
  38586. <exception cref="T:System.ArgumentOutOfRangeException">
  38587. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  38588. <para>-or-</para>
  38589. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  38590. at the specified <paramref name="offset"/>.</para>
  38591. </exception>
  38592. <exception cref="T:System.ObjectDisposedException">
  38593. The logger has been disposed.
  38594. </exception>
  38595. <exception cref="T:System.IO.IOException">
  38596. An I/O error occurred.
  38597. </exception>
  38598. </member>
  38599. <member name="M:MailKit.IProtocolLogger.LogServer(System.Byte[],System.Int32,System.Int32)">
  38600. <summary>
  38601. Logs a sequence of bytes sent by the server.
  38602. </summary>
  38603. <remarks>
  38604. <para>Logs a sequence of bytes sent by the server.</para>
  38605. <para><see cref="M:MailKit.IProtocolLogger.LogServer(System.Byte[],System.Int32,System.Int32)"/> is called by the <see cref="T:MailKit.IMailService"/> upon every successful
  38606. read of its underlying network stream with the exact buffer that was read.</para>
  38607. </remarks>
  38608. <param name='buffer'>The buffer to log.</param>
  38609. <param name='offset'>The offset of the first byte to log.</param>
  38610. <param name='count'>The number of bytes to log.</param>
  38611. <exception cref="T:System.ArgumentNullException">
  38612. <paramref name="buffer"/> is <c>null</c>.
  38613. </exception>
  38614. <exception cref="T:System.ArgumentOutOfRangeException">
  38615. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  38616. <para>-or-</para>
  38617. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  38618. at the specified <paramref name="offset"/>.</para>
  38619. </exception>
  38620. <exception cref="T:System.ObjectDisposedException">
  38621. The logger has been disposed.
  38622. </exception>
  38623. <exception cref="T:System.IO.IOException">
  38624. An I/O error occurred.
  38625. </exception>
  38626. </member>
  38627. <member name="T:MailKit.ITransferProgress">
  38628. <summary>
  38629. An interface for reporting progress of uploading or downloading messages.
  38630. </summary>
  38631. <remarks>
  38632. An interface for reporting progress of uploading or downloading messages.
  38633. </remarks>
  38634. </member>
  38635. <member name="M:MailKit.ITransferProgress.Report(System.Int64,System.Int64)">
  38636. <summary>
  38637. Report the progress of the transfer operation.
  38638. </summary>
  38639. <remarks>
  38640. <para>Reports the progress of the transfer operation.</para>
  38641. <para>This method is only used if the operation knows the size
  38642. of the message, part, or stream being transferred without doing
  38643. extra work to calculate it.</para>
  38644. </remarks>
  38645. <param name="bytesTransferred">The number of bytes transferred.</param>
  38646. <param name="totalSize">The total size, in bytes, of the message, part, or stream being transferred.</param>
  38647. </member>
  38648. <member name="M:MailKit.ITransferProgress.Report(System.Int64)">
  38649. <summary>
  38650. Report the progress of the transfer operation.
  38651. </summary>
  38652. <remarks>
  38653. <para>Reports the progress of the transfer operation.</para>
  38654. </remarks>
  38655. <param name="bytesTransferred">The number of bytes transferred.</param>
  38656. </member>
  38657. <member name="T:MailKit.MailFolder">
  38658. <summary>
  38659. An abstract mail folder implementation.
  38660. </summary>
  38661. <remarks>
  38662. An abstract mail folder implementation.
  38663. </remarks>
  38664. </member>
  38665. <member name="F:MailKit.MailFolder.SettableFlags">
  38666. <summary>
  38667. The bit mask of settable flags.
  38668. </summary>
  38669. <remarks>
  38670. Only flags in the list of settable flags may be set on a message by the client.
  38671. </remarks>
  38672. </member>
  38673. <member name="M:MailKit.MailFolder.#ctor">
  38674. <summary>
  38675. Initialize a new instance of the <see cref="T:MailKit.MailFolder"/> class.
  38676. </summary>
  38677. <remarks>
  38678. Initializes a new instance of the <see cref="T:MailKit.MailFolder"/> class.
  38679. </remarks>
  38680. </member>
  38681. <member name="P:MailKit.MailFolder.SyncRoot">
  38682. <summary>
  38683. Get an object that can be used to synchronize access to the folder.
  38684. </summary>
  38685. <remarks>
  38686. <para>Gets an object that can be used to synchronize access to the folder.</para>
  38687. </remarks>
  38688. <value>The sync root.</value>
  38689. </member>
  38690. <member name="P:MailKit.MailFolder.ParentFolder">
  38691. <summary>
  38692. Get the parent folder.
  38693. </summary>
  38694. <remarks>
  38695. Root-level folders do not have a parent folder.
  38696. </remarks>
  38697. <value>The parent folder.</value>
  38698. </member>
  38699. <member name="P:MailKit.MailFolder.Attributes">
  38700. <summary>
  38701. Get the folder attributes.
  38702. </summary>
  38703. <remarks>
  38704. Gets the folder attributes.
  38705. </remarks>
  38706. <value>The folder attributes.</value>
  38707. </member>
  38708. <member name="P:MailKit.MailFolder.AnnotationAccess">
  38709. <summary>
  38710. Get the annotation access level.
  38711. </summary>
  38712. <remarks>
  38713. If annotations are supported, this property can be used to determine whether or not
  38714. the <see cref="T:MailKit.IMailFolder"/> supports reading and writing annotations.
  38715. </remarks>
  38716. </member>
  38717. <member name="P:MailKit.MailFolder.AnnotationScopes">
  38718. <summary>
  38719. Get the supported annotation scopes.
  38720. </summary>
  38721. <remarks>
  38722. If annotations are supported, this property can be used to determine which
  38723. annotation scopes are supported by the <see cref="T:MailKit.IMailFolder"/>.
  38724. </remarks>
  38725. </member>
  38726. <member name="P:MailKit.MailFolder.MaxAnnotationSize">
  38727. <summary>
  38728. Get the maximum size of annotation values supported by the folder.
  38729. </summary>
  38730. <remarks>
  38731. If annotations are supported, this property can be used to determine the
  38732. maximum size of annotation values supported by the <see cref="T:MailKit.IMailFolder"/>.
  38733. </remarks>
  38734. </member>
  38735. <member name="P:MailKit.MailFolder.PermanentFlags">
  38736. <summary>
  38737. Get the permanent flags.
  38738. </summary>
  38739. <remarks>
  38740. <para>The permanent flags are the message flags that will persist between sessions.</para>
  38741. <para>If the <see cref="F:MailKit.MessageFlags.UserDefined"/> flag is set, then the folder allows
  38742. storing of user-defined (custom) message flags.</para>
  38743. </remarks>
  38744. <value>The permanent flags.</value>
  38745. </member>
  38746. <member name="P:MailKit.MailFolder.AcceptedFlags">
  38747. <summary>
  38748. Get the accepted flags.
  38749. </summary>
  38750. <remarks>
  38751. The accepted flags are the message flags that will be accepted and persist
  38752. for the current session. For the set of flags that will persist between
  38753. sessions, see the <see cref="P:MailKit.MailFolder.PermanentFlags"/> property.
  38754. </remarks>
  38755. <value>The accepted flags.</value>
  38756. </member>
  38757. <member name="P:MailKit.MailFolder.DirectorySeparator">
  38758. <summary>
  38759. Get the directory separator.
  38760. </summary>
  38761. <remarks>
  38762. Gets the directory separator.
  38763. </remarks>
  38764. <value>The directory separator.</value>
  38765. </member>
  38766. <member name="P:MailKit.MailFolder.Access">
  38767. <summary>
  38768. Get the read/write access of the folder.
  38769. </summary>
  38770. <remarks>
  38771. Gets the read/write access of the folder.
  38772. </remarks>
  38773. <value>The read/write access.</value>
  38774. </member>
  38775. <member name="P:MailKit.MailFolder.IsNamespace">
  38776. <summary>
  38777. Get whether or not the folder is a namespace folder.
  38778. </summary>
  38779. <remarks>
  38780. Gets whether or not the folder is a namespace folder.
  38781. </remarks>
  38782. <value><c>true</c> if the folder is a namespace folder; otherwise, <c>false</c>.</value>
  38783. </member>
  38784. <member name="P:MailKit.MailFolder.FullName">
  38785. <summary>
  38786. Get the full name of the folder.
  38787. </summary>
  38788. <remarks>
  38789. This is the equivalent of the full path of a file on a file system.
  38790. </remarks>
  38791. <value>The full name of the folder.</value>
  38792. </member>
  38793. <member name="P:MailKit.MailFolder.Name">
  38794. <summary>
  38795. Get the name of the folder.
  38796. </summary>
  38797. <remarks>
  38798. This is the equivalent of the file name of a file on the file system.
  38799. </remarks>
  38800. <value>The name of the folder.</value>
  38801. </member>
  38802. <member name="P:MailKit.MailFolder.Id">
  38803. <summary>
  38804. Get the unique identifier for the folder, if available.
  38805. </summary>
  38806. <remarks>
  38807. <para>Gets a unique identifier for the folder, if available. This is useful for clients
  38808. implementing a message cache that want to track the folder after it is renamed by another
  38809. client.</para>
  38810. <note type="note">This property will only be available if the server supports the
  38811. <a href="https://tools.ietf.org/html/rfc8474">OBJECTID</a> extension.</note>
  38812. </remarks>
  38813. <value>The unique folder identifier.</value>
  38814. </member>
  38815. <member name="P:MailKit.MailFolder.IsSubscribed">
  38816. <summary>
  38817. Get a value indicating whether the folder is subscribed.
  38818. </summary>
  38819. <remarks>
  38820. Gets a value indicating whether the folder is subscribed.
  38821. </remarks>
  38822. <value><c>true</c> if the folder is subscribed; otherwise, <c>false</c>.</value>
  38823. </member>
  38824. <member name="P:MailKit.MailFolder.IsOpen">
  38825. <summary>
  38826. Get a value indicating whether the folder is currently open.
  38827. </summary>
  38828. <remarks>
  38829. Gets a value indicating whether the folder is currently open.
  38830. </remarks>
  38831. <value><c>true</c> if the folder is currently open; otherwise, <c>false</c>.</value>
  38832. </member>
  38833. <member name="P:MailKit.MailFolder.Exists">
  38834. <summary>
  38835. Get a value indicating whether the folder exists.
  38836. </summary>
  38837. <remarks>
  38838. Gets a value indicating whether the folder exists.
  38839. </remarks>
  38840. <value><c>true</c> if the folder exists; otherwise, <c>false</c>.</value>
  38841. </member>
  38842. <member name="P:MailKit.MailFolder.SupportsModSeq">
  38843. <summary>
  38844. Get whether or not the folder supports mod-sequences.
  38845. </summary>
  38846. <remarks>
  38847. <para>If mod-sequences are not supported by the folder, then all of the APIs that take a modseq
  38848. argument will throw <see cref="T:System.NotSupportedException"/> and should not be used.</para>
  38849. </remarks>
  38850. <value><c>true</c> if supports mod-sequences; otherwise, <c>false</c>.</value>
  38851. </member>
  38852. <member name="P:MailKit.MailFolder.HighestModSeq">
  38853. <summary>
  38854. Get the highest mod-sequence value of all messages in the mailbox.
  38855. </summary>
  38856. <remarks>
  38857. Gets the highest mod-sequence value of all messages in the mailbox.
  38858. </remarks>
  38859. <value>The highest mod-sequence value.</value>
  38860. </member>
  38861. <member name="P:MailKit.MailFolder.UidValidity">
  38862. <summary>
  38863. Get the UID validity.
  38864. </summary>
  38865. <remarks>
  38866. <para>UIDs are only valid so long as the UID validity value remains unchanged. If and when
  38867. the folder's <see cref="P:MailKit.MailFolder.UidValidity"/> is changed, a client MUST discard its cache of UIDs
  38868. along with any summary information that it may have and re-query the folder.</para>
  38869. <para>This value will only be set after the folder has been opened.</para>
  38870. </remarks>
  38871. <value>The UID validity.</value>
  38872. </member>
  38873. <member name="P:MailKit.MailFolder.UidNext">
  38874. <summary>
  38875. Get the UID that the folder will assign to the next message that is added.
  38876. </summary>
  38877. <remarks>
  38878. This value will only be set after the folder has been opened.
  38879. </remarks>
  38880. <value>The next UID.</value>
  38881. </member>
  38882. <member name="P:MailKit.MailFolder.AppendLimit">
  38883. <summary>
  38884. Get the maximum size of a message that can be appended to the folder.
  38885. </summary>
  38886. <remarks>
  38887. <para>Gets the maximum size of a message that can be appended to the folder.</para>
  38888. <note type="note">If the value is not set, then the limit is unspecified.</note>
  38889. </remarks>
  38890. <value>The append limit.</value>
  38891. </member>
  38892. <member name="P:MailKit.MailFolder.Size">
  38893. <summary>
  38894. Get the size of the folder.
  38895. </summary>
  38896. <remarks>
  38897. <para>Gets the size of the folder in bytes.</para>
  38898. <note type="note">If the value is not set, then the size is unspecified.</note>
  38899. </remarks>
  38900. <value>The size.</value>
  38901. </member>
  38902. <member name="P:MailKit.MailFolder.FirstUnread">
  38903. <summary>
  38904. Get the index of the first unread message in the folder.
  38905. </summary>
  38906. <remarks>
  38907. This value will only be set after the folder has been opened.
  38908. </remarks>
  38909. <value>The index of the first unread message.</value>
  38910. </member>
  38911. <member name="P:MailKit.MailFolder.Unread">
  38912. <summary>
  38913. Get the number of unread messages in the folder.
  38914. </summary>
  38915. <remarks>
  38916. <para>Gets the number of unread messages in the folder.</para>
  38917. <note type="note">This value will only be set after calling
  38918. <see cref="M:MailKit.MailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/>
  38919. with <see cref="F:MailKit.StatusItems.Unread"/>.</note>
  38920. </remarks>
  38921. <value>The number of unread messages.</value>
  38922. </member>
  38923. <member name="P:MailKit.MailFolder.Recent">
  38924. <summary>
  38925. Get the number of recently added messages in the folder.
  38926. </summary>
  38927. <remarks>
  38928. <para>Gets the number of recently delivered messages in the folder.</para>
  38929. <note type="note">This value will only be set after calling
  38930. <see cref="M:MailKit.MailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/>
  38931. with <see cref="F:MailKit.StatusItems.Recent"/> or by opening the folder.</note>
  38932. </remarks>
  38933. <value>The number of recently added messages.</value>
  38934. </member>
  38935. <member name="P:MailKit.MailFolder.Count">
  38936. <summary>
  38937. Get the total number of messages in the folder.
  38938. </summary>
  38939. <remarks>
  38940. <para>Gets the total number of messages in the folder.</para>
  38941. <note type="note">This value will only be set after calling
  38942. <see cref="M:MailKit.MailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/>
  38943. with <see cref="F:MailKit.StatusItems.Count"/> or by opening the folder.</note>
  38944. </remarks>
  38945. <value>The total number of messages.</value>
  38946. </member>
  38947. <member name="M:MailKit.MailFolder.Open(MailKit.FolderAccess,System.UInt32,System.UInt64,System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)">
  38948. <summary>
  38949. Opens the folder using the requested folder access.
  38950. </summary>
  38951. <remarks>
  38952. <para>This variant of the <see cref="M:MailKit.MailFolder.Open(MailKit.FolderAccess,System.Threading.CancellationToken)"/>
  38953. method is meant for quick resynchronization of the folder. Before calling this method,
  38954. the <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/> method MUST be called.</para>
  38955. <para>You should also make sure to add listeners to the <see cref="E:MailKit.MailFolder.MessagesVanished"/> and
  38956. <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events to get notifications of changes since
  38957. the last time the folder was opened.</para>
  38958. </remarks>
  38959. <returns>The <see cref="T:MailKit.FolderAccess"/> state of the folder.</returns>
  38960. <param name="access">The requested folder access.</param>
  38961. <param name="uidValidity">The last known <see cref="P:MailKit.MailFolder.UidValidity"/> value.</param>
  38962. <param name="highestModSeq">The last known <see cref="P:MailKit.MailFolder.HighestModSeq"/> value.</param>
  38963. <param name="uids">The last known list of unique message identifiers.</param>
  38964. <param name="cancellationToken">The cancellation token.</param>
  38965. <exception cref="T:System.ArgumentOutOfRangeException">
  38966. <paramref name="access"/> is not a valid value.
  38967. </exception>
  38968. <exception cref="T:System.ObjectDisposedException">
  38969. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  38970. </exception>
  38971. <exception cref="T:MailKit.ServiceNotConnectedException">
  38972. The <see cref="T:MailKit.IMailStore"/> is not connected.
  38973. </exception>
  38974. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  38975. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  38976. </exception>
  38977. <exception cref="T:MailKit.FolderNotFoundException">
  38978. The <see cref="T:MailKit.MailFolder"/> does not exist.
  38979. </exception>
  38980. <exception cref="T:System.InvalidOperationException">
  38981. The quick resynchronization feature has not been enabled.
  38982. </exception>
  38983. <exception cref="T:System.NotSupportedException">
  38984. The mail store does not support the quick resynchronization feature.
  38985. </exception>
  38986. <exception cref="T:System.OperationCanceledException">
  38987. The operation was canceled via the cancellation token.
  38988. </exception>
  38989. <exception cref="T:System.IO.IOException">
  38990. An I/O error occurred.
  38991. </exception>
  38992. <exception cref="T:MailKit.ProtocolException">
  38993. The server's response contained unexpected tokens.
  38994. </exception>
  38995. <exception cref="T:MailKit.CommandException">
  38996. The command failed.
  38997. </exception>
  38998. </member>
  38999. <member name="M:MailKit.MailFolder.OpenAsync(MailKit.FolderAccess,System.UInt32,System.UInt64,System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)">
  39000. <summary>
  39001. Asynchronously opens the folder using the requested folder access.
  39002. </summary>
  39003. <remarks>
  39004. <para>This variant of the <see cref="M:MailKit.MailFolder.OpenAsync(MailKit.FolderAccess,System.Threading.CancellationToken)"/>
  39005. method is meant for quick resynchronization of the folder. Before calling this method,
  39006. the <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/> method MUST be called.</para>
  39007. <para>You should also make sure to add listeners to the <see cref="E:MailKit.MailFolder.MessagesVanished"/> and
  39008. <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events to get notifications of changes since
  39009. the last time the folder was opened.</para>
  39010. </remarks>
  39011. <returns>The <see cref="T:MailKit.FolderAccess"/> state of the folder.</returns>
  39012. <param name="access">The requested folder access.</param>
  39013. <param name="uidValidity">The last known <see cref="P:MailKit.MailFolder.UidValidity"/> value.</param>
  39014. <param name="highestModSeq">The last known <see cref="P:MailKit.MailFolder.HighestModSeq"/> value.</param>
  39015. <param name="uids">The last known list of unique message identifiers.</param>
  39016. <param name="cancellationToken">The cancellation token.</param>
  39017. <exception cref="T:System.ArgumentOutOfRangeException">
  39018. <paramref name="access"/> is not a valid value.
  39019. </exception>
  39020. <exception cref="T:System.ObjectDisposedException">
  39021. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39022. </exception>
  39023. <exception cref="T:MailKit.ServiceNotConnectedException">
  39024. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39025. </exception>
  39026. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39027. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39028. </exception>
  39029. <exception cref="T:MailKit.FolderNotFoundException">
  39030. The <see cref="T:MailKit.MailFolder"/> does not exist.
  39031. </exception>
  39032. <exception cref="T:System.InvalidOperationException">
  39033. The quick resynchronization feature has not been enabled.
  39034. </exception>
  39035. <exception cref="T:System.NotSupportedException">
  39036. The mail store does not support the quick resynchronization feature.
  39037. </exception>
  39038. <exception cref="T:System.OperationCanceledException">
  39039. The operation was canceled via the cancellation token.
  39040. </exception>
  39041. <exception cref="T:System.IO.IOException">
  39042. An I/O error occurred.
  39043. </exception>
  39044. <exception cref="T:MailKit.ProtocolException">
  39045. The server's response contained unexpected tokens.
  39046. </exception>
  39047. <exception cref="T:MailKit.CommandException">
  39048. The command failed.
  39049. </exception>
  39050. </member>
  39051. <member name="M:MailKit.MailFolder.Open(MailKit.FolderAccess,System.Threading.CancellationToken)">
  39052. <summary>
  39053. Open the folder using the requested folder access.
  39054. </summary>
  39055. <remarks>
  39056. Opens the folder using the requested folder access.
  39057. </remarks>
  39058. <returns>The <see cref="T:MailKit.FolderAccess"/> state of the folder.</returns>
  39059. <param name="access">The requested folder access.</param>
  39060. <param name="cancellationToken">The cancellation token.</param>
  39061. <exception cref="T:System.ArgumentOutOfRangeException">
  39062. <paramref name="access"/> is not a valid value.
  39063. </exception>
  39064. <exception cref="T:System.ObjectDisposedException">
  39065. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39066. </exception>
  39067. <exception cref="T:MailKit.ServiceNotConnectedException">
  39068. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39069. </exception>
  39070. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39071. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39072. </exception>
  39073. <exception cref="T:MailKit.FolderNotFoundException">
  39074. The <see cref="T:MailKit.MailFolder"/> does not exist.
  39075. </exception>
  39076. <exception cref="T:System.OperationCanceledException">
  39077. The operation was canceled via the cancellation token.
  39078. </exception>
  39079. <exception cref="T:System.IO.IOException">
  39080. An I/O error occurred.
  39081. </exception>
  39082. <exception cref="T:MailKit.ProtocolException">
  39083. The server's response contained unexpected tokens.
  39084. </exception>
  39085. <exception cref="T:MailKit.CommandException">
  39086. The command failed.
  39087. </exception>
  39088. </member>
  39089. <member name="M:MailKit.MailFolder.OpenAsync(MailKit.FolderAccess,System.Threading.CancellationToken)">
  39090. <summary>
  39091. Asynchronously open the folder using the requested folder access.
  39092. </summary>
  39093. <remarks>
  39094. Asynchronously opens the folder using the requested folder access.
  39095. </remarks>
  39096. <returns>The <see cref="T:MailKit.FolderAccess"/> state of the folder.</returns>
  39097. <param name="access">The requested folder access.</param>
  39098. <param name="cancellationToken">The cancellation token.</param>
  39099. <exception cref="T:System.ArgumentOutOfRangeException">
  39100. <paramref name="access"/> is not a valid value.
  39101. </exception>
  39102. <exception cref="T:System.ObjectDisposedException">
  39103. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39104. </exception>
  39105. <exception cref="T:MailKit.ServiceNotConnectedException">
  39106. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39107. </exception>
  39108. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39109. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39110. </exception>
  39111. <exception cref="T:MailKit.FolderNotFoundException">
  39112. The <see cref="T:MailKit.MailFolder"/> does not exist.
  39113. </exception>
  39114. <exception cref="T:System.OperationCanceledException">
  39115. The operation was canceled via the cancellation token.
  39116. </exception>
  39117. <exception cref="T:System.IO.IOException">
  39118. An I/O error occurred.
  39119. </exception>
  39120. <exception cref="T:MailKit.ProtocolException">
  39121. The server's response contained unexpected tokens.
  39122. </exception>
  39123. <exception cref="T:MailKit.CommandException">
  39124. The command failed.
  39125. </exception>
  39126. </member>
  39127. <member name="M:MailKit.MailFolder.Close(System.Boolean,System.Threading.CancellationToken)">
  39128. <summary>
  39129. Close the folder, optionally expunging the messages marked for deletion.
  39130. </summary>
  39131. <remarks>
  39132. Closes the folder, optionally expunging the messages marked for deletion.
  39133. </remarks>
  39134. <param name="expunge">If set to <c>true</c>, expunge.</param>
  39135. <param name="cancellationToken">The cancellation token.</param>
  39136. <exception cref="T:System.ObjectDisposedException">
  39137. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39138. </exception>
  39139. <exception cref="T:MailKit.ServiceNotConnectedException">
  39140. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39141. </exception>
  39142. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39143. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39144. </exception>
  39145. <exception cref="T:MailKit.FolderNotOpenException">
  39146. The folder is not currently open.
  39147. </exception>
  39148. <exception cref="T:System.OperationCanceledException">
  39149. The operation was canceled via the cancellation token.
  39150. </exception>
  39151. <exception cref="T:System.IO.IOException">
  39152. An I/O error occurred.
  39153. </exception>
  39154. <exception cref="T:MailKit.ProtocolException">
  39155. The server's response contained unexpected tokens.
  39156. </exception>
  39157. <exception cref="T:MailKit.CommandException">
  39158. The command failed.
  39159. </exception>
  39160. </member>
  39161. <member name="M:MailKit.MailFolder.CloseAsync(System.Boolean,System.Threading.CancellationToken)">
  39162. <summary>
  39163. Asynchronously close the folder, optionally expunging the messages marked for deletion.
  39164. </summary>
  39165. <remarks>
  39166. Asynchronously closes the folder, optionally expunging the messages marked for deletion.
  39167. </remarks>
  39168. <returns>An asynchronous task context.</returns>
  39169. <param name="expunge">If set to <c>true</c>, expunge.</param>
  39170. <param name="cancellationToken">The cancellation token.</param>
  39171. <exception cref="T:System.ObjectDisposedException">
  39172. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39173. </exception>
  39174. <exception cref="T:MailKit.ServiceNotConnectedException">
  39175. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39176. </exception>
  39177. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39178. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39179. </exception>
  39180. <exception cref="T:MailKit.FolderNotOpenException">
  39181. The folder is not currently open.
  39182. </exception>
  39183. <exception cref="T:System.OperationCanceledException">
  39184. The operation was canceled via the cancellation token.
  39185. </exception>
  39186. <exception cref="T:System.IO.IOException">
  39187. An I/O error occurred.
  39188. </exception>
  39189. <exception cref="T:MailKit.ProtocolException">
  39190. The server's response contained unexpected tokens.
  39191. </exception>
  39192. <exception cref="T:MailKit.CommandException">
  39193. The command failed.
  39194. </exception>
  39195. </member>
  39196. <member name="M:MailKit.MailFolder.Create(System.String,System.Boolean,System.Threading.CancellationToken)">
  39197. <summary>
  39198. Create a new subfolder with the given name.
  39199. </summary>
  39200. <remarks>
  39201. Creates a new subfolder with the given name.
  39202. </remarks>
  39203. <returns>The created folder.</returns>
  39204. <param name="name">The name of the folder to create.</param>
  39205. <param name="isMessageFolder"><c>true</c> if the folder will be used to contain messages; otherwise <c>false</c>.</param>
  39206. <param name="cancellationToken">The cancellation token.</param>
  39207. <exception cref="T:System.ArgumentNullException">
  39208. <paramref name="name"/> is <c>null</c>.
  39209. </exception>
  39210. <exception cref="T:System.ArgumentException">
  39211. <paramref name="name"/> is empty.
  39212. </exception>
  39213. <exception cref="T:System.ObjectDisposedException">
  39214. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39215. </exception>
  39216. <exception cref="T:MailKit.ServiceNotConnectedException">
  39217. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39218. </exception>
  39219. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39220. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39221. </exception>
  39222. <exception cref="T:System.InvalidOperationException">
  39223. The <see cref="P:MailKit.MailFolder.DirectorySeparator"/> is nil, and thus child folders cannot be created.
  39224. </exception>
  39225. <exception cref="T:System.OperationCanceledException">
  39226. The operation was canceled via the cancellation token.
  39227. </exception>
  39228. <exception cref="T:System.IO.IOException">
  39229. An I/O error occurred.
  39230. </exception>
  39231. <exception cref="T:MailKit.ProtocolException">
  39232. The server's response contained unexpected tokens.
  39233. </exception>
  39234. <exception cref="T:MailKit.CommandException">
  39235. The command failed.
  39236. </exception>
  39237. </member>
  39238. <member name="M:MailKit.MailFolder.CreateAsync(System.String,System.Boolean,System.Threading.CancellationToken)">
  39239. <summary>
  39240. Asynchronously create a new subfolder with the given name.
  39241. </summary>
  39242. <remarks>
  39243. Asynchronously creates a new subfolder with the given name.
  39244. </remarks>
  39245. <returns>The created folder.</returns>
  39246. <param name="name">The name of the folder to create.</param>
  39247. <param name="isMessageFolder"><c>true</c> if the folder will be used to contain messages; otherwise <c>false</c>.</param>
  39248. <param name="cancellationToken">The cancellation token.</param>
  39249. <exception cref="T:System.ArgumentNullException">
  39250. <paramref name="name"/> is <c>null</c>.
  39251. </exception>
  39252. <exception cref="T:System.ArgumentException">
  39253. <paramref name="name"/> is empty.
  39254. </exception>
  39255. <exception cref="T:System.ObjectDisposedException">
  39256. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39257. </exception>
  39258. <exception cref="T:MailKit.ServiceNotConnectedException">
  39259. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39260. </exception>
  39261. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39262. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39263. </exception>
  39264. <exception cref="T:System.InvalidOperationException">
  39265. The <see cref="P:MailKit.MailFolder.DirectorySeparator"/> is nil, and thus child folders cannot be created.
  39266. </exception>
  39267. <exception cref="T:System.OperationCanceledException">
  39268. The operation was canceled via the cancellation token.
  39269. </exception>
  39270. <exception cref="T:System.IO.IOException">
  39271. An I/O error occurred.
  39272. </exception>
  39273. <exception cref="T:MailKit.ProtocolException">
  39274. The server's response contained unexpected tokens.
  39275. </exception>
  39276. <exception cref="T:MailKit.CommandException">
  39277. The command failed.
  39278. </exception>
  39279. </member>
  39280. <member name="M:MailKit.MailFolder.Create(System.String,System.Collections.Generic.IEnumerable{MailKit.SpecialFolder},System.Threading.CancellationToken)">
  39281. <summary>
  39282. Create a new subfolder with the given name.
  39283. </summary>
  39284. <remarks>
  39285. Creates a new subfolder with the given name.
  39286. </remarks>
  39287. <returns>The created folder.</returns>
  39288. <param name="name">The name of the folder to create.</param>
  39289. <param name="specialUses">A list of special uses for the folder being created.</param>
  39290. <param name="cancellationToken">The cancellation token.</param>
  39291. <exception cref="T:System.ArgumentNullException">
  39292. <para><paramref name="name"/> is <c>null</c>.</para>
  39293. <para>-or-</para>
  39294. <para><paramref name="specialUses"/> is <c>null</c>.</para>
  39295. </exception>
  39296. <exception cref="T:System.ArgumentException">
  39297. <paramref name="name"/> is empty.
  39298. </exception>
  39299. <exception cref="T:System.ObjectDisposedException">
  39300. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39301. </exception>
  39302. <exception cref="T:MailKit.ServiceNotConnectedException">
  39303. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39304. </exception>
  39305. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39306. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39307. </exception>
  39308. <exception cref="T:System.InvalidOperationException">
  39309. The <see cref="P:MailKit.MailFolder.DirectorySeparator"/> is nil, and thus child folders cannot be created.
  39310. </exception>
  39311. <exception cref="T:System.NotSupportedException">
  39312. The <see cref="T:MailKit.MailService"/> does not support the creation of special folders.
  39313. </exception>
  39314. <exception cref="T:System.OperationCanceledException">
  39315. The operation was canceled via the cancellation token.
  39316. </exception>
  39317. <exception cref="T:System.IO.IOException">
  39318. An I/O error occurred.
  39319. </exception>
  39320. <exception cref="T:MailKit.ProtocolException">
  39321. The server's response contained unexpected tokens.
  39322. </exception>
  39323. <exception cref="T:MailKit.CommandException">
  39324. The command failed.
  39325. </exception>
  39326. </member>
  39327. <member name="M:MailKit.MailFolder.CreateAsync(System.String,System.Collections.Generic.IEnumerable{MailKit.SpecialFolder},System.Threading.CancellationToken)">
  39328. <summary>
  39329. Asynchronously create a new subfolder with the given name.
  39330. </summary>
  39331. <remarks>
  39332. Asynchronously creates a new subfolder with the given name.
  39333. </remarks>
  39334. <returns>The created folder.</returns>
  39335. <param name="name">The name of the folder to create.</param>
  39336. <param name="specialUses">A list of special uses for the folder being created.</param>
  39337. <param name="cancellationToken">The cancellation token.</param>
  39338. <exception cref="T:System.ArgumentNullException">
  39339. <para><paramref name="name"/> is <c>null</c>.</para>
  39340. <para>-or-</para>
  39341. <para><paramref name="specialUses"/> is <c>null</c>.</para>
  39342. </exception>
  39343. <exception cref="T:System.ArgumentException">
  39344. <paramref name="name"/> is empty.
  39345. </exception>
  39346. <exception cref="T:System.ObjectDisposedException">
  39347. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39348. </exception>
  39349. <exception cref="T:MailKit.ServiceNotConnectedException">
  39350. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39351. </exception>
  39352. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39353. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39354. </exception>
  39355. <exception cref="T:System.InvalidOperationException">
  39356. The <see cref="P:MailKit.MailFolder.DirectorySeparator"/> is nil, and thus child folders cannot be created.
  39357. </exception>
  39358. <exception cref="T:System.NotSupportedException">
  39359. The <see cref="T:MailKit.MailService"/> does not support the creation of special folders.
  39360. </exception>
  39361. <exception cref="T:System.OperationCanceledException">
  39362. The operation was canceled via the cancellation token.
  39363. </exception>
  39364. <exception cref="T:System.IO.IOException">
  39365. An I/O error occurred.
  39366. </exception>
  39367. <exception cref="T:MailKit.ProtocolException">
  39368. The server's response contained unexpected tokens.
  39369. </exception>
  39370. <exception cref="T:MailKit.CommandException">
  39371. The command failed.
  39372. </exception>
  39373. </member>
  39374. <member name="M:MailKit.MailFolder.Create(System.String,MailKit.SpecialFolder,System.Threading.CancellationToken)">
  39375. <summary>
  39376. Create a new subfolder with the given name.
  39377. </summary>
  39378. <remarks>
  39379. Creates a new subfolder with the given name.
  39380. </remarks>
  39381. <returns>The created folder.</returns>
  39382. <param name="name">The name of the folder to create.</param>
  39383. <param name="specialUse">The special use for the folder being created.</param>
  39384. <param name="cancellationToken">The cancellation token.</param>
  39385. <exception cref="T:System.ArgumentNullException">
  39386. <paramref name="name"/> is <c>null</c>.
  39387. </exception>
  39388. <exception cref="T:System.ArgumentException">
  39389. <paramref name="name"/> is empty.
  39390. </exception>
  39391. <exception cref="T:System.ObjectDisposedException">
  39392. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39393. </exception>
  39394. <exception cref="T:MailKit.ServiceNotConnectedException">
  39395. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39396. </exception>
  39397. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39398. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39399. </exception>
  39400. <exception cref="T:System.InvalidOperationException">
  39401. The <see cref="P:MailKit.MailFolder.DirectorySeparator"/> is nil, and thus child folders cannot be created.
  39402. </exception>
  39403. <exception cref="T:System.NotSupportedException">
  39404. The <see cref="T:MailKit.MailService"/> does not support the creation of special folders.
  39405. </exception>
  39406. <exception cref="T:System.OperationCanceledException">
  39407. The operation was canceled via the cancellation token.
  39408. </exception>
  39409. <exception cref="T:System.IO.IOException">
  39410. An I/O error occurred.
  39411. </exception>
  39412. <exception cref="T:MailKit.ProtocolException">
  39413. The server's response contained unexpected tokens.
  39414. </exception>
  39415. <exception cref="T:MailKit.CommandException">
  39416. The command failed.
  39417. </exception>
  39418. </member>
  39419. <member name="M:MailKit.MailFolder.CreateAsync(System.String,MailKit.SpecialFolder,System.Threading.CancellationToken)">
  39420. <summary>
  39421. Asynchronously create a new subfolder with the given name.
  39422. </summary>
  39423. <remarks>
  39424. Asynchronously creates a new subfolder with the given name.
  39425. </remarks>
  39426. <returns>The created folder.</returns>
  39427. <param name="name">The name of the folder to create.</param>
  39428. <param name="specialUse">The special use for the folder being created.</param>
  39429. <param name="cancellationToken">The cancellation token.</param>
  39430. <exception cref="T:System.ArgumentNullException">
  39431. <paramref name="name"/> is <c>null</c>.
  39432. </exception>
  39433. <exception cref="T:System.ArgumentException">
  39434. <paramref name="name"/> is empty.
  39435. </exception>
  39436. <exception cref="T:System.ObjectDisposedException">
  39437. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39438. </exception>
  39439. <exception cref="T:MailKit.ServiceNotConnectedException">
  39440. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39441. </exception>
  39442. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39443. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39444. </exception>
  39445. <exception cref="T:System.InvalidOperationException">
  39446. The <see cref="P:MailKit.MailFolder.DirectorySeparator"/> is nil, and thus child folders cannot be created.
  39447. </exception>
  39448. <exception cref="T:System.NotSupportedException">
  39449. The <see cref="T:MailKit.MailService"/> does not support the creation of special folders.
  39450. </exception>
  39451. <exception cref="T:System.OperationCanceledException">
  39452. The operation was canceled via the cancellation token.
  39453. </exception>
  39454. <exception cref="T:System.IO.IOException">
  39455. An I/O error occurred.
  39456. </exception>
  39457. <exception cref="T:MailKit.ProtocolException">
  39458. The server's response contained unexpected tokens.
  39459. </exception>
  39460. <exception cref="T:MailKit.CommandException">
  39461. The command failed.
  39462. </exception>
  39463. </member>
  39464. <member name="M:MailKit.MailFolder.Rename(MailKit.IMailFolder,System.String,System.Threading.CancellationToken)">
  39465. <summary>
  39466. Rename the folder.
  39467. </summary>
  39468. <remarks>
  39469. Renames the folder.
  39470. </remarks>
  39471. <param name="parent">The new parent folder.</param>
  39472. <param name="name">The new name of the folder.</param>
  39473. <param name="cancellationToken">The cancellation token.</param>
  39474. <exception cref="T:System.ArgumentNullException">
  39475. <para><paramref name="parent"/> is <c>null</c>.</para>
  39476. <para>-or-</para>
  39477. <para><paramref name="name"/> is <c>null</c>.</para>
  39478. </exception>
  39479. <exception cref="T:System.ArgumentException">
  39480. <para><paramref name="parent"/> does not belong to the <see cref="T:MailKit.IMailStore"/>.</para>
  39481. <para>-or-</para>
  39482. <para><paramref name="name"/> is not a legal folder name.</para>
  39483. </exception>
  39484. <exception cref="T:System.ObjectDisposedException">
  39485. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39486. </exception>
  39487. <exception cref="T:MailKit.ServiceNotConnectedException">
  39488. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39489. </exception>
  39490. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39491. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39492. </exception>
  39493. <exception cref="T:System.InvalidOperationException">
  39494. The folder cannot be renamed (it is either a namespace or the Inbox).
  39495. </exception>
  39496. <exception cref="T:MailKit.FolderNotFoundException">
  39497. The <see cref="T:MailKit.MailFolder"/> does not exist.
  39498. </exception>
  39499. <exception cref="T:System.OperationCanceledException">
  39500. The operation was canceled via the cancellation token.
  39501. </exception>
  39502. <exception cref="T:System.IO.IOException">
  39503. An I/O error occurred.
  39504. </exception>
  39505. <exception cref="T:MailKit.ProtocolException">
  39506. The server's response contained unexpected tokens.
  39507. </exception>
  39508. <exception cref="T:MailKit.CommandException">
  39509. The command failed.
  39510. </exception>
  39511. </member>
  39512. <member name="M:MailKit.MailFolder.RenameAsync(MailKit.IMailFolder,System.String,System.Threading.CancellationToken)">
  39513. <summary>
  39514. Asynchronously rename the folder.
  39515. </summary>
  39516. <remarks>
  39517. Asynchronously renames the folder.
  39518. </remarks>
  39519. <returns>An asynchronous task context.</returns>
  39520. <param name="parent">The new parent folder.</param>
  39521. <param name="name">The new name of the folder.</param>
  39522. <param name="cancellationToken">The cancellation token.</param>
  39523. <exception cref="T:System.ArgumentNullException">
  39524. <para><paramref name="parent"/> is <c>null</c>.</para>
  39525. <para>-or-</para>
  39526. <para><paramref name="name"/> is <c>null</c>.</para>
  39527. </exception>
  39528. <exception cref="T:System.ArgumentException">
  39529. <para><paramref name="parent"/> does not belong to the <see cref="T:MailKit.IMailStore"/>.</para>
  39530. <para>-or-</para>
  39531. <para><paramref name="name"/> is not a legal folder name.</para>
  39532. </exception>
  39533. <exception cref="T:System.ObjectDisposedException">
  39534. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39535. </exception>
  39536. <exception cref="T:MailKit.ServiceNotConnectedException">
  39537. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39538. </exception>
  39539. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39540. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39541. </exception>
  39542. <exception cref="T:System.InvalidOperationException">
  39543. The folder cannot be renamed (it is either a namespace or the Inbox).
  39544. </exception>
  39545. <exception cref="T:MailKit.FolderNotFoundException">
  39546. The <see cref="T:MailKit.MailFolder"/> does not exist.
  39547. </exception>
  39548. <exception cref="T:System.OperationCanceledException">
  39549. The operation was canceled via the cancellation token.
  39550. </exception>
  39551. <exception cref="T:System.IO.IOException">
  39552. An I/O error occurred.
  39553. </exception>
  39554. <exception cref="T:MailKit.ProtocolException">
  39555. The server's response contained unexpected tokens.
  39556. </exception>
  39557. <exception cref="T:MailKit.CommandException">
  39558. The command failed.
  39559. </exception>
  39560. </member>
  39561. <member name="M:MailKit.MailFolder.Delete(System.Threading.CancellationToken)">
  39562. <summary>
  39563. Delete the folder.
  39564. </summary>
  39565. <remarks>
  39566. Deletes the folder.
  39567. </remarks>
  39568. <param name="cancellationToken">The cancellation token.</param>
  39569. <exception cref="T:System.ObjectDisposedException">
  39570. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39571. </exception>
  39572. <exception cref="T:MailKit.ServiceNotConnectedException">
  39573. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39574. </exception>
  39575. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39576. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39577. </exception>
  39578. <exception cref="T:System.InvalidOperationException">
  39579. The folder cannot be deleted (it is either a namespace or the Inbox).
  39580. </exception>
  39581. <exception cref="T:MailKit.FolderNotFoundException">
  39582. The <see cref="T:MailKit.MailFolder"/> does not exist.
  39583. </exception>
  39584. <exception cref="T:System.OperationCanceledException">
  39585. The operation was canceled via the cancellation token.
  39586. </exception>
  39587. <exception cref="T:System.IO.IOException">
  39588. An I/O error occurred.
  39589. </exception>
  39590. <exception cref="T:MailKit.ProtocolException">
  39591. The server's response contained unexpected tokens.
  39592. </exception>
  39593. <exception cref="T:MailKit.CommandException">
  39594. The command failed.
  39595. </exception>
  39596. </member>
  39597. <member name="M:MailKit.MailFolder.DeleteAsync(System.Threading.CancellationToken)">
  39598. <summary>
  39599. Asynchronously delete the folder.
  39600. </summary>
  39601. <remarks>
  39602. Asynchronously deletes the folder.
  39603. </remarks>
  39604. <returns>An asynchronous task context.</returns>
  39605. <param name="cancellationToken">The cancellation token.</param>
  39606. <exception cref="T:System.ObjectDisposedException">
  39607. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39608. </exception>
  39609. <exception cref="T:MailKit.ServiceNotConnectedException">
  39610. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39611. </exception>
  39612. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39613. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39614. </exception>
  39615. <exception cref="T:System.InvalidOperationException">
  39616. The folder cannot be deleted (it is either a namespace or the Inbox).
  39617. </exception>
  39618. <exception cref="T:MailKit.FolderNotFoundException">
  39619. The <see cref="T:MailKit.MailFolder"/> does not exist.
  39620. </exception>
  39621. <exception cref="T:System.OperationCanceledException">
  39622. The operation was canceled via the cancellation token.
  39623. </exception>
  39624. <exception cref="T:System.IO.IOException">
  39625. An I/O error occurred.
  39626. </exception>
  39627. <exception cref="T:MailKit.ProtocolException">
  39628. The server's response contained unexpected tokens.
  39629. </exception>
  39630. <exception cref="T:MailKit.CommandException">
  39631. The command failed.
  39632. </exception>
  39633. </member>
  39634. <member name="M:MailKit.MailFolder.Subscribe(System.Threading.CancellationToken)">
  39635. <summary>
  39636. Subscribe to the folder.
  39637. </summary>
  39638. <remarks>
  39639. Subscribes to the folder.
  39640. </remarks>
  39641. <param name="cancellationToken">The cancellation token.</param>
  39642. <exception cref="T:System.ObjectDisposedException">
  39643. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39644. </exception>
  39645. <exception cref="T:MailKit.ServiceNotConnectedException">
  39646. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39647. </exception>
  39648. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39649. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39650. </exception>
  39651. <exception cref="T:System.OperationCanceledException">
  39652. The operation was canceled via the cancellation token.
  39653. </exception>
  39654. <exception cref="T:System.IO.IOException">
  39655. An I/O error occurred.
  39656. </exception>
  39657. <exception cref="T:MailKit.ProtocolException">
  39658. The server's response contained unexpected tokens.
  39659. </exception>
  39660. <exception cref="T:MailKit.CommandException">
  39661. The command failed.
  39662. </exception>
  39663. </member>
  39664. <member name="M:MailKit.MailFolder.SubscribeAsync(System.Threading.CancellationToken)">
  39665. <summary>
  39666. Asynchronously subscribe to the folder.
  39667. </summary>
  39668. <remarks>
  39669. Asynchronously subscribes to the folder.
  39670. </remarks>
  39671. <returns>An asynchronous task context.</returns>
  39672. <param name="cancellationToken">The cancellation token.</param>
  39673. <exception cref="T:System.ObjectDisposedException">
  39674. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39675. </exception>
  39676. <exception cref="T:MailKit.ServiceNotConnectedException">
  39677. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39678. </exception>
  39679. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39680. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39681. </exception>
  39682. <exception cref="T:System.OperationCanceledException">
  39683. The operation was canceled via the cancellation token.
  39684. </exception>
  39685. <exception cref="T:System.IO.IOException">
  39686. An I/O error occurred.
  39687. </exception>
  39688. <exception cref="T:MailKit.ProtocolException">
  39689. The server's response contained unexpected tokens.
  39690. </exception>
  39691. <exception cref="T:MailKit.CommandException">
  39692. The command failed.
  39693. </exception>
  39694. </member>
  39695. <member name="M:MailKit.MailFolder.Unsubscribe(System.Threading.CancellationToken)">
  39696. <summary>
  39697. Unsubscribe from the folder.
  39698. </summary>
  39699. <remarks>
  39700. Unsubscribes from the folder.
  39701. </remarks>
  39702. <param name="cancellationToken">The cancellation token.</param>
  39703. <exception cref="T:System.ObjectDisposedException">
  39704. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39705. </exception>
  39706. <exception cref="T:MailKit.ServiceNotConnectedException">
  39707. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39708. </exception>
  39709. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39710. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39711. </exception>
  39712. <exception cref="T:System.OperationCanceledException">
  39713. The operation was canceled via the cancellation token.
  39714. </exception>
  39715. <exception cref="T:System.IO.IOException">
  39716. An I/O error occurred.
  39717. </exception>
  39718. <exception cref="T:MailKit.ProtocolException">
  39719. The server's response contained unexpected tokens.
  39720. </exception>
  39721. <exception cref="T:MailKit.CommandException">
  39722. The command failed.
  39723. </exception>
  39724. </member>
  39725. <member name="M:MailKit.MailFolder.UnsubscribeAsync(System.Threading.CancellationToken)">
  39726. <summary>
  39727. Asynchronously unsubscribe from the folder.
  39728. </summary>
  39729. <remarks>
  39730. Asynchronously unsubscribes from the folder.
  39731. </remarks>
  39732. <returns>An asynchronous task context.</returns>
  39733. <param name="cancellationToken">The cancellation token.</param>
  39734. <exception cref="T:System.ObjectDisposedException">
  39735. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39736. </exception>
  39737. <exception cref="T:MailKit.ServiceNotConnectedException">
  39738. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39739. </exception>
  39740. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39741. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39742. </exception>
  39743. <exception cref="T:System.OperationCanceledException">
  39744. The operation was canceled via the cancellation token.
  39745. </exception>
  39746. <exception cref="T:System.IO.IOException">
  39747. An I/O error occurred.
  39748. </exception>
  39749. <exception cref="T:MailKit.ProtocolException">
  39750. The server's response contained unexpected tokens.
  39751. </exception>
  39752. <exception cref="T:MailKit.CommandException">
  39753. The command failed.
  39754. </exception>
  39755. </member>
  39756. <member name="M:MailKit.MailFolder.GetSubfolders(MailKit.StatusItems,System.Boolean,System.Threading.CancellationToken)">
  39757. <summary>
  39758. Get the subfolders.
  39759. </summary>
  39760. <remarks>
  39761. <para>Gets the subfolders as well as queries the server for the status of the requested items.</para>
  39762. <para>When the <paramref name="items"/> argument is non-empty, this has the equivalent functionality
  39763. of calling <see cref="M:MailKit.MailFolder.GetSubfolders(System.Boolean,System.Threading.CancellationToken)"/> and then calling
  39764. <see cref="M:MailKit.MailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/> on each of the returned folders.</para>
  39765. </remarks>
  39766. <returns>The subfolders.</returns>
  39767. <param name="items">The status items to pre-populate.</param>
  39768. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  39769. <param name="cancellationToken">The cancellation token.</param>
  39770. <exception cref="T:System.ObjectDisposedException">
  39771. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39772. </exception>
  39773. <exception cref="T:MailKit.ServiceNotConnectedException">
  39774. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39775. </exception>
  39776. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39777. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39778. </exception>
  39779. <exception cref="T:System.OperationCanceledException">
  39780. The operation was canceled via the cancellation token.
  39781. </exception>
  39782. <exception cref="T:System.IO.IOException">
  39783. An I/O error occurred.
  39784. </exception>
  39785. <exception cref="T:MailKit.ProtocolException">
  39786. The server's response contained unexpected tokens.
  39787. </exception>
  39788. <exception cref="T:MailKit.CommandException">
  39789. The command failed.
  39790. </exception>
  39791. </member>
  39792. <member name="M:MailKit.MailFolder.GetSubfoldersAsync(MailKit.StatusItems,System.Boolean,System.Threading.CancellationToken)">
  39793. <summary>
  39794. Asynchronously get the subfolders.
  39795. </summary>
  39796. <remarks>
  39797. <para>Asynchronously gets the subfolders as well as queries the server for the status of the requested items.</para>
  39798. <para>When the <paramref name="items"/> argument is non-empty, this has the equivalent functionality
  39799. of calling <see cref="M:MailKit.MailFolder.GetSubfoldersAsync(System.Boolean,System.Threading.CancellationToken)"/> and then calling
  39800. <see cref="M:MailKit.MailFolder.StatusAsync(MailKit.StatusItems,System.Threading.CancellationToken)"/> on each of the returned folders.</para>
  39801. </remarks>
  39802. <returns>The subfolders.</returns>
  39803. <param name="items">The status items to pre-populate.</param>
  39804. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  39805. <param name="cancellationToken">The cancellation token.</param>
  39806. <exception cref="T:System.ObjectDisposedException">
  39807. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39808. </exception>
  39809. <exception cref="T:MailKit.ServiceNotConnectedException">
  39810. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39811. </exception>
  39812. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39813. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39814. </exception>
  39815. <exception cref="T:System.OperationCanceledException">
  39816. The operation was canceled via the cancellation token.
  39817. </exception>
  39818. <exception cref="T:System.IO.IOException">
  39819. An I/O error occurred.
  39820. </exception>
  39821. <exception cref="T:MailKit.ProtocolException">
  39822. The server's response contained unexpected tokens.
  39823. </exception>
  39824. <exception cref="T:MailKit.CommandException">
  39825. The command failed.
  39826. </exception>
  39827. </member>
  39828. <member name="M:MailKit.MailFolder.GetSubfolders(System.Boolean,System.Threading.CancellationToken)">
  39829. <summary>
  39830. Get the subfolders.
  39831. </summary>
  39832. <remarks>
  39833. Gets the subfolders.
  39834. </remarks>
  39835. <returns>The subfolders.</returns>
  39836. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  39837. <param name="cancellationToken">The cancellation token.</param>
  39838. <exception cref="T:System.ObjectDisposedException">
  39839. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39840. </exception>
  39841. <exception cref="T:MailKit.ServiceNotConnectedException">
  39842. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39843. </exception>
  39844. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39845. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39846. </exception>
  39847. <exception cref="T:System.OperationCanceledException">
  39848. The operation was canceled via the cancellation token.
  39849. </exception>
  39850. <exception cref="T:System.IO.IOException">
  39851. An I/O error occurred.
  39852. </exception>
  39853. <exception cref="T:MailKit.ProtocolException">
  39854. The server's response contained unexpected tokens.
  39855. </exception>
  39856. <exception cref="T:MailKit.CommandException">
  39857. The command failed.
  39858. </exception>
  39859. </member>
  39860. <member name="M:MailKit.MailFolder.GetSubfoldersAsync(System.Boolean,System.Threading.CancellationToken)">
  39861. <summary>
  39862. Asynchronously get the subfolders.
  39863. </summary>
  39864. <remarks>
  39865. Asynchronously gets the subfolders.
  39866. </remarks>
  39867. <returns>The subfolders.</returns>
  39868. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  39869. <param name="cancellationToken">The cancellation token.</param>
  39870. <exception cref="T:System.ObjectDisposedException">
  39871. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39872. </exception>
  39873. <exception cref="T:MailKit.ServiceNotConnectedException">
  39874. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39875. </exception>
  39876. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39877. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39878. </exception>
  39879. <exception cref="T:System.OperationCanceledException">
  39880. The operation was canceled via the cancellation token.
  39881. </exception>
  39882. <exception cref="T:System.IO.IOException">
  39883. An I/O error occurred.
  39884. </exception>
  39885. <exception cref="T:MailKit.ProtocolException">
  39886. The server's response contained unexpected tokens.
  39887. </exception>
  39888. <exception cref="T:MailKit.CommandException">
  39889. The command failed.
  39890. </exception>
  39891. </member>
  39892. <member name="M:MailKit.MailFolder.GetSubfolder(System.String,System.Threading.CancellationToken)">
  39893. <summary>
  39894. Get the specified subfolder.
  39895. </summary>
  39896. <remarks>
  39897. Gets the specified subfolder.
  39898. </remarks>
  39899. <returns>The subfolder.</returns>
  39900. <param name="name">The name of the subfolder.</param>
  39901. <param name="cancellationToken">The cancellation token.</param>
  39902. <exception cref="T:System.ArgumentNullException">
  39903. <paramref name="name"/> is <c>null</c>.
  39904. </exception>
  39905. <exception cref="T:System.ArgumentException">
  39906. <paramref name="name"/> is either an empty string or contains the <see cref="P:MailKit.MailFolder.DirectorySeparator"/>.
  39907. </exception>
  39908. <exception cref="T:System.ObjectDisposedException">
  39909. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39910. </exception>
  39911. <exception cref="T:MailKit.ServiceNotConnectedException">
  39912. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39913. </exception>
  39914. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39915. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39916. </exception>
  39917. <exception cref="T:System.OperationCanceledException">
  39918. The operation was canceled via the cancellation token.
  39919. </exception>
  39920. <exception cref="T:System.IO.IOException">
  39921. An I/O error occurred.
  39922. </exception>
  39923. <exception cref="T:MailKit.FolderNotFoundException">
  39924. The requested folder could not be found.
  39925. </exception>
  39926. <exception cref="T:MailKit.ProtocolException">
  39927. The server's response contained unexpected tokens.
  39928. </exception>
  39929. <exception cref="T:MailKit.CommandException">
  39930. The command failed.
  39931. </exception>
  39932. </member>
  39933. <member name="M:MailKit.MailFolder.GetSubfolderAsync(System.String,System.Threading.CancellationToken)">
  39934. <summary>
  39935. Asynchronously get the specified subfolder.
  39936. </summary>
  39937. <remarks>
  39938. Asynchronously gets the specified subfolder.
  39939. </remarks>
  39940. <returns>The subfolder.</returns>
  39941. <param name="name">The name of the subfolder.</param>
  39942. <param name="cancellationToken">The cancellation token.</param>
  39943. <exception cref="T:System.ArgumentNullException">
  39944. <paramref name="name"/> is <c>null</c>.
  39945. </exception>
  39946. <exception cref="T:System.ArgumentException">
  39947. <paramref name="name"/> is either an empty string or contains the <see cref="P:MailKit.MailFolder.DirectorySeparator"/>.
  39948. </exception>
  39949. <exception cref="T:System.ObjectDisposedException">
  39950. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39951. </exception>
  39952. <exception cref="T:MailKit.ServiceNotConnectedException">
  39953. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39954. </exception>
  39955. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39956. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39957. </exception>
  39958. <exception cref="T:System.OperationCanceledException">
  39959. The operation was canceled via the cancellation token.
  39960. </exception>
  39961. <exception cref="T:System.IO.IOException">
  39962. An I/O error occurred.
  39963. </exception>
  39964. <exception cref="T:MailKit.FolderNotFoundException">
  39965. The requested folder could not be found.
  39966. </exception>
  39967. <exception cref="T:MailKit.ProtocolException">
  39968. The server's response contained unexpected tokens.
  39969. </exception>
  39970. <exception cref="T:MailKit.CommandException">
  39971. The command failed.
  39972. </exception>
  39973. </member>
  39974. <member name="M:MailKit.MailFolder.Check(System.Threading.CancellationToken)">
  39975. <summary>
  39976. Force the server to flush its state for the folder.
  39977. </summary>
  39978. <remarks>
  39979. Forces the server to flush its state for the folder.
  39980. </remarks>
  39981. <param name="cancellationToken">The cancellation token.</param>
  39982. <exception cref="T:System.ObjectDisposedException">
  39983. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  39984. </exception>
  39985. <exception cref="T:MailKit.ServiceNotConnectedException">
  39986. The <see cref="T:MailKit.IMailStore"/> is not connected.
  39987. </exception>
  39988. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  39989. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  39990. </exception>
  39991. <exception cref="T:MailKit.FolderNotOpenException">
  39992. The folder is not currently open.
  39993. </exception>
  39994. <exception cref="T:System.OperationCanceledException">
  39995. The operation was canceled via the cancellation token.
  39996. </exception>
  39997. <exception cref="T:System.IO.IOException">
  39998. An I/O error occurred.
  39999. </exception>
  40000. <exception cref="T:MailKit.ProtocolException">
  40001. The server's response contained unexpected tokens.
  40002. </exception>
  40003. <exception cref="T:MailKit.CommandException">
  40004. The command failed.
  40005. </exception>
  40006. </member>
  40007. <member name="M:MailKit.MailFolder.CheckAsync(System.Threading.CancellationToken)">
  40008. <summary>
  40009. Asynchronously force the server to flush its state for the folder.
  40010. </summary>
  40011. <remarks>
  40012. Asynchronously forces the server to flush its state for the folder.
  40013. </remarks>
  40014. <returns>An asynchronous task context.</returns>
  40015. <param name="cancellationToken">The cancellation token.</param>
  40016. <exception cref="T:System.ObjectDisposedException">
  40017. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40018. </exception>
  40019. <exception cref="T:MailKit.ServiceNotConnectedException">
  40020. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40021. </exception>
  40022. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40023. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40024. </exception>
  40025. <exception cref="T:MailKit.FolderNotOpenException">
  40026. The folder is not currently open.
  40027. </exception>
  40028. <exception cref="T:System.OperationCanceledException">
  40029. The operation was canceled via the cancellation token.
  40030. </exception>
  40031. <exception cref="T:System.IO.IOException">
  40032. An I/O error occurred.
  40033. </exception>
  40034. <exception cref="T:MailKit.ProtocolException">
  40035. The server's response contained unexpected tokens.
  40036. </exception>
  40037. <exception cref="T:MailKit.CommandException">
  40038. The command failed.
  40039. </exception>
  40040. </member>
  40041. <member name="M:MailKit.MailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)">
  40042. <summary>
  40043. Update the values of the specified items.
  40044. </summary>
  40045. <remarks>
  40046. <para>Updates the values of the specified items.</para>
  40047. <para>The <see cref="M:MailKit.MailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/> method
  40048. MUST NOT be used on a folder that is already in the opened state. Instead, other ways
  40049. of getting the desired information should be used.</para>
  40050. <para>For example, a common use for the <see cref="M:MailKit.MailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/>
  40051. method is to get the number of unread messages in the folder. When the folder is open, however, it is
  40052. possible to use the <see cref="M:MailKit.MailFolder.Search(MailKit.Search.SearchQuery,System.Threading.CancellationToken)"/>
  40053. method to query for the list of unread messages.</para>
  40054. </remarks>
  40055. <param name="items">The items to update.</param>
  40056. <param name="cancellationToken">The cancellation token.</param>
  40057. <exception cref="T:System.ObjectDisposedException">
  40058. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40059. </exception>
  40060. <exception cref="T:MailKit.ServiceNotConnectedException">
  40061. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40062. </exception>
  40063. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40064. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40065. </exception>
  40066. <exception cref="T:MailKit.FolderNotFoundException">
  40067. The <see cref="T:MailKit.MailFolder"/> does not exist.
  40068. </exception>
  40069. <exception cref="T:System.NotSupportedException">
  40070. The mail store does not support the STATUS command.
  40071. </exception>
  40072. <exception cref="T:System.OperationCanceledException">
  40073. The operation was canceled via the cancellation token.
  40074. </exception>
  40075. <exception cref="T:System.IO.IOException">
  40076. An I/O error occurred.
  40077. </exception>
  40078. <exception cref="T:MailKit.ProtocolException">
  40079. The server's response contained unexpected tokens.
  40080. </exception>
  40081. <exception cref="T:MailKit.CommandException">
  40082. The command failed.
  40083. </exception>
  40084. </member>
  40085. <member name="M:MailKit.MailFolder.StatusAsync(MailKit.StatusItems,System.Threading.CancellationToken)">
  40086. <summary>
  40087. Asynchronously update the values of the specified items.
  40088. </summary>
  40089. <remarks>
  40090. <para>Updates the values of the specified items.</para>
  40091. <para>The <see cref="M:MailKit.MailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/> method
  40092. MUST NOT be used on a folder that is already in the opened state. Instead, other ways
  40093. of getting the desired information should be used.</para>
  40094. <para>For example, a common use for the <see cref="M:MailKit.MailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/>
  40095. method is to get the number of unread messages in the folder. When the folder is open, however, it is
  40096. possible to use the <see cref="M:MailKit.MailFolder.Search(MailKit.Search.SearchQuery,System.Threading.CancellationToken)"/>
  40097. method to query for the list of unread messages.</para>
  40098. </remarks>
  40099. <returns>An asynchronous task context.</returns>
  40100. <param name="items">The items to update.</param>
  40101. <param name="cancellationToken">The cancellation token.</param>
  40102. <exception cref="T:System.ObjectDisposedException">
  40103. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40104. </exception>
  40105. <exception cref="T:MailKit.ServiceNotConnectedException">
  40106. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40107. </exception>
  40108. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40109. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40110. </exception>
  40111. <exception cref="T:System.NotSupportedException">
  40112. The mail store does not support the STATUS command.
  40113. </exception>
  40114. <exception cref="T:System.OperationCanceledException">
  40115. The operation was canceled via the cancellation token.
  40116. </exception>
  40117. <exception cref="T:System.IO.IOException">
  40118. An I/O error occurred.
  40119. </exception>
  40120. <exception cref="T:MailKit.ProtocolException">
  40121. The server's response contained unexpected tokens.
  40122. </exception>
  40123. <exception cref="T:MailKit.CommandException">
  40124. The command failed.
  40125. </exception>
  40126. </member>
  40127. <member name="M:MailKit.MailFolder.GetAccessControlList(System.Threading.CancellationToken)">
  40128. <summary>
  40129. Get the complete access control list for the folder.
  40130. </summary>
  40131. <remarks>
  40132. Gets the complete access control list for the folder.
  40133. </remarks>
  40134. <returns>The access control list.</returns>
  40135. <param name="cancellationToken">The cancellation token.</param>
  40136. <exception cref="T:System.ObjectDisposedException">
  40137. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40138. </exception>
  40139. <exception cref="T:MailKit.ServiceNotConnectedException">
  40140. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40141. </exception>
  40142. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40143. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40144. </exception>
  40145. <exception cref="T:System.NotSupportedException">
  40146. The mail store does not support the ACL extension.
  40147. </exception>
  40148. <exception cref="T:System.OperationCanceledException">
  40149. The operation was canceled via the cancellation token.
  40150. </exception>
  40151. <exception cref="T:System.IO.IOException">
  40152. An I/O error occurred.
  40153. </exception>
  40154. <exception cref="T:MailKit.ProtocolException">
  40155. The server's response contained unexpected tokens.
  40156. </exception>
  40157. <exception cref="T:MailKit.CommandException">
  40158. The command failed.
  40159. </exception>
  40160. </member>
  40161. <member name="M:MailKit.MailFolder.GetAccessControlListAsync(System.Threading.CancellationToken)">
  40162. <summary>
  40163. Asynchronously get the complete access control list for the folder.
  40164. </summary>
  40165. <remarks>
  40166. Asynchronously gets the complete access control list for the folder.
  40167. </remarks>
  40168. <returns>The access control list.</returns>
  40169. <param name="cancellationToken">The cancellation token.</param>
  40170. <exception cref="T:System.ObjectDisposedException">
  40171. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40172. </exception>
  40173. <exception cref="T:MailKit.ServiceNotConnectedException">
  40174. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40175. </exception>
  40176. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40177. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40178. </exception>
  40179. <exception cref="T:System.NotSupportedException">
  40180. The mail store does not support the ACL extension.
  40181. </exception>
  40182. <exception cref="T:System.OperationCanceledException">
  40183. The operation was canceled via the cancellation token.
  40184. </exception>
  40185. <exception cref="T:System.IO.IOException">
  40186. An I/O error occurred.
  40187. </exception>
  40188. <exception cref="T:MailKit.ProtocolException">
  40189. The server's response contained unexpected tokens.
  40190. </exception>
  40191. <exception cref="T:MailKit.CommandException">
  40192. The command failed.
  40193. </exception>
  40194. </member>
  40195. <member name="M:MailKit.MailFolder.GetAccessRights(System.String,System.Threading.CancellationToken)">
  40196. <summary>
  40197. Get the access rights for a particular identifier.
  40198. </summary>
  40199. <remarks>
  40200. Gets the access rights for a particular identifier.
  40201. </remarks>
  40202. <returns>The access rights.</returns>
  40203. <param name="name">The identifier name.</param>
  40204. <param name="cancellationToken">The cancellation token.</param>
  40205. <exception cref="T:System.ArgumentNullException">
  40206. <paramref name="name"/> is <c>null</c>.
  40207. </exception>
  40208. <exception cref="T:System.ObjectDisposedException">
  40209. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40210. </exception>
  40211. <exception cref="T:MailKit.ServiceNotConnectedException">
  40212. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40213. </exception>
  40214. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40215. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40216. </exception>
  40217. <exception cref="T:System.NotSupportedException">
  40218. The mail store does not support the ACL extension.
  40219. </exception>
  40220. <exception cref="T:System.OperationCanceledException">
  40221. The operation was canceled via the cancellation token.
  40222. </exception>
  40223. <exception cref="T:System.IO.IOException">
  40224. An I/O error occurred.
  40225. </exception>
  40226. <exception cref="T:MailKit.ProtocolException">
  40227. The server's response contained unexpected tokens.
  40228. </exception>
  40229. <exception cref="T:MailKit.CommandException">
  40230. The command failed.
  40231. </exception>
  40232. </member>
  40233. <member name="M:MailKit.MailFolder.GetAccessRightsAsync(System.String,System.Threading.CancellationToken)">
  40234. <summary>
  40235. Asynchronously get the access rights for a particular identifier.
  40236. </summary>
  40237. <remarks>
  40238. Asynchronously gets the access rights for a particular identifier.
  40239. </remarks>
  40240. <returns>The access rights.</returns>
  40241. <param name="name">The identifier name.</param>
  40242. <param name="cancellationToken">The cancellation token.</param>
  40243. <exception cref="T:System.ArgumentNullException">
  40244. <paramref name="name"/> is <c>null</c>.
  40245. </exception>
  40246. <exception cref="T:System.ObjectDisposedException">
  40247. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40248. </exception>
  40249. <exception cref="T:MailKit.ServiceNotConnectedException">
  40250. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40251. </exception>
  40252. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40253. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40254. </exception>
  40255. <exception cref="T:System.NotSupportedException">
  40256. The mail store does not support the ACL extension.
  40257. </exception>
  40258. <exception cref="T:System.OperationCanceledException">
  40259. The operation was canceled via the cancellation token.
  40260. </exception>
  40261. <exception cref="T:System.IO.IOException">
  40262. An I/O error occurred.
  40263. </exception>
  40264. <exception cref="T:MailKit.ProtocolException">
  40265. The server's response contained unexpected tokens.
  40266. </exception>
  40267. <exception cref="T:MailKit.CommandException">
  40268. The command failed.
  40269. </exception>
  40270. </member>
  40271. <member name="M:MailKit.MailFolder.GetMyAccessRights(System.Threading.CancellationToken)">
  40272. <summary>
  40273. Get the access rights for the current authenticated user.
  40274. </summary>
  40275. <remarks>
  40276. Gets the access rights for the current authenticated user.
  40277. </remarks>
  40278. <returns>The access rights.</returns>
  40279. <param name="cancellationToken">The cancellation token.</param>
  40280. <exception cref="T:System.ObjectDisposedException">
  40281. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40282. </exception>
  40283. <exception cref="T:MailKit.ServiceNotConnectedException">
  40284. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40285. </exception>
  40286. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40287. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40288. </exception>
  40289. <exception cref="T:System.NotSupportedException">
  40290. The mail store does not support the ACL extension.
  40291. </exception>
  40292. <exception cref="T:System.OperationCanceledException">
  40293. The operation was canceled via the cancellation token.
  40294. </exception>
  40295. <exception cref="T:System.IO.IOException">
  40296. An I/O error occurred.
  40297. </exception>
  40298. <exception cref="T:MailKit.ProtocolException">
  40299. The server's response contained unexpected tokens.
  40300. </exception>
  40301. <exception cref="T:MailKit.CommandException">
  40302. The command failed.
  40303. </exception>
  40304. </member>
  40305. <member name="M:MailKit.MailFolder.GetMyAccessRightsAsync(System.Threading.CancellationToken)">
  40306. <summary>
  40307. Asynchronously get the access rights for the current authenticated user.
  40308. </summary>
  40309. <remarks>
  40310. Asynchronously gets the access rights for the current authenticated user.
  40311. </remarks>
  40312. <returns>The access rights.</returns>
  40313. <param name="cancellationToken">The cancellation token.</param>
  40314. <exception cref="T:System.ObjectDisposedException">
  40315. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40316. </exception>
  40317. <exception cref="T:MailKit.ServiceNotConnectedException">
  40318. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40319. </exception>
  40320. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40321. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40322. </exception>
  40323. <exception cref="T:System.NotSupportedException">
  40324. The mail store does not support the ACL extension.
  40325. </exception>
  40326. <exception cref="T:System.OperationCanceledException">
  40327. The operation was canceled via the cancellation token.
  40328. </exception>
  40329. <exception cref="T:System.IO.IOException">
  40330. An I/O error occurred.
  40331. </exception>
  40332. <exception cref="T:MailKit.ProtocolException">
  40333. The server's response contained unexpected tokens.
  40334. </exception>
  40335. <exception cref="T:MailKit.CommandException">
  40336. The command failed.
  40337. </exception>
  40338. </member>
  40339. <member name="M:MailKit.MailFolder.AddAccessRights(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  40340. <summary>
  40341. Add access rights for the specified identity.
  40342. </summary>
  40343. <remarks>
  40344. Adds the given access rights for the specified identity.
  40345. </remarks>
  40346. <param name="name">The identity name.</param>
  40347. <param name="rights">The access rights.</param>
  40348. <param name="cancellationToken">The cancellation token.</param>
  40349. <exception cref="T:System.ArgumentNullException">
  40350. <para><paramref name="name"/> is <c>null</c>.</para>
  40351. <para>-or-</para>
  40352. <para><paramref name="rights"/> is <c>null</c>.</para>
  40353. </exception>
  40354. <exception cref="T:System.ObjectDisposedException">
  40355. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40356. </exception>
  40357. <exception cref="T:MailKit.ServiceNotConnectedException">
  40358. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40359. </exception>
  40360. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40361. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40362. </exception>
  40363. <exception cref="T:System.NotSupportedException">
  40364. The mail store does not support the ACL extension.
  40365. </exception>
  40366. <exception cref="T:System.OperationCanceledException">
  40367. The operation was canceled via the cancellation token.
  40368. </exception>
  40369. <exception cref="T:System.IO.IOException">
  40370. An I/O error occurred.
  40371. </exception>
  40372. <exception cref="T:MailKit.ProtocolException">
  40373. The server's response contained unexpected tokens.
  40374. </exception>
  40375. <exception cref="T:MailKit.CommandException">
  40376. The command failed.
  40377. </exception>
  40378. </member>
  40379. <member name="M:MailKit.MailFolder.AddAccessRightsAsync(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  40380. <summary>
  40381. Asynchronously add access rights for the specified identity.
  40382. </summary>
  40383. <remarks>
  40384. Asynchronously adds the given access rights for the specified identity.
  40385. </remarks>
  40386. <returns>An asynchronous task context.</returns>
  40387. <param name="name">The identity name.</param>
  40388. <param name="rights">The access rights.</param>
  40389. <param name="cancellationToken">The cancellation token.</param>
  40390. <exception cref="T:System.ArgumentNullException">
  40391. <para><paramref name="name"/> is <c>null</c>.</para>
  40392. <para>-or-</para>
  40393. <para><paramref name="rights"/> is <c>null</c>.</para>
  40394. </exception>
  40395. <exception cref="T:System.ObjectDisposedException">
  40396. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40397. </exception>
  40398. <exception cref="T:MailKit.ServiceNotConnectedException">
  40399. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40400. </exception>
  40401. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40402. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40403. </exception>
  40404. <exception cref="T:System.NotSupportedException">
  40405. The mail store does not support the ACL extension.
  40406. </exception>
  40407. <exception cref="T:System.OperationCanceledException">
  40408. The operation was canceled via the cancellation token.
  40409. </exception>
  40410. <exception cref="T:System.IO.IOException">
  40411. An I/O error occurred.
  40412. </exception>
  40413. <exception cref="T:MailKit.ProtocolException">
  40414. The server's response contained unexpected tokens.
  40415. </exception>
  40416. <exception cref="T:MailKit.CommandException">
  40417. The command failed.
  40418. </exception>
  40419. </member>
  40420. <member name="M:MailKit.MailFolder.RemoveAccessRights(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  40421. <summary>
  40422. Remove access rights for the specified identity.
  40423. </summary>
  40424. <remarks>
  40425. Removes the given access rights for the specified identity.
  40426. </remarks>
  40427. <param name="name">The identity name.</param>
  40428. <param name="rights">The access rights.</param>
  40429. <param name="cancellationToken">The cancellation token.</param>
  40430. <exception cref="T:System.ArgumentNullException">
  40431. <para><paramref name="name"/> is <c>null</c>.</para>
  40432. <para>-or-</para>
  40433. <para><paramref name="rights"/> is <c>null</c>.</para>
  40434. </exception>
  40435. <exception cref="T:System.ObjectDisposedException">
  40436. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40437. </exception>
  40438. <exception cref="T:MailKit.ServiceNotConnectedException">
  40439. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40440. </exception>
  40441. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40442. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40443. </exception>
  40444. <exception cref="T:System.NotSupportedException">
  40445. The mail store does not support the ACL extension.
  40446. </exception>
  40447. <exception cref="T:System.OperationCanceledException">
  40448. The operation was canceled via the cancellation token.
  40449. </exception>
  40450. <exception cref="T:System.IO.IOException">
  40451. An I/O error occurred.
  40452. </exception>
  40453. <exception cref="T:MailKit.ProtocolException">
  40454. The server's response contained unexpected tokens.
  40455. </exception>
  40456. <exception cref="T:MailKit.CommandException">
  40457. The command failed.
  40458. </exception>
  40459. </member>
  40460. <member name="M:MailKit.MailFolder.RemoveAccessRightsAsync(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  40461. <summary>
  40462. Asynchronously remove access rights for the specified identity.
  40463. </summary>
  40464. <remarks>
  40465. Asynchronously removes the given access rights for the specified identity.
  40466. </remarks>
  40467. <returns>An asynchronous task context.</returns>
  40468. <param name="name">The identity name.</param>
  40469. <param name="rights">The access rights.</param>
  40470. <param name="cancellationToken">The cancellation token.</param>
  40471. <exception cref="T:System.ArgumentNullException">
  40472. <para><paramref name="name"/> is <c>null</c>.</para>
  40473. <para>-or-</para>
  40474. <para><paramref name="rights"/> is <c>null</c>.</para>
  40475. </exception>
  40476. <exception cref="T:System.ObjectDisposedException">
  40477. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40478. </exception>
  40479. <exception cref="T:MailKit.ServiceNotConnectedException">
  40480. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40481. </exception>
  40482. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40483. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40484. </exception>
  40485. <exception cref="T:System.NotSupportedException">
  40486. The mail store does not support the ACL extension.
  40487. </exception>
  40488. <exception cref="T:System.OperationCanceledException">
  40489. The operation was canceled via the cancellation token.
  40490. </exception>
  40491. <exception cref="T:System.IO.IOException">
  40492. An I/O error occurred.
  40493. </exception>
  40494. <exception cref="T:MailKit.ProtocolException">
  40495. The server's response contained unexpected tokens.
  40496. </exception>
  40497. <exception cref="T:MailKit.CommandException">
  40498. The command failed.
  40499. </exception>
  40500. </member>
  40501. <member name="M:MailKit.MailFolder.SetAccessRights(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  40502. <summary>
  40503. Set the access rights for the specified identity.
  40504. </summary>
  40505. <remarks>
  40506. Sets the access rights for the specified identity.
  40507. </remarks>
  40508. <param name="name">The identity name.</param>
  40509. <param name="rights">The access rights.</param>
  40510. <param name="cancellationToken">The cancellation token.</param>
  40511. <exception cref="T:System.ArgumentNullException">
  40512. <para><paramref name="name"/> is <c>null</c>.</para>
  40513. <para>-or-</para>
  40514. <para><paramref name="rights"/> is <c>null</c>.</para>
  40515. </exception>
  40516. <exception cref="T:System.ObjectDisposedException">
  40517. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40518. </exception>
  40519. <exception cref="T:MailKit.ServiceNotConnectedException">
  40520. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40521. </exception>
  40522. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40523. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40524. </exception>
  40525. <exception cref="T:System.NotSupportedException">
  40526. The mail store does not support the ACL extension.
  40527. </exception>
  40528. <exception cref="T:System.OperationCanceledException">
  40529. The operation was canceled via the cancellation token.
  40530. </exception>
  40531. <exception cref="T:System.IO.IOException">
  40532. An I/O error occurred.
  40533. </exception>
  40534. <exception cref="T:MailKit.ProtocolException">
  40535. The server's response contained unexpected tokens.
  40536. </exception>
  40537. <exception cref="T:MailKit.CommandException">
  40538. The command failed.
  40539. </exception>
  40540. </member>
  40541. <member name="M:MailKit.MailFolder.SetAccessRightsAsync(System.String,MailKit.AccessRights,System.Threading.CancellationToken)">
  40542. <summary>
  40543. Asynchronously set the access rights for the specified identity.
  40544. </summary>
  40545. <remarks>
  40546. Asynchronously sets the access rights for the specified identity.
  40547. </remarks>
  40548. <returns>An asynchronous task context.</returns>
  40549. <param name="name">The identity name.</param>
  40550. <param name="rights">The access rights.</param>
  40551. <param name="cancellationToken">The cancellation token.</param>
  40552. <exception cref="T:System.ArgumentNullException">
  40553. <para><paramref name="name"/> is <c>null</c>.</para>
  40554. <para>-or-</para>
  40555. <para><paramref name="rights"/> is <c>null</c>.</para>
  40556. </exception>
  40557. <exception cref="T:System.ObjectDisposedException">
  40558. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40559. </exception>
  40560. <exception cref="T:MailKit.ServiceNotConnectedException">
  40561. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40562. </exception>
  40563. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40564. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40565. </exception>
  40566. <exception cref="T:System.NotSupportedException">
  40567. The mail store does not support the ACL extension.
  40568. </exception>
  40569. <exception cref="T:System.OperationCanceledException">
  40570. The operation was canceled via the cancellation token.
  40571. </exception>
  40572. <exception cref="T:System.IO.IOException">
  40573. An I/O error occurred.
  40574. </exception>
  40575. <exception cref="T:MailKit.ProtocolException">
  40576. The server's response contained unexpected tokens.
  40577. </exception>
  40578. <exception cref="T:MailKit.CommandException">
  40579. The command failed.
  40580. </exception>
  40581. </member>
  40582. <member name="M:MailKit.MailFolder.RemoveAccess(System.String,System.Threading.CancellationToken)">
  40583. <summary>
  40584. Remove all access rights for the given identity.
  40585. </summary>
  40586. <remarks>
  40587. Removes all access rights for the given identity.
  40588. </remarks>
  40589. <param name="name">The identity name.</param>
  40590. <param name="cancellationToken">The cancellation token.</param>
  40591. <exception cref="T:System.ArgumentNullException">
  40592. <paramref name="name"/> is <c>null</c>.
  40593. </exception>
  40594. <exception cref="T:System.ObjectDisposedException">
  40595. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40596. </exception>
  40597. <exception cref="T:MailKit.ServiceNotConnectedException">
  40598. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40599. </exception>
  40600. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40601. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40602. </exception>
  40603. <exception cref="T:System.NotSupportedException">
  40604. The mail store does not support the ACL extension.
  40605. </exception>
  40606. <exception cref="T:System.OperationCanceledException">
  40607. The operation was canceled via the cancellation token.
  40608. </exception>
  40609. <exception cref="T:System.IO.IOException">
  40610. An I/O error occurred.
  40611. </exception>
  40612. <exception cref="T:MailKit.ProtocolException">
  40613. The server's response contained unexpected tokens.
  40614. </exception>
  40615. <exception cref="T:MailKit.CommandException">
  40616. The command failed.
  40617. </exception>
  40618. </member>
  40619. <member name="M:MailKit.MailFolder.RemoveAccessAsync(System.String,System.Threading.CancellationToken)">
  40620. <summary>
  40621. Asynchronously remove all access rights for the given identity.
  40622. </summary>
  40623. <remarks>
  40624. Asynchronously removes all access rights for the given identity.
  40625. </remarks>
  40626. <returns>An asynchronous task context.</returns>
  40627. <param name="name">The identity name.</param>
  40628. <param name="cancellationToken">The cancellation token.</param>
  40629. <exception cref="T:System.ArgumentNullException">
  40630. <paramref name="name"/> is <c>null</c>.
  40631. </exception>
  40632. <exception cref="T:System.ObjectDisposedException">
  40633. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40634. </exception>
  40635. <exception cref="T:MailKit.ServiceNotConnectedException">
  40636. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40637. </exception>
  40638. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40639. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40640. </exception>
  40641. <exception cref="T:System.NotSupportedException">
  40642. The mail store does not support the ACL extension.
  40643. </exception>
  40644. <exception cref="T:System.OperationCanceledException">
  40645. The operation was canceled via the cancellation token.
  40646. </exception>
  40647. <exception cref="T:System.IO.IOException">
  40648. An I/O error occurred.
  40649. </exception>
  40650. <exception cref="T:MailKit.ProtocolException">
  40651. The server's response contained unexpected tokens.
  40652. </exception>
  40653. <exception cref="T:MailKit.CommandException">
  40654. The command failed.
  40655. </exception>
  40656. </member>
  40657. <member name="M:MailKit.MailFolder.GetQuota(System.Threading.CancellationToken)">
  40658. <summary>
  40659. Get the quota information for the folder.
  40660. </summary>
  40661. <remarks>
  40662. <para>Gets the quota information for the folder.</para>
  40663. <para>To determine if a quotas are supported, check the
  40664. <see cref="P:MailKit.IMailStore.SupportsQuotas"/> property.</para>
  40665. </remarks>
  40666. <returns>The folder quota.</returns>
  40667. <param name="cancellationToken">The cancellation token.</param>
  40668. <exception cref="T:System.ObjectDisposedException">
  40669. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40670. </exception>
  40671. <exception cref="T:MailKit.ServiceNotConnectedException">
  40672. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40673. </exception>
  40674. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40675. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40676. </exception>
  40677. <exception cref="T:System.NotSupportedException">
  40678. The mail store does not support quotas.
  40679. </exception>
  40680. <exception cref="T:System.OperationCanceledException">
  40681. The operation was canceled via the cancellation token.
  40682. </exception>
  40683. <exception cref="T:System.IO.IOException">
  40684. An I/O error occurred.
  40685. </exception>
  40686. <exception cref="T:MailKit.ProtocolException">
  40687. The server's response contained unexpected tokens.
  40688. </exception>
  40689. <exception cref="T:MailKit.CommandException">
  40690. The command failed.
  40691. </exception>
  40692. </member>
  40693. <member name="M:MailKit.MailFolder.GetQuotaAsync(System.Threading.CancellationToken)">
  40694. <summary>
  40695. Asynchronously get the quota information for the folder.
  40696. </summary>
  40697. <remarks>
  40698. <para>Asynchronously gets the quota information for the folder.</para>
  40699. <para>To determine if a quotas are supported, check the
  40700. <see cref="P:MailKit.IMailStore.SupportsQuotas"/> property.</para>
  40701. </remarks>
  40702. <returns>The folder quota.</returns>
  40703. <param name="cancellationToken">The cancellation token.</param>
  40704. <exception cref="T:System.ObjectDisposedException">
  40705. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40706. </exception>
  40707. <exception cref="T:MailKit.ServiceNotConnectedException">
  40708. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40709. </exception>
  40710. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40711. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40712. </exception>
  40713. <exception cref="T:System.NotSupportedException">
  40714. The mail store does not support quotas.
  40715. </exception>
  40716. <exception cref="T:System.OperationCanceledException">
  40717. The operation was canceled via the cancellation token.
  40718. </exception>
  40719. <exception cref="T:System.IO.IOException">
  40720. An I/O error occurred.
  40721. </exception>
  40722. <exception cref="T:MailKit.ProtocolException">
  40723. The server's response contained unexpected tokens.
  40724. </exception>
  40725. <exception cref="T:MailKit.CommandException">
  40726. The command failed.
  40727. </exception>
  40728. </member>
  40729. <member name="M:MailKit.MailFolder.SetQuota(System.Nullable{System.UInt32},System.Nullable{System.UInt32},System.Threading.CancellationToken)">
  40730. <summary>
  40731. Set the quota limits for the folder.
  40732. </summary>
  40733. <remarks>
  40734. <para>Sets the quota limits for the folder.</para>
  40735. <para>To determine if a quotas are supported, check the
  40736. <see cref="P:MailKit.IMailStore.SupportsQuotas"/> property.</para>
  40737. </remarks>
  40738. <returns>The updated folder quota.</returns>
  40739. <param name="messageLimit">If not <c>null</c>, sets the maximum number of messages to allow.</param>
  40740. <param name="storageLimit">If not <c>null</c>, sets the maximum storage size (in kilobytes).</param>
  40741. <param name="cancellationToken">The cancellation token.</param>
  40742. <exception cref="T:System.ObjectDisposedException">
  40743. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40744. </exception>
  40745. <exception cref="T:MailKit.ServiceNotConnectedException">
  40746. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40747. </exception>
  40748. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40749. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40750. </exception>
  40751. <exception cref="T:System.NotSupportedException">
  40752. The mail store does not support quotas.
  40753. </exception>
  40754. <exception cref="T:System.OperationCanceledException">
  40755. The operation was canceled via the cancellation token.
  40756. </exception>
  40757. <exception cref="T:System.IO.IOException">
  40758. An I/O error occurred.
  40759. </exception>
  40760. <exception cref="T:MailKit.ProtocolException">
  40761. The server's response contained unexpected tokens.
  40762. </exception>
  40763. <exception cref="T:MailKit.CommandException">
  40764. The command failed.
  40765. </exception>
  40766. </member>
  40767. <member name="M:MailKit.MailFolder.SetQuotaAsync(System.Nullable{System.UInt32},System.Nullable{System.UInt32},System.Threading.CancellationToken)">
  40768. <summary>
  40769. Asynchronously set the quota limits for the folder.
  40770. </summary>
  40771. <remarks>
  40772. <para>Asynchronously sets the quota limits for the folder.</para>
  40773. <para>To determine if a quotas are supported, check the
  40774. <see cref="P:MailKit.IMailStore.SupportsQuotas"/> property.</para>
  40775. </remarks>
  40776. <returns>The updated folder quota.</returns>
  40777. <param name="messageLimit">If not <c>null</c>, sets the maximum number of messages to allow.</param>
  40778. <param name="storageLimit">If not <c>null</c>, sets the maximum storage size (in kilobytes).</param>
  40779. <param name="cancellationToken">The cancellation token.</param>
  40780. <exception cref="T:System.ObjectDisposedException">
  40781. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40782. </exception>
  40783. <exception cref="T:MailKit.ServiceNotConnectedException">
  40784. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40785. </exception>
  40786. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40787. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40788. </exception>
  40789. <exception cref="T:System.NotSupportedException">
  40790. The mail store does not support quotas.
  40791. </exception>
  40792. <exception cref="T:System.OperationCanceledException">
  40793. The operation was canceled via the cancellation token.
  40794. </exception>
  40795. <exception cref="T:System.IO.IOException">
  40796. An I/O error occurred.
  40797. </exception>
  40798. <exception cref="T:MailKit.ProtocolException">
  40799. The server's response contained unexpected tokens.
  40800. </exception>
  40801. <exception cref="T:MailKit.CommandException">
  40802. The command failed.
  40803. </exception>
  40804. </member>
  40805. <member name="M:MailKit.MailFolder.GetMetadata(MailKit.MetadataTag,System.Threading.CancellationToken)">
  40806. <summary>
  40807. Get the specified metadata.
  40808. </summary>
  40809. <remarks>
  40810. Gets the specified metadata.
  40811. </remarks>
  40812. <returns>The requested metadata value.</returns>
  40813. <param name="tag">The metadata tag.</param>
  40814. <param name="cancellationToken">The cancellation token.</param>
  40815. <exception cref="T:System.ObjectDisposedException">
  40816. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40817. </exception>
  40818. <exception cref="T:MailKit.ServiceNotConnectedException">
  40819. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40820. </exception>
  40821. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40822. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40823. </exception>
  40824. <exception cref="T:System.NotSupportedException">
  40825. The folder does not support metadata.
  40826. </exception>
  40827. <exception cref="T:System.OperationCanceledException">
  40828. The operation was canceled via the cancellation token.
  40829. </exception>
  40830. <exception cref="T:System.IO.IOException">
  40831. An I/O error occurred.
  40832. </exception>
  40833. <exception cref="T:MailKit.ProtocolException">
  40834. The server's response contained unexpected tokens.
  40835. </exception>
  40836. <exception cref="T:MailKit.CommandException">
  40837. The command failed.
  40838. </exception>
  40839. </member>
  40840. <member name="M:MailKit.MailFolder.GetMetadataAsync(MailKit.MetadataTag,System.Threading.CancellationToken)">
  40841. <summary>
  40842. Asynchronously gets the specified metadata.
  40843. </summary>
  40844. <remarks>
  40845. Asynchronously gets the specified metadata.
  40846. </remarks>
  40847. <returns>The requested metadata value.</returns>
  40848. <param name="tag">The metadata tag.</param>
  40849. <param name="cancellationToken">The cancellation token.</param>
  40850. <exception cref="T:System.ObjectDisposedException">
  40851. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40852. </exception>
  40853. <exception cref="T:MailKit.ServiceNotConnectedException">
  40854. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40855. </exception>
  40856. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40857. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40858. </exception>
  40859. <exception cref="T:System.NotSupportedException">
  40860. The folder does not support metadata.
  40861. </exception>
  40862. <exception cref="T:System.OperationCanceledException">
  40863. The operation was canceled via the cancellation token.
  40864. </exception>
  40865. <exception cref="T:System.IO.IOException">
  40866. An I/O error occurred.
  40867. </exception>
  40868. <exception cref="T:MailKit.ProtocolException">
  40869. The server's response contained unexpected tokens.
  40870. </exception>
  40871. <exception cref="T:MailKit.CommandException">
  40872. The command failed.
  40873. </exception>
  40874. </member>
  40875. <member name="M:MailKit.MailFolder.GetMetadata(System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  40876. <summary>
  40877. Get the specified metadata.
  40878. </summary>
  40879. <remarks>
  40880. Gets the specified metadata.
  40881. </remarks>
  40882. <returns>The requested metadata.</returns>
  40883. <param name="tags">The metadata tags.</param>
  40884. <param name="cancellationToken">The cancellation token.</param>
  40885. <exception cref="T:System.ArgumentNullException">
  40886. <paramref name="tags"/> is <c>null</c>.
  40887. </exception>
  40888. <exception cref="T:System.ObjectDisposedException">
  40889. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40890. </exception>
  40891. <exception cref="T:MailKit.ServiceNotConnectedException">
  40892. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40893. </exception>
  40894. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40895. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40896. </exception>
  40897. <exception cref="T:System.NotSupportedException">
  40898. The folder does not support metadata.
  40899. </exception>
  40900. <exception cref="T:System.OperationCanceledException">
  40901. The operation was canceled via the cancellation token.
  40902. </exception>
  40903. <exception cref="T:System.IO.IOException">
  40904. An I/O error occurred.
  40905. </exception>
  40906. <exception cref="T:MailKit.ProtocolException">
  40907. The server's response contained unexpected tokens.
  40908. </exception>
  40909. <exception cref="T:MailKit.CommandException">
  40910. The command failed.
  40911. </exception>
  40912. </member>
  40913. <member name="M:MailKit.MailFolder.GetMetadataAsync(System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  40914. <summary>
  40915. Asynchronously gets the specified metadata.
  40916. </summary>
  40917. <remarks>
  40918. Asynchronously gets the specified metadata.
  40919. </remarks>
  40920. <returns>The requested metadata.</returns>
  40921. <param name="tags">The metadata tags.</param>
  40922. <param name="cancellationToken">The cancellation token.</param>
  40923. <exception cref="T:System.ArgumentNullException">
  40924. <paramref name="tags"/> is <c>null</c>.
  40925. </exception>
  40926. <exception cref="T:System.ObjectDisposedException">
  40927. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40928. </exception>
  40929. <exception cref="T:MailKit.ServiceNotConnectedException">
  40930. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40931. </exception>
  40932. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40933. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40934. </exception>
  40935. <exception cref="T:System.NotSupportedException">
  40936. The folder does not support metadata.
  40937. </exception>
  40938. <exception cref="T:System.OperationCanceledException">
  40939. The operation was canceled via the cancellation token.
  40940. </exception>
  40941. <exception cref="T:System.IO.IOException">
  40942. An I/O error occurred.
  40943. </exception>
  40944. <exception cref="T:MailKit.ProtocolException">
  40945. The server's response contained unexpected tokens.
  40946. </exception>
  40947. <exception cref="T:MailKit.CommandException">
  40948. The command failed.
  40949. </exception>
  40950. </member>
  40951. <member name="M:MailKit.MailFolder.GetMetadata(MailKit.MetadataOptions,System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  40952. <summary>
  40953. Get the specified metadata.
  40954. </summary>
  40955. <remarks>
  40956. Gets the specified metadata.
  40957. </remarks>
  40958. <returns>The requested metadata.</returns>
  40959. <param name="options">The metadata options.</param>
  40960. <param name="tags">The metadata tags.</param>
  40961. <param name="cancellationToken">The cancellation token.</param>
  40962. <exception cref="T:System.ArgumentNullException">
  40963. <para><paramref name="options"/> is <c>null</c>.</para>
  40964. <para>-or-</para>
  40965. <para><paramref name="tags"/> is <c>null</c>.</para>
  40966. </exception>
  40967. <exception cref="T:System.ObjectDisposedException">
  40968. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  40969. </exception>
  40970. <exception cref="T:MailKit.ServiceNotConnectedException">
  40971. The <see cref="T:MailKit.IMailStore"/> is not connected.
  40972. </exception>
  40973. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  40974. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  40975. </exception>
  40976. <exception cref="T:System.NotSupportedException">
  40977. The folder does not support metadata.
  40978. </exception>
  40979. <exception cref="T:System.OperationCanceledException">
  40980. The operation was canceled via the cancellation token.
  40981. </exception>
  40982. <exception cref="T:System.IO.IOException">
  40983. An I/O error occurred.
  40984. </exception>
  40985. <exception cref="T:MailKit.ProtocolException">
  40986. The server's response contained unexpected tokens.
  40987. </exception>
  40988. <exception cref="T:MailKit.CommandException">
  40989. The command failed.
  40990. </exception>
  40991. </member>
  40992. <member name="M:MailKit.MailFolder.GetMetadataAsync(MailKit.MetadataOptions,System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  40993. <summary>
  40994. Asynchronously gets the specified metadata.
  40995. </summary>
  40996. <remarks>
  40997. Asynchronously gets the specified metadata.
  40998. </remarks>
  40999. <returns>The requested metadata.</returns>
  41000. <param name="options">The metadata options.</param>
  41001. <param name="tags">The metadata tags.</param>
  41002. <param name="cancellationToken">The cancellation token.</param>
  41003. <exception cref="T:System.ArgumentNullException">
  41004. <para><paramref name="options"/> is <c>null</c>.</para>
  41005. <para>-or-</para>
  41006. <para><paramref name="tags"/> is <c>null</c>.</para>
  41007. </exception>
  41008. <exception cref="T:System.ObjectDisposedException">
  41009. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41010. </exception>
  41011. <exception cref="T:MailKit.ServiceNotConnectedException">
  41012. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41013. </exception>
  41014. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41015. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41016. </exception>
  41017. <exception cref="T:System.NotSupportedException">
  41018. The folder does not support metadata.
  41019. </exception>
  41020. <exception cref="T:System.OperationCanceledException">
  41021. The operation was canceled via the cancellation token.
  41022. </exception>
  41023. <exception cref="T:System.IO.IOException">
  41024. An I/O error occurred.
  41025. </exception>
  41026. <exception cref="T:MailKit.ProtocolException">
  41027. The server's response contained unexpected tokens.
  41028. </exception>
  41029. <exception cref="T:MailKit.CommandException">
  41030. The command failed.
  41031. </exception>
  41032. </member>
  41033. <member name="M:MailKit.MailFolder.SetMetadata(MailKit.MetadataCollection,System.Threading.CancellationToken)">
  41034. <summary>
  41035. Sets the specified metadata.
  41036. </summary>
  41037. <remarks>
  41038. Sets the specified metadata.
  41039. </remarks>
  41040. <param name="metadata">The metadata.</param>
  41041. <param name="cancellationToken">The cancellation token.</param>
  41042. <exception cref="T:System.ArgumentNullException">
  41043. <paramref name="metadata"/> is <c>null</c>.
  41044. </exception>
  41045. <exception cref="T:System.ObjectDisposedException">
  41046. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41047. </exception>
  41048. <exception cref="T:MailKit.ServiceNotConnectedException">
  41049. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41050. </exception>
  41051. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41052. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41053. </exception>
  41054. <exception cref="T:System.NotSupportedException">
  41055. The folder does not support metadata.
  41056. </exception>
  41057. <exception cref="T:System.OperationCanceledException">
  41058. The operation was canceled via the cancellation token.
  41059. </exception>
  41060. <exception cref="T:System.IO.IOException">
  41061. An I/O error occurred.
  41062. </exception>
  41063. <exception cref="T:MailKit.ProtocolException">
  41064. The server's response contained unexpected tokens.
  41065. </exception>
  41066. <exception cref="T:MailKit.CommandException">
  41067. The command failed.
  41068. </exception>
  41069. </member>
  41070. <member name="M:MailKit.MailFolder.SetMetadataAsync(MailKit.MetadataCollection,System.Threading.CancellationToken)">
  41071. <summary>
  41072. Asynchronously sets the specified metadata.
  41073. </summary>
  41074. <remarks>
  41075. Asynchronously sets the specified metadata.
  41076. </remarks>
  41077. <returns>An asynchronous task context.</returns>
  41078. <param name="metadata">The metadata.</param>
  41079. <param name="cancellationToken">The cancellation token.</param>
  41080. <exception cref="T:System.ArgumentNullException">
  41081. <paramref name="metadata"/> is <c>null</c>.
  41082. </exception>
  41083. <exception cref="T:System.ObjectDisposedException">
  41084. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41085. </exception>
  41086. <exception cref="T:MailKit.ServiceNotConnectedException">
  41087. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41088. </exception>
  41089. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41090. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41091. </exception>
  41092. <exception cref="T:System.NotSupportedException">
  41093. The folder does not support metadata.
  41094. </exception>
  41095. <exception cref="T:System.OperationCanceledException">
  41096. The operation was canceled via the cancellation token.
  41097. </exception>
  41098. <exception cref="T:System.IO.IOException">
  41099. An I/O error occurred.
  41100. </exception>
  41101. <exception cref="T:MailKit.ProtocolException">
  41102. The server's response contained unexpected tokens.
  41103. </exception>
  41104. <exception cref="T:MailKit.CommandException">
  41105. The command failed.
  41106. </exception>
  41107. </member>
  41108. <member name="M:MailKit.MailFolder.Expunge(System.Threading.CancellationToken)">
  41109. <summary>
  41110. Expunge the folder, permanently removing all messages marked for deletion.
  41111. </summary>
  41112. <remarks>
  41113. <para>Expunges the folder, permanently removing all messages marked for deletion.</para>
  41114. <note type="note">Normally, an <see cref="E:MailKit.MailFolder.MessageExpunged"/> event will be emitted for
  41115. each message that is expunged. However, if the mail store supports the quick
  41116. resynchronization feature and it has been enabled via the
  41117. <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/> method, then
  41118. the <see cref="E:MailKit.MailFolder.MessagesVanished"/> event will be emitted rather than the
  41119. <see cref="E:MailKit.MailFolder.MessageExpunged"/> event.</note>
  41120. </remarks>
  41121. <param name="cancellationToken">The cancellation token.</param>
  41122. <exception cref="T:System.ObjectDisposedException">
  41123. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41124. </exception>
  41125. <exception cref="T:MailKit.ServiceNotConnectedException">
  41126. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41127. </exception>
  41128. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41129. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41130. </exception>
  41131. <exception cref="T:MailKit.FolderNotOpenException">
  41132. The folder is not currently open in read-write mode.
  41133. </exception>
  41134. <exception cref="T:System.OperationCanceledException">
  41135. The operation was canceled via the cancellation token.
  41136. </exception>
  41137. <exception cref="T:System.IO.IOException">
  41138. An I/O error occurred.
  41139. </exception>
  41140. <exception cref="T:MailKit.ProtocolException">
  41141. The server's response contained unexpected tokens.
  41142. </exception>
  41143. <exception cref="T:MailKit.CommandException">
  41144. The command failed.
  41145. </exception>
  41146. </member>
  41147. <member name="M:MailKit.MailFolder.ExpungeAsync(System.Threading.CancellationToken)">
  41148. <summary>
  41149. Asynchronously expunge the folder, permanently removing all messages marked for deletion.
  41150. </summary>
  41151. <remarks>
  41152. <para>Asynchronously expunges the folder, permanently removing all messages marked for deletion.</para>
  41153. <note type="note">Normally, an <see cref="E:MailKit.MailFolder.MessageExpunged"/> event will be emitted for
  41154. each message that is expunged. However, if the mail store supports the quick
  41155. resynchronization feature and it has been enabled via the
  41156. <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/> method, then
  41157. the <see cref="E:MailKit.MailFolder.MessagesVanished"/> event will be emitted rather than the
  41158. <see cref="E:MailKit.MailFolder.MessageExpunged"/> event.</note>
  41159. </remarks>
  41160. <returns>An asynchronous task context.</returns>
  41161. <param name="cancellationToken">The cancellation token.</param>
  41162. <exception cref="T:System.ObjectDisposedException">
  41163. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41164. </exception>
  41165. <exception cref="T:MailKit.ServiceNotConnectedException">
  41166. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41167. </exception>
  41168. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41169. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41170. </exception>
  41171. <exception cref="T:MailKit.FolderNotOpenException">
  41172. The folder is not currently open in read-write mode.
  41173. </exception>
  41174. <exception cref="T:System.OperationCanceledException">
  41175. The operation was canceled via the cancellation token.
  41176. </exception>
  41177. <exception cref="T:System.IO.IOException">
  41178. An I/O error occurred.
  41179. </exception>
  41180. <exception cref="T:MailKit.ProtocolException">
  41181. The server's response contained unexpected tokens.
  41182. </exception>
  41183. <exception cref="T:MailKit.CommandException">
  41184. The command failed.
  41185. </exception>
  41186. </member>
  41187. <member name="M:MailKit.MailFolder.Expunge(System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)">
  41188. <summary>
  41189. Expunge the specified uids, permanently removing them from the folder.
  41190. </summary>
  41191. <remarks>
  41192. <para>Expunges the specified uids, permanently removing them from the folder.</para>
  41193. <note type="note">Normally, an <see cref="E:MailKit.MailFolder.MessageExpunged"/> event will be emitted for
  41194. each message that is expunged. However, if the mail store supports the quick
  41195. resynchronization feature and it has been enabled via the
  41196. <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/> method, then
  41197. the <see cref="E:MailKit.MailFolder.MessagesVanished"/> event will be emitted rather than the
  41198. <see cref="E:MailKit.MailFolder.MessageExpunged"/> event.</note>
  41199. </remarks>
  41200. <param name="uids">The message uids.</param>
  41201. <param name="cancellationToken">The cancellation token.</param>
  41202. <exception cref="T:System.ArgumentNullException">
  41203. <paramref name="uids"/> is <c>null</c>.
  41204. </exception>
  41205. <exception cref="T:System.ArgumentException">
  41206. One or more of the <paramref name="uids"/> is invalid.
  41207. </exception>
  41208. <exception cref="T:System.ObjectDisposedException">
  41209. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41210. </exception>
  41211. <exception cref="T:MailKit.ServiceNotConnectedException">
  41212. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41213. </exception>
  41214. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41215. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41216. </exception>
  41217. <exception cref="T:MailKit.FolderNotOpenException">
  41218. The folder is not currently open in read-write mode.
  41219. </exception>
  41220. <exception cref="T:System.OperationCanceledException">
  41221. The operation was canceled via the cancellation token.
  41222. </exception>
  41223. <exception cref="T:System.IO.IOException">
  41224. An I/O error occurred.
  41225. </exception>
  41226. <exception cref="T:MailKit.ProtocolException">
  41227. The server's response contained unexpected tokens.
  41228. </exception>
  41229. <exception cref="T:MailKit.CommandException">
  41230. The command failed.
  41231. </exception>
  41232. </member>
  41233. <member name="M:MailKit.MailFolder.ExpungeAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)">
  41234. <summary>
  41235. Asynchronously expunge the specified uids, permanently removing them from the folder.
  41236. </summary>
  41237. <remarks>
  41238. <para>Asynchronously expunges the specified uids, permanently removing them from the folder.</para>
  41239. <note type="note">Normally, an <see cref="E:MailKit.MailFolder.MessageExpunged"/> event will be emitted for
  41240. each message that is expunged. However, if the mail store supports the quick
  41241. resynchronization feature and it has been enabled via the
  41242. <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/> method, then
  41243. the <see cref="E:MailKit.MailFolder.MessagesVanished"/> event will be emitted rather than the
  41244. <see cref="E:MailKit.MailFolder.MessageExpunged"/> event.</note>
  41245. </remarks>
  41246. <returns>An asynchronous task context.</returns>
  41247. <param name="uids">The message uids.</param>
  41248. <param name="cancellationToken">The cancellation token.</param>
  41249. <exception cref="T:System.ArgumentNullException">
  41250. <paramref name="uids"/> is <c>null</c>.
  41251. </exception>
  41252. <exception cref="T:System.ArgumentException">
  41253. One or more of the <paramref name="uids"/> is invalid.
  41254. </exception>
  41255. <exception cref="T:System.ObjectDisposedException">
  41256. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41257. </exception>
  41258. <exception cref="T:MailKit.ServiceNotConnectedException">
  41259. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41260. </exception>
  41261. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41262. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41263. </exception>
  41264. <exception cref="T:MailKit.FolderNotOpenException">
  41265. The folder is not currently open in read-write mode.
  41266. </exception>
  41267. <exception cref="T:System.OperationCanceledException">
  41268. The operation was canceled via the cancellation token.
  41269. </exception>
  41270. <exception cref="T:System.IO.IOException">
  41271. An I/O error occurred.
  41272. </exception>
  41273. <exception cref="T:MailKit.ProtocolException">
  41274. The server's response contained unexpected tokens.
  41275. </exception>
  41276. <exception cref="T:MailKit.CommandException">
  41277. The command failed.
  41278. </exception>
  41279. </member>
  41280. <member name="M:MailKit.MailFolder.Append(MimeKit.MimeMessage,MailKit.MessageFlags,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41281. <summary>
  41282. Append the specified message to the folder.
  41283. </summary>
  41284. <remarks>
  41285. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  41286. </remarks>
  41287. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  41288. <param name="message">The message.</param>
  41289. <param name="flags">The message flags.</param>
  41290. <param name="cancellationToken">The cancellation token.</param>
  41291. <param name="progress">The progress reporting mechanism.</param>
  41292. <exception cref="T:System.ArgumentNullException">
  41293. <paramref name="message"/> is <c>null</c>.
  41294. </exception>
  41295. <exception cref="T:System.ObjectDisposedException">
  41296. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41297. </exception>
  41298. <exception cref="T:MailKit.ServiceNotConnectedException">
  41299. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41300. </exception>
  41301. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41302. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41303. </exception>
  41304. <exception cref="T:MailKit.FolderNotFoundException">
  41305. The <see cref="T:MailKit.MailFolder"/> does not exist.
  41306. </exception>
  41307. <exception cref="T:System.OperationCanceledException">
  41308. The operation was canceled via the cancellation token.
  41309. </exception>
  41310. <exception cref="T:System.IO.IOException">
  41311. An I/O error occurred.
  41312. </exception>
  41313. <exception cref="T:MailKit.ProtocolException">
  41314. The server's response contained unexpected tokens.
  41315. </exception>
  41316. <exception cref="T:MailKit.CommandException">
  41317. The command failed.
  41318. </exception>
  41319. </member>
  41320. <member name="M:MailKit.MailFolder.AppendAsync(MimeKit.MimeMessage,MailKit.MessageFlags,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41321. <summary>
  41322. Asynchronously append the specified message to the folder.
  41323. </summary>
  41324. <remarks>
  41325. Asynchronously appends the specified message to the folder and returns the UniqueId assigned to the message.
  41326. </remarks>
  41327. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  41328. <param name="message">The message.</param>
  41329. <param name="flags">The message flags.</param>
  41330. <param name="cancellationToken">The cancellation token.</param>
  41331. <param name="progress">The progress reporting mechanism.</param>
  41332. <exception cref="T:System.ArgumentNullException">
  41333. <paramref name="message"/> is <c>null</c>.
  41334. </exception>
  41335. <exception cref="T:System.ObjectDisposedException">
  41336. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41337. </exception>
  41338. <exception cref="T:MailKit.ServiceNotConnectedException">
  41339. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41340. </exception>
  41341. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41342. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41343. </exception>
  41344. <exception cref="T:MailKit.FolderNotFoundException">
  41345. The <see cref="T:MailKit.MailFolder"/> does not exist.
  41346. </exception>
  41347. <exception cref="T:System.OperationCanceledException">
  41348. The operation was canceled via the cancellation token.
  41349. </exception>
  41350. <exception cref="T:System.IO.IOException">
  41351. An I/O error occurred.
  41352. </exception>
  41353. <exception cref="T:MailKit.ProtocolException">
  41354. The server's response contained unexpected tokens.
  41355. </exception>
  41356. <exception cref="T:MailKit.CommandException">
  41357. The command failed.
  41358. </exception>
  41359. </member>
  41360. <member name="M:MailKit.MailFolder.Append(MimeKit.MimeMessage,MailKit.MessageFlags,System.DateTimeOffset,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41361. <summary>
  41362. Append the specified message to the folder.
  41363. </summary>
  41364. <remarks>
  41365. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  41366. </remarks>
  41367. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  41368. <param name="message">The message.</param>
  41369. <param name="flags">The message flags.</param>
  41370. <param name="date">The received date of the message.</param>
  41371. <param name="cancellationToken">The cancellation token.</param>
  41372. <param name="progress">The progress reporting mechanism.</param>
  41373. <exception cref="T:System.ArgumentNullException">
  41374. <paramref name="message"/> is <c>null</c>.
  41375. </exception>
  41376. <exception cref="T:System.ObjectDisposedException">
  41377. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41378. </exception>
  41379. <exception cref="T:MailKit.ServiceNotConnectedException">
  41380. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41381. </exception>
  41382. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41383. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41384. </exception>
  41385. <exception cref="T:MailKit.FolderNotFoundException">
  41386. The <see cref="T:MailKit.MailFolder"/> does not exist.
  41387. </exception>
  41388. <exception cref="T:System.OperationCanceledException">
  41389. The operation was canceled via the cancellation token.
  41390. </exception>
  41391. <exception cref="T:System.IO.IOException">
  41392. An I/O error occurred.
  41393. </exception>
  41394. <exception cref="T:MailKit.ProtocolException">
  41395. The server's response contained unexpected tokens.
  41396. </exception>
  41397. <exception cref="T:MailKit.CommandException">
  41398. The command failed.
  41399. </exception>
  41400. </member>
  41401. <member name="M:MailKit.MailFolder.AppendAsync(MimeKit.MimeMessage,MailKit.MessageFlags,System.DateTimeOffset,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41402. <summary>
  41403. Asynchronously append the specified message to the folder.
  41404. </summary>
  41405. <remarks>
  41406. Asynchronously appends the specified message to the folder and returns the UniqueId assigned to the message.
  41407. </remarks>
  41408. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  41409. <param name="message">The message.</param>
  41410. <param name="flags">The message flags.</param>
  41411. <param name="date">The received date of the message.</param>
  41412. <param name="cancellationToken">The cancellation token.</param>
  41413. <param name="progress">The progress reporting mechanism.</param>
  41414. <exception cref="T:System.ArgumentNullException">
  41415. <paramref name="message"/> is <c>null</c>.
  41416. </exception>
  41417. <exception cref="T:System.ObjectDisposedException">
  41418. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41419. </exception>
  41420. <exception cref="T:MailKit.ServiceNotConnectedException">
  41421. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41422. </exception>
  41423. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41424. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41425. </exception>
  41426. <exception cref="T:MailKit.FolderNotFoundException">
  41427. The <see cref="T:MailKit.MailFolder"/> does not exist.
  41428. </exception>
  41429. <exception cref="T:System.OperationCanceledException">
  41430. The operation was canceled via the cancellation token.
  41431. </exception>
  41432. <exception cref="T:System.IO.IOException">
  41433. An I/O error occurred.
  41434. </exception>
  41435. <exception cref="T:MailKit.ProtocolException">
  41436. The server's response contained unexpected tokens.
  41437. </exception>
  41438. <exception cref="T:MailKit.CommandException">
  41439. The command failed.
  41440. </exception>
  41441. </member>
  41442. <member name="M:MailKit.MailFolder.Append(MimeKit.MimeMessage,MailKit.MessageFlags,System.Nullable{System.DateTimeOffset},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41443. <summary>
  41444. Append the specified message to the folder.
  41445. </summary>
  41446. <remarks>
  41447. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  41448. </remarks>
  41449. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  41450. <param name="message">The message.</param>
  41451. <param name="flags">The message flags.</param>
  41452. <param name="date">The received date of the message.</param>
  41453. <param name="annotations">The message annotations.</param>
  41454. <param name="cancellationToken">The cancellation token.</param>
  41455. <param name="progress">The progress reporting mechanism.</param>
  41456. <exception cref="T:System.ArgumentNullException">
  41457. <paramref name="message"/> is <c>null</c>.
  41458. </exception>
  41459. <exception cref="T:System.ObjectDisposedException">
  41460. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41461. </exception>
  41462. <exception cref="T:MailKit.ServiceNotConnectedException">
  41463. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41464. </exception>
  41465. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41466. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41467. </exception>
  41468. <exception cref="T:MailKit.FolderNotFoundException">
  41469. The <see cref="T:MailKit.MailFolder"/> does not exist.
  41470. </exception>
  41471. <exception cref="T:System.InvalidOperationException">
  41472. One or more <paramref name="annotations"/> does not define any properties.
  41473. </exception>"
  41474. <exception cref="T:System.OperationCanceledException">
  41475. The operation was canceled via the cancellation token.
  41476. </exception>
  41477. <exception cref="T:System.IO.IOException">
  41478. An I/O error occurred.
  41479. </exception>
  41480. <exception cref="T:MailKit.ProtocolException">
  41481. The server's response contained unexpected tokens.
  41482. </exception>
  41483. <exception cref="T:MailKit.CommandException">
  41484. The command failed.
  41485. </exception>
  41486. </member>
  41487. <member name="M:MailKit.MailFolder.AppendAsync(MimeKit.MimeMessage,MailKit.MessageFlags,System.Nullable{System.DateTimeOffset},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41488. <summary>
  41489. Asynchronously append the specified message to the folder.
  41490. </summary>
  41491. <remarks>
  41492. Asynchronously appends the specified message to the folder and returns the UniqueId assigned to the message.
  41493. </remarks>
  41494. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  41495. <param name="message">The message.</param>
  41496. <param name="flags">The message flags.</param>
  41497. <param name="date">The received date of the message.</param>
  41498. <param name="annotations">The message annotations.</param>
  41499. <param name="cancellationToken">The cancellation token.</param>
  41500. <param name="progress">The progress reporting mechanism.</param>
  41501. <exception cref="T:System.ArgumentNullException">
  41502. <paramref name="message"/> is <c>null</c>.
  41503. </exception>
  41504. <exception cref="T:System.ObjectDisposedException">
  41505. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41506. </exception>
  41507. <exception cref="T:MailKit.ServiceNotConnectedException">
  41508. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41509. </exception>
  41510. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41511. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41512. </exception>
  41513. <exception cref="T:MailKit.FolderNotFoundException">
  41514. The <see cref="T:MailKit.MailFolder"/> does not exist.
  41515. </exception>
  41516. <exception cref="T:System.InvalidOperationException">
  41517. One or more <paramref name="annotations"/> does not define any properties.
  41518. </exception>"
  41519. <exception cref="T:System.OperationCanceledException">
  41520. The operation was canceled via the cancellation token.
  41521. </exception>
  41522. <exception cref="T:System.IO.IOException">
  41523. An I/O error occurred.
  41524. </exception>
  41525. <exception cref="T:MailKit.ProtocolException">
  41526. The server's response contained unexpected tokens.
  41527. </exception>
  41528. <exception cref="T:MailKit.CommandException">
  41529. The command failed.
  41530. </exception>
  41531. </member>
  41532. <member name="M:MailKit.MailFolder.Append(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41533. <summary>
  41534. Append the specified message to the folder.
  41535. </summary>
  41536. <remarks>
  41537. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  41538. </remarks>
  41539. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  41540. <param name="options">The formatting options.</param>
  41541. <param name="message">The message.</param>
  41542. <param name="flags">The message flags.</param>
  41543. <param name="cancellationToken">The cancellation token.</param>
  41544. <param name="progress">The progress reporting mechanism.</param>
  41545. <exception cref="T:System.ArgumentNullException">
  41546. <para><paramref name="options"/> is <c>null</c>.</para>
  41547. <para>-or-</para>
  41548. <para><paramref name="message"/> is <c>null</c>.</para>
  41549. </exception>
  41550. <exception cref="T:System.ObjectDisposedException">
  41551. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41552. </exception>
  41553. <exception cref="T:MailKit.ServiceNotConnectedException">
  41554. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41555. </exception>
  41556. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41557. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41558. </exception>
  41559. <exception cref="T:MailKit.FolderNotFoundException">
  41560. The <see cref="T:MailKit.MailFolder"/> does not exist.
  41561. </exception>
  41562. <exception cref="T:System.InvalidOperationException">
  41563. Internationalized formatting was requested but has not been enabled.
  41564. </exception>
  41565. <exception cref="T:System.OperationCanceledException">
  41566. The operation was canceled via the cancellation token.
  41567. </exception>
  41568. <exception cref="T:System.NotSupportedException">
  41569. Internationalized formatting was requested but is not supported by the server.
  41570. </exception>
  41571. <exception cref="T:System.IO.IOException">
  41572. An I/O error occurred.
  41573. </exception>
  41574. <exception cref="T:MailKit.ProtocolException">
  41575. The server's response contained unexpected tokens.
  41576. </exception>
  41577. <exception cref="T:MailKit.CommandException">
  41578. The command failed.
  41579. </exception>
  41580. </member>
  41581. <member name="M:MailKit.MailFolder.AppendAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41582. <summary>
  41583. Asynchronously append the specified message to the folder.
  41584. </summary>
  41585. <remarks>
  41586. Asynchronously appends the specified message to the folder and returns the UniqueId assigned to the message.
  41587. </remarks>
  41588. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  41589. <param name="options">The formatting options.</param>
  41590. <param name="message">The message.</param>
  41591. <param name="flags">The message flags.</param>
  41592. <param name="cancellationToken">The cancellation token.</param>
  41593. <param name="progress">The progress reporting mechanism.</param>
  41594. <exception cref="T:System.ArgumentNullException">
  41595. <para><paramref name="options"/> is <c>null</c>.</para>
  41596. <para>-or-</para>
  41597. <para><paramref name="message"/> is <c>null</c>.</para>
  41598. </exception>
  41599. <exception cref="T:System.ObjectDisposedException">
  41600. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41601. </exception>
  41602. <exception cref="T:MailKit.ServiceNotConnectedException">
  41603. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41604. </exception>
  41605. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41606. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41607. </exception>
  41608. <exception cref="T:MailKit.FolderNotFoundException">
  41609. The <see cref="T:MailKit.MailFolder"/> does not exist.
  41610. </exception>
  41611. <exception cref="T:System.InvalidOperationException">
  41612. Internationalized formatting was requested but has not been enabled.
  41613. </exception>
  41614. <exception cref="T:System.OperationCanceledException">
  41615. The operation was canceled via the cancellation token.
  41616. </exception>
  41617. <exception cref="T:System.NotSupportedException">
  41618. Internationalized formatting was requested but is not supported by the server.
  41619. </exception>
  41620. <exception cref="T:System.IO.IOException">
  41621. An I/O error occurred.
  41622. </exception>
  41623. <exception cref="T:MailKit.ProtocolException">
  41624. The server's response contained unexpected tokens.
  41625. </exception>
  41626. <exception cref="T:MailKit.CommandException">
  41627. The command failed.
  41628. </exception>
  41629. </member>
  41630. <member name="M:MailKit.MailFolder.Append(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.DateTimeOffset,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41631. <summary>
  41632. Append the specified message to the folder.
  41633. </summary>
  41634. <remarks>
  41635. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  41636. </remarks>
  41637. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  41638. <param name="options">The formatting options.</param>
  41639. <param name="message">The message.</param>
  41640. <param name="flags">The message flags.</param>
  41641. <param name="date">The received date of the message.</param>
  41642. <param name="cancellationToken">The cancellation token.</param>
  41643. <param name="progress">The progress reporting mechanism.</param>
  41644. <exception cref="T:System.ArgumentNullException">
  41645. <para><paramref name="options"/> is <c>null</c>.</para>
  41646. <para>-or-</para>
  41647. <para><paramref name="message"/> is <c>null</c>.</para>
  41648. </exception>
  41649. <exception cref="T:System.ObjectDisposedException">
  41650. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41651. </exception>
  41652. <exception cref="T:MailKit.ServiceNotConnectedException">
  41653. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41654. </exception>
  41655. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41656. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41657. </exception>
  41658. <exception cref="T:MailKit.FolderNotFoundException">
  41659. The <see cref="T:MailKit.MailFolder"/> does not exist.
  41660. </exception>
  41661. <exception cref="T:System.InvalidOperationException">
  41662. Internationalized formatting was requested but has not been enabled.
  41663. </exception>
  41664. <exception cref="T:System.OperationCanceledException">
  41665. The operation was canceled via the cancellation token.
  41666. </exception>
  41667. <exception cref="T:System.NotSupportedException">
  41668. Internationalized formatting was requested but is not supported by the server.
  41669. </exception>
  41670. <exception cref="T:System.IO.IOException">
  41671. An I/O error occurred.
  41672. </exception>
  41673. <exception cref="T:MailKit.ProtocolException">
  41674. The server's response contained unexpected tokens.
  41675. </exception>
  41676. <exception cref="T:MailKit.CommandException">
  41677. The command failed.
  41678. </exception>
  41679. </member>
  41680. <member name="M:MailKit.MailFolder.AppendAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.DateTimeOffset,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41681. <summary>
  41682. Asynchronously append the specified message to the folder.
  41683. </summary>
  41684. <remarks>
  41685. Asynchronously appends the specified message to the folder and returns the UniqueId assigned to the message.
  41686. </remarks>
  41687. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  41688. <param name="options">The formatting options.</param>
  41689. <param name="message">The message.</param>
  41690. <param name="flags">The message flags.</param>
  41691. <param name="date">The received date of the message.</param>
  41692. <param name="cancellationToken">The cancellation token.</param>
  41693. <param name="progress">The progress reporting mechanism.</param>
  41694. <exception cref="T:System.ArgumentNullException">
  41695. <para><paramref name="options"/> is <c>null</c>.</para>
  41696. <para>-or-</para>
  41697. <para><paramref name="message"/> is <c>null</c>.</para>
  41698. </exception>
  41699. <exception cref="T:System.ObjectDisposedException">
  41700. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41701. </exception>
  41702. <exception cref="T:MailKit.ServiceNotConnectedException">
  41703. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41704. </exception>
  41705. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41706. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41707. </exception>
  41708. <exception cref="T:MailKit.FolderNotFoundException">
  41709. The <see cref="T:MailKit.MailFolder"/> does not exist.
  41710. </exception>
  41711. <exception cref="T:System.InvalidOperationException">
  41712. Internationalized formatting was requested but has not been enabled.
  41713. </exception>
  41714. <exception cref="T:System.OperationCanceledException">
  41715. The operation was canceled via the cancellation token.
  41716. </exception>
  41717. <exception cref="T:System.NotSupportedException">
  41718. Internationalized formatting was requested but is not supported by the server.
  41719. </exception>
  41720. <exception cref="T:System.IO.IOException">
  41721. An I/O error occurred.
  41722. </exception>
  41723. <exception cref="T:MailKit.ProtocolException">
  41724. The server's response contained unexpected tokens.
  41725. </exception>
  41726. <exception cref="T:MailKit.CommandException">
  41727. The command failed.
  41728. </exception>
  41729. </member>
  41730. <member name="M:MailKit.MailFolder.Append(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.Nullable{System.DateTimeOffset},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41731. <summary>
  41732. Append the specified message to the folder.
  41733. </summary>
  41734. <remarks>
  41735. Appends the specified message to the folder and returns the UniqueId assigned to the message.
  41736. </remarks>
  41737. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  41738. <param name="options">The formatting options.</param>
  41739. <param name="message">The message.</param>
  41740. <param name="flags">The message flags.</param>
  41741. <param name="date">The received date of the message.</param>
  41742. <param name="annotations">The message annotations.</param>
  41743. <param name="cancellationToken">The cancellation token.</param>
  41744. <param name="progress">The progress reporting mechanism.</param>
  41745. <exception cref="T:System.ArgumentNullException">
  41746. <para><paramref name="options"/> is <c>null</c>.</para>
  41747. <para>-or-</para>
  41748. <para><paramref name="message"/> is <c>null</c>.</para>
  41749. </exception>
  41750. <exception cref="T:System.ObjectDisposedException">
  41751. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41752. </exception>
  41753. <exception cref="T:MailKit.ServiceNotConnectedException">
  41754. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41755. </exception>
  41756. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41757. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41758. </exception>
  41759. <exception cref="T:MailKit.FolderNotFoundException">
  41760. The <see cref="T:MailKit.MailFolder"/> does not exist.
  41761. </exception>
  41762. <exception cref="T:System.InvalidOperationException">
  41763. Internationalized formatting was requested but has not been enabled.
  41764. </exception>
  41765. <exception cref="T:System.OperationCanceledException">
  41766. The operation was canceled via the cancellation token.
  41767. </exception>
  41768. <exception cref="T:System.NotSupportedException">
  41769. Internationalized formatting was requested but is not supported by the server.
  41770. </exception>
  41771. <exception cref="T:System.IO.IOException">
  41772. An I/O error occurred.
  41773. </exception>
  41774. <exception cref="T:MailKit.ProtocolException">
  41775. The server's response contained unexpected tokens.
  41776. </exception>
  41777. <exception cref="T:MailKit.CommandException">
  41778. The command failed.
  41779. </exception>
  41780. </member>
  41781. <member name="M:MailKit.MailFolder.AppendAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,MailKit.MessageFlags,System.Nullable{System.DateTimeOffset},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41782. <summary>
  41783. Asynchronously append the specified message to the folder.
  41784. </summary>
  41785. <remarks>
  41786. Asynchronously appends the specified message to the folder and returns the UniqueId assigned to the message.
  41787. </remarks>
  41788. <returns>The UID of the appended message, if available; otherwise, <c>null</c>.</returns>
  41789. <param name="options">The formatting options.</param>
  41790. <param name="message">The message.</param>
  41791. <param name="flags">The message flags.</param>
  41792. <param name="date">The received date of the message.</param>
  41793. <param name="annotations">The message annotations.</param>
  41794. <param name="cancellationToken">The cancellation token.</param>
  41795. <param name="progress">The progress reporting mechanism.</param>
  41796. <exception cref="T:System.ArgumentNullException">
  41797. <para><paramref name="options"/> is <c>null</c>.</para>
  41798. <para>-or-</para>
  41799. <para><paramref name="message"/> is <c>null</c>.</para>
  41800. </exception>
  41801. <exception cref="T:System.ObjectDisposedException">
  41802. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41803. </exception>
  41804. <exception cref="T:MailKit.ServiceNotConnectedException">
  41805. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41806. </exception>
  41807. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41808. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41809. </exception>
  41810. <exception cref="T:MailKit.FolderNotFoundException">
  41811. The <see cref="T:MailKit.MailFolder"/> does not exist.
  41812. </exception>
  41813. <exception cref="T:System.InvalidOperationException">
  41814. Internationalized formatting was requested but has not been enabled.
  41815. </exception>
  41816. <exception cref="T:System.OperationCanceledException">
  41817. The operation was canceled via the cancellation token.
  41818. </exception>
  41819. <exception cref="T:System.NotSupportedException">
  41820. Internationalized formatting was requested but is not supported by the server.
  41821. </exception>
  41822. <exception cref="T:System.IO.IOException">
  41823. An I/O error occurred.
  41824. </exception>
  41825. <exception cref="T:MailKit.ProtocolException">
  41826. The server's response contained unexpected tokens.
  41827. </exception>
  41828. <exception cref="T:MailKit.CommandException">
  41829. The command failed.
  41830. </exception>
  41831. </member>
  41832. <member name="M:MailKit.MailFolder.Append(System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41833. <summary>
  41834. Append the specified messages to the folder.
  41835. </summary>
  41836. <remarks>
  41837. Appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  41838. </remarks>
  41839. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  41840. <param name="messages">The array of messages to append to the folder.</param>
  41841. <param name="flags">The message flags to use for each message.</param>
  41842. <param name="cancellationToken">The cancellation token.</param>
  41843. <param name="progress">The progress reporting mechanism.</param>
  41844. <exception cref="T:System.ArgumentNullException">
  41845. <para><paramref name="messages"/> is <c>null</c>.</para>
  41846. <para>-or-</para>
  41847. <para><paramref name="flags"/> is <c>null</c>.</para>
  41848. </exception>
  41849. <exception cref="T:System.ArgumentException">
  41850. <para>One or more of the <paramref name="messages"/> is null.</para>
  41851. <para>-or-</para>
  41852. <para>The number of messages does not match the number of flags.</para>
  41853. </exception>
  41854. <exception cref="T:System.ObjectDisposedException">
  41855. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41856. </exception>
  41857. <exception cref="T:MailKit.ServiceNotConnectedException">
  41858. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41859. </exception>
  41860. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41861. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41862. </exception>
  41863. <exception cref="T:MailKit.FolderNotFoundException">
  41864. The <see cref="T:MailKit.MailFolder"/> does not exist.
  41865. </exception>
  41866. <exception cref="T:System.OperationCanceledException">
  41867. The operation was canceled via the cancellation token.
  41868. </exception>
  41869. <exception cref="T:System.IO.IOException">
  41870. An I/O error occurred.
  41871. </exception>
  41872. <exception cref="T:MailKit.ProtocolException">
  41873. The server's response contained unexpected tokens.
  41874. </exception>
  41875. <exception cref="T:MailKit.CommandException">
  41876. The command failed.
  41877. </exception>
  41878. </member>
  41879. <member name="M:MailKit.MailFolder.AppendAsync(System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41880. <summary>
  41881. Asynchronously append the specified messages to the folder.
  41882. </summary>
  41883. <remarks>
  41884. Asynchronously appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  41885. </remarks>
  41886. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  41887. <param name="messages">The array of messages to append to the folder.</param>
  41888. <param name="flags">The message flags to use for each message.</param>
  41889. <param name="cancellationToken">The cancellation token.</param>
  41890. <param name="progress">The progress reporting mechanism.</param>
  41891. <exception cref="T:System.ArgumentNullException">
  41892. <para><paramref name="messages"/> is <c>null</c>.</para>
  41893. <para>-or-</para>
  41894. <para><paramref name="flags"/> is <c>null</c>.</para>
  41895. </exception>
  41896. <exception cref="T:System.ArgumentException">
  41897. <para>One or more of the <paramref name="messages"/> is null.</para>
  41898. <para>-or-</para>
  41899. <para>The number of messages does not match the number of flags.</para>
  41900. </exception>
  41901. <exception cref="T:System.ObjectDisposedException">
  41902. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41903. </exception>
  41904. <exception cref="T:MailKit.ServiceNotConnectedException">
  41905. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41906. </exception>
  41907. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41908. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41909. </exception>
  41910. <exception cref="T:MailKit.FolderNotFoundException">
  41911. The <see cref="T:MailKit.MailFolder"/> does not exist.
  41912. </exception>
  41913. <exception cref="T:System.OperationCanceledException">
  41914. The operation was canceled via the cancellation token.
  41915. </exception>
  41916. <exception cref="T:System.IO.IOException">
  41917. An I/O error occurred.
  41918. </exception>
  41919. <exception cref="T:MailKit.ProtocolException">
  41920. The server's response contained unexpected tokens.
  41921. </exception>
  41922. <exception cref="T:MailKit.CommandException">
  41923. The command failed.
  41924. </exception>
  41925. </member>
  41926. <member name="M:MailKit.MailFolder.Append(System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Collections.Generic.IList{System.DateTimeOffset},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41927. <summary>
  41928. Append the specified messages to the folder.
  41929. </summary>
  41930. <remarks>
  41931. Appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  41932. </remarks>
  41933. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  41934. <param name="messages">The array of messages to append to the folder.</param>
  41935. <param name="flags">The message flags to use for each of the messages.</param>
  41936. <param name="dates">The received dates to use for each of the messages.</param>
  41937. <param name="cancellationToken">The cancellation token.</param>
  41938. <param name="progress">The progress reporting mechanism.</param>
  41939. <exception cref="T:System.ArgumentNullException">
  41940. <para><paramref name="messages"/> is <c>null</c>.</para>
  41941. <para>-or-</para>
  41942. <para><paramref name="flags"/> is <c>null</c>.</para>
  41943. <para>-or-</para>
  41944. <para><paramref name="dates"/> is <c>null</c>.</para>
  41945. </exception>
  41946. <exception cref="T:System.ArgumentException">
  41947. <para>One or more of the <paramref name="messages"/> is null.</para>
  41948. <para>-or-</para>
  41949. <para>The number of messages, flags, and dates do not match.</para>
  41950. </exception>
  41951. <exception cref="T:System.ObjectDisposedException">
  41952. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  41953. </exception>
  41954. <exception cref="T:MailKit.ServiceNotConnectedException">
  41955. The <see cref="T:MailKit.IMailStore"/> is not connected.
  41956. </exception>
  41957. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  41958. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  41959. </exception>
  41960. <exception cref="T:MailKit.FolderNotFoundException">
  41961. The <see cref="T:MailKit.MailFolder"/> does not exist.
  41962. </exception>
  41963. <exception cref="T:System.OperationCanceledException">
  41964. The operation was canceled via the cancellation token.
  41965. </exception>
  41966. <exception cref="T:System.IO.IOException">
  41967. An I/O error occurred.
  41968. </exception>
  41969. <exception cref="T:MailKit.ProtocolException">
  41970. The server's response contained unexpected tokens.
  41971. </exception>
  41972. <exception cref="T:MailKit.CommandException">
  41973. The command failed.
  41974. </exception>
  41975. </member>
  41976. <member name="M:MailKit.MailFolder.AppendAsync(System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Collections.Generic.IList{System.DateTimeOffset},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  41977. <summary>
  41978. Asynchronously append the specified messages to the folder.
  41979. </summary>
  41980. <remarks>
  41981. Asynchronously appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  41982. </remarks>
  41983. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  41984. <param name="messages">The array of messages to append to the folder.</param>
  41985. <param name="flags">The message flags to use for each of the messages.</param>
  41986. <param name="dates">The received dates to use for each of the messages.</param>
  41987. <param name="cancellationToken">The cancellation token.</param>
  41988. <param name="progress">The progress reporting mechanism.</param>
  41989. <exception cref="T:System.ArgumentNullException">
  41990. <para><paramref name="messages"/> is <c>null</c>.</para>
  41991. <para>-or-</para>
  41992. <para><paramref name="flags"/> is <c>null</c>.</para>
  41993. <para>-or-</para>
  41994. <para><paramref name="dates"/> is <c>null</c>.</para>
  41995. </exception>
  41996. <exception cref="T:System.ArgumentException">
  41997. <para>One or more of the <paramref name="messages"/> is null.</para>
  41998. <para>-or-</para>
  41999. <para>The number of messages, flags, and dates do not match.</para>
  42000. </exception>
  42001. <exception cref="T:System.ObjectDisposedException">
  42002. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42003. </exception>
  42004. <exception cref="T:MailKit.ServiceNotConnectedException">
  42005. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42006. </exception>
  42007. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42008. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42009. </exception>
  42010. <exception cref="T:MailKit.FolderNotFoundException">
  42011. The <see cref="T:MailKit.MailFolder"/> does not exist.
  42012. </exception>
  42013. <exception cref="T:System.OperationCanceledException">
  42014. The operation was canceled via the cancellation token.
  42015. </exception>
  42016. <exception cref="T:System.IO.IOException">
  42017. An I/O error occurred.
  42018. </exception>
  42019. <exception cref="T:MailKit.ProtocolException">
  42020. The server's response contained unexpected tokens.
  42021. </exception>
  42022. <exception cref="T:MailKit.CommandException">
  42023. The command failed.
  42024. </exception>
  42025. </member>
  42026. <member name="M:MailKit.MailFolder.Append(MimeKit.FormatOptions,System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  42027. <summary>
  42028. Append the specified messages to the folder.
  42029. </summary>
  42030. <remarks>
  42031. Appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  42032. </remarks>
  42033. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  42034. <param name="options">The formatting options.</param>
  42035. <param name="messages">The array of messages to append to the folder.</param>
  42036. <param name="flags">The message flags to use for each message.</param>
  42037. <param name="cancellationToken">The cancellation token.</param>
  42038. <param name="progress">The progress reporting mechanism.</param>
  42039. <exception cref="T:System.ArgumentNullException">
  42040. <para><paramref name="options"/> is <c>null</c>.</para>
  42041. <para>-or-</para>
  42042. <para><paramref name="messages"/> is <c>null</c>.</para>
  42043. <para>-or-</para>
  42044. <para><paramref name="flags"/> is <c>null</c>.</para>
  42045. </exception>
  42046. <exception cref="T:System.ArgumentException">
  42047. <para>One or more of the <paramref name="messages"/> is null.</para>
  42048. <para>-or-</para>
  42049. <para>The number of messages does not match the number of flags.</para>
  42050. </exception>
  42051. <exception cref="T:System.ObjectDisposedException">
  42052. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42053. </exception>
  42054. <exception cref="T:MailKit.ServiceNotConnectedException">
  42055. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42056. </exception>
  42057. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42058. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42059. </exception>
  42060. <exception cref="T:MailKit.FolderNotFoundException">
  42061. The <see cref="T:MailKit.MailFolder"/> does not exist.
  42062. </exception>
  42063. <exception cref="T:System.InvalidOperationException">
  42064. Internationalized formatting was requested but has not been enabled.
  42065. </exception>
  42066. <exception cref="T:System.OperationCanceledException">
  42067. The operation was canceled via the cancellation token.
  42068. </exception>
  42069. <exception cref="T:System.NotSupportedException">
  42070. Internationalized formatting was requested but is not supported by the server.
  42071. </exception>
  42072. <exception cref="T:System.IO.IOException">
  42073. An I/O error occurred.
  42074. </exception>
  42075. <exception cref="T:MailKit.ProtocolException">
  42076. The server's response contained unexpected tokens.
  42077. </exception>
  42078. <exception cref="T:MailKit.CommandException">
  42079. The command failed.
  42080. </exception>
  42081. </member>
  42082. <member name="M:MailKit.MailFolder.AppendAsync(MimeKit.FormatOptions,System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  42083. <summary>
  42084. Asynchronously append the specified messages to the folder.
  42085. </summary>
  42086. <remarks>
  42087. Asynchronously appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  42088. </remarks>
  42089. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  42090. <param name="options">The formatting options.</param>
  42091. <param name="messages">The array of messages to append to the folder.</param>
  42092. <param name="flags">The message flags to use for each message.</param>
  42093. <param name="cancellationToken">The cancellation token.</param>
  42094. <param name="progress">The progress reporting mechanism.</param>
  42095. <exception cref="T:System.ArgumentNullException">
  42096. <para><paramref name="options"/> is <c>null</c>.</para>
  42097. <para>-or-</para>
  42098. <para><paramref name="messages"/> is <c>null</c>.</para>
  42099. <para>-or-</para>
  42100. <para><paramref name="flags"/> is <c>null</c>.</para>
  42101. </exception>
  42102. <exception cref="T:System.ArgumentException">
  42103. <para>One or more of the <paramref name="messages"/> is null.</para>
  42104. <para>-or-</para>
  42105. <para>The number of messages does not match the number of flags.</para>
  42106. </exception>
  42107. <exception cref="T:System.ObjectDisposedException">
  42108. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42109. </exception>
  42110. <exception cref="T:MailKit.ServiceNotConnectedException">
  42111. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42112. </exception>
  42113. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42114. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42115. </exception>
  42116. <exception cref="T:MailKit.FolderNotFoundException">
  42117. The <see cref="T:MailKit.MailFolder"/> does not exist.
  42118. </exception>
  42119. <exception cref="T:System.InvalidOperationException">
  42120. Internationalized formatting was requested but has not been enabled.
  42121. </exception>
  42122. <exception cref="T:System.OperationCanceledException">
  42123. The operation was canceled via the cancellation token.
  42124. </exception>
  42125. <exception cref="T:System.NotSupportedException">
  42126. Internationalized formatting was requested but is not supported by the server.
  42127. </exception>
  42128. <exception cref="T:System.IO.IOException">
  42129. An I/O error occurred.
  42130. </exception>
  42131. <exception cref="T:MailKit.ProtocolException">
  42132. The server's response contained unexpected tokens.
  42133. </exception>
  42134. <exception cref="T:MailKit.CommandException">
  42135. The command failed.
  42136. </exception>
  42137. </member>
  42138. <member name="M:MailKit.MailFolder.Append(MimeKit.FormatOptions,System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Collections.Generic.IList{System.DateTimeOffset},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  42139. <summary>
  42140. Append the specified messages to the folder.
  42141. </summary>
  42142. <remarks>
  42143. Appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  42144. </remarks>
  42145. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  42146. <param name="options">The formatting options.</param>
  42147. <param name="messages">The array of messages to append to the folder.</param>
  42148. <param name="flags">The message flags to use for each of the messages.</param>
  42149. <param name="dates">The received dates to use for each of the messages.</param>
  42150. <param name="cancellationToken">The cancellation token.</param>
  42151. <param name="progress">The progress reporting mechanism.</param>
  42152. <exception cref="T:System.ArgumentNullException">
  42153. <para><paramref name="options"/> is <c>null</c>.</para>
  42154. <para>-or-</para>
  42155. <para><paramref name="messages"/> is <c>null</c>.</para>
  42156. <para>-or-</para>
  42157. <para><paramref name="flags"/> is <c>null</c>.</para>
  42158. <para>-or-</para>
  42159. <para><paramref name="dates"/> is <c>null</c>.</para>
  42160. </exception>
  42161. <exception cref="T:System.ArgumentException">
  42162. <para>One or more of the <paramref name="messages"/> is null.</para>
  42163. <para>-or-</para>
  42164. <para>The number of messages, flags, and dates do not match.</para>
  42165. </exception>
  42166. <exception cref="T:System.ObjectDisposedException">
  42167. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42168. </exception>
  42169. <exception cref="T:MailKit.ServiceNotConnectedException">
  42170. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42171. </exception>
  42172. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42173. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42174. </exception>
  42175. <exception cref="T:MailKit.FolderNotFoundException">
  42176. The <see cref="T:MailKit.MailFolder"/> does not exist.
  42177. </exception>
  42178. <exception cref="T:System.InvalidOperationException">
  42179. Internationalized formatting was requested but has not been enabled.
  42180. </exception>
  42181. <exception cref="T:System.OperationCanceledException">
  42182. The operation was canceled via the cancellation token.
  42183. </exception>
  42184. <exception cref="T:System.NotSupportedException">
  42185. Internationalized formatting was requested but is not supported by the server.
  42186. </exception>
  42187. <exception cref="T:System.IO.IOException">
  42188. An I/O error occurred.
  42189. </exception>
  42190. <exception cref="T:MailKit.ProtocolException">
  42191. The server's response contained unexpected tokens.
  42192. </exception>
  42193. <exception cref="T:MailKit.CommandException">
  42194. The command failed.
  42195. </exception>
  42196. </member>
  42197. <member name="M:MailKit.MailFolder.AppendAsync(MimeKit.FormatOptions,System.Collections.Generic.IList{MimeKit.MimeMessage},System.Collections.Generic.IList{MailKit.MessageFlags},System.Collections.Generic.IList{System.DateTimeOffset},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  42198. <summary>
  42199. Asynchronously append the specified messages to the folder.
  42200. </summary>
  42201. <remarks>
  42202. Asynchronously appends the specified messages to the folder and returns the UniqueIds assigned to the messages.
  42203. </remarks>
  42204. <returns>The UIDs of the appended messages, if available; otherwise an empty array.</returns>
  42205. <param name="options">The formatting options.</param>
  42206. <param name="messages">The array of messages to append to the folder.</param>
  42207. <param name="flags">The message flags to use for each of the messages.</param>
  42208. <param name="dates">The received dates to use for each of the messages.</param>
  42209. <param name="cancellationToken">The cancellation token.</param>
  42210. <param name="progress">The progress reporting mechanism.</param>
  42211. <exception cref="T:System.ArgumentNullException">
  42212. <para><paramref name="options"/> is <c>null</c>.</para>
  42213. <para>-or-</para>
  42214. <para><paramref name="messages"/> is <c>null</c>.</para>
  42215. <para>-or-</para>
  42216. <para><paramref name="flags"/> is <c>null</c>.</para>
  42217. <para>-or-</para>
  42218. <para><paramref name="dates"/> is <c>null</c>.</para>
  42219. </exception>
  42220. <exception cref="T:System.ArgumentException">
  42221. <para>One or more of the <paramref name="messages"/> is null.</para>
  42222. <para>-or-</para>
  42223. <para>The number of messages, flags, and dates do not match.</para>
  42224. </exception>
  42225. <exception cref="T:System.ObjectDisposedException">
  42226. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42227. </exception>
  42228. <exception cref="T:MailKit.ServiceNotConnectedException">
  42229. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42230. </exception>
  42231. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42232. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42233. </exception>
  42234. <exception cref="T:MailKit.FolderNotFoundException">
  42235. The <see cref="T:MailKit.MailFolder"/> does not exist.
  42236. </exception>
  42237. <exception cref="T:System.InvalidOperationException">
  42238. Internationalized formatting was requested but has not been enabled.
  42239. </exception>
  42240. <exception cref="T:System.OperationCanceledException">
  42241. The operation was canceled via the cancellation token.
  42242. </exception>
  42243. <exception cref="T:System.NotSupportedException">
  42244. Internationalized formatting was requested but is not supported by the server.
  42245. </exception>
  42246. <exception cref="T:System.IO.IOException">
  42247. An I/O error occurred.
  42248. </exception>
  42249. <exception cref="T:MailKit.ProtocolException">
  42250. The server's response contained unexpected tokens.
  42251. </exception>
  42252. <exception cref="T:MailKit.CommandException">
  42253. The command failed.
  42254. </exception>
  42255. </member>
  42256. <member name="M:MailKit.MailFolder.CopyTo(MailKit.UniqueId,MailKit.IMailFolder,System.Threading.CancellationToken)">
  42257. <summary>
  42258. Copy the specified message to the destination folder.
  42259. </summary>
  42260. <remarks>
  42261. Copies the specified message to the destination folder.
  42262. </remarks>
  42263. <returns>The UID of the message in the destination folder, if available; otherwise, <c>null</c>.</returns>
  42264. <param name="uid">The UID of the message to copy.</param>
  42265. <param name="destination">The destination folder.</param>
  42266. <param name="cancellationToken">The cancellation token.</param>
  42267. <exception cref="T:System.ArgumentNullException">
  42268. <paramref name="destination"/> is <c>null</c>.
  42269. </exception>
  42270. <exception cref="T:System.ArgumentException">
  42271. <para><paramref name="uid"/> is invalid.</para>
  42272. <para>-or-</para>
  42273. <para>The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.</para>
  42274. </exception>
  42275. <exception cref="T:System.ObjectDisposedException">
  42276. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42277. </exception>
  42278. <exception cref="T:MailKit.ServiceNotConnectedException">
  42279. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42280. </exception>
  42281. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42282. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42283. </exception>
  42284. <exception cref="T:MailKit.FolderNotOpenException">
  42285. The folder is not currently open.
  42286. </exception>
  42287. <exception cref="T:System.NotSupportedException">
  42288. The mail store does not support the UIDPLUS extension.
  42289. </exception>
  42290. <exception cref="T:System.OperationCanceledException">
  42291. The operation was canceled via the cancellation token.
  42292. </exception>
  42293. <exception cref="T:System.IO.IOException">
  42294. An I/O error occurred.
  42295. </exception>
  42296. <exception cref="T:MailKit.ProtocolException">
  42297. The server's response contained unexpected tokens.
  42298. </exception>
  42299. <exception cref="T:MailKit.CommandException">
  42300. The command failed.
  42301. </exception>
  42302. </member>
  42303. <member name="M:MailKit.MailFolder.CopyToAsync(MailKit.UniqueId,MailKit.IMailFolder,System.Threading.CancellationToken)">
  42304. <summary>
  42305. Asynchronously copy the specified message to the destination folder.
  42306. </summary>
  42307. <remarks>
  42308. Asynchronously copies the specified message to the destination folder.
  42309. </remarks>
  42310. <returns>The UID of the message in the destination folder, if available; otherwise, <c>null</c>.</returns>
  42311. <param name="uid">The UID of the message to copy.</param>
  42312. <param name="destination">The destination folder.</param>
  42313. <param name="cancellationToken">The cancellation token.</param>
  42314. <exception cref="T:System.ArgumentNullException">
  42315. <paramref name="destination"/> is <c>null</c>.
  42316. </exception>
  42317. <exception cref="T:System.ArgumentException">
  42318. <para><paramref name="uid"/> is invalid.</para>
  42319. <para>-or-</para>
  42320. <para>The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.</para>
  42321. </exception>
  42322. <exception cref="T:System.ObjectDisposedException">
  42323. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42324. </exception>
  42325. <exception cref="T:MailKit.ServiceNotConnectedException">
  42326. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42327. </exception>
  42328. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42329. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42330. </exception>
  42331. <exception cref="T:MailKit.FolderNotOpenException">
  42332. The folder is not currently open.
  42333. </exception>
  42334. <exception cref="T:System.NotSupportedException">
  42335. The mail store does not support the UIDPLUS extension.
  42336. </exception>
  42337. <exception cref="T:System.OperationCanceledException">
  42338. The operation was canceled via the cancellation token.
  42339. </exception>
  42340. <exception cref="T:System.IO.IOException">
  42341. An I/O error occurred.
  42342. </exception>
  42343. <exception cref="T:MailKit.ProtocolException">
  42344. The server's response contained unexpected tokens.
  42345. </exception>
  42346. <exception cref="T:MailKit.CommandException">
  42347. The command failed.
  42348. </exception>
  42349. </member>
  42350. <member name="M:MailKit.MailFolder.CopyTo(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.IMailFolder,System.Threading.CancellationToken)">
  42351. <summary>
  42352. Copy the specified messages to the destination folder.
  42353. </summary>
  42354. <remarks>
  42355. Copies the specified messages to the destination folder.
  42356. </remarks>
  42357. <returns>The UID mapping of the messages in the destination folder, if available; otherwise an empty mapping.</returns>
  42358. <param name="uids">The UIDs of the messages to copy.</param>
  42359. <param name="destination">The destination folder.</param>
  42360. <param name="cancellationToken">The cancellation token.</param>
  42361. <exception cref="T:System.ArgumentNullException">
  42362. <para><paramref name="uids"/> is <c>null</c>.</para>
  42363. <para>-or-</para>
  42364. <para><paramref name="destination"/> is <c>null</c>.</para>
  42365. </exception>
  42366. <exception cref="T:System.ArgumentException">
  42367. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  42368. <para>-or-</para>
  42369. <para>The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.</para>
  42370. </exception>
  42371. <exception cref="T:System.ObjectDisposedException">
  42372. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42373. </exception>
  42374. <exception cref="T:MailKit.ServiceNotConnectedException">
  42375. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42376. </exception>
  42377. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42378. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42379. </exception>
  42380. <exception cref="T:MailKit.FolderNotOpenException">
  42381. The folder is not currently open.
  42382. </exception>
  42383. <exception cref="T:System.NotSupportedException">
  42384. The mail store does not support the UIDPLUS extension.
  42385. </exception>
  42386. <exception cref="T:System.OperationCanceledException">
  42387. The operation was canceled via the cancellation token.
  42388. </exception>
  42389. <exception cref="T:System.IO.IOException">
  42390. An I/O error occurred.
  42391. </exception>
  42392. <exception cref="T:MailKit.ProtocolException">
  42393. The server's response contained unexpected tokens.
  42394. </exception>
  42395. <exception cref="T:MailKit.CommandException">
  42396. The command failed.
  42397. </exception>
  42398. </member>
  42399. <member name="M:MailKit.MailFolder.CopyToAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.IMailFolder,System.Threading.CancellationToken)">
  42400. <summary>
  42401. Asynchronously copy the specified messages to the destination folder.
  42402. </summary>
  42403. <remarks>
  42404. Asynchronously copies the specified messages to the destination folder.
  42405. </remarks>
  42406. <returns>The UID mapping of the messages in the destination folder, if available; otherwise an empty mapping.</returns>
  42407. <param name="uids">The UIDs of the messages to copy.</param>
  42408. <param name="destination">The destination folder.</param>
  42409. <param name="cancellationToken">The cancellation token.</param>
  42410. <exception cref="T:System.ArgumentNullException">
  42411. <para><paramref name="uids"/> is <c>null</c>.</para>
  42412. <para>-or-</para>
  42413. <para><paramref name="destination"/> is <c>null</c>.</para>
  42414. </exception>
  42415. <exception cref="T:System.ArgumentException">
  42416. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  42417. <para>-or-</para>
  42418. <para>The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.</para>
  42419. </exception>
  42420. <exception cref="T:System.ObjectDisposedException">
  42421. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42422. </exception>
  42423. <exception cref="T:MailKit.ServiceNotConnectedException">
  42424. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42425. </exception>
  42426. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42427. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42428. </exception>
  42429. <exception cref="T:MailKit.FolderNotOpenException">
  42430. The folder is not currently open.
  42431. </exception>
  42432. <exception cref="T:System.NotSupportedException">
  42433. The mail store does not support the UIDPLUS extension.
  42434. </exception>
  42435. <exception cref="T:System.OperationCanceledException">
  42436. The operation was canceled via the cancellation token.
  42437. </exception>
  42438. <exception cref="T:System.IO.IOException">
  42439. An I/O error occurred.
  42440. </exception>
  42441. <exception cref="T:MailKit.ProtocolException">
  42442. The server's response contained unexpected tokens.
  42443. </exception>
  42444. <exception cref="T:MailKit.CommandException">
  42445. The command failed.
  42446. </exception>
  42447. </member>
  42448. <member name="M:MailKit.MailFolder.MoveTo(MailKit.UniqueId,MailKit.IMailFolder,System.Threading.CancellationToken)">
  42449. <summary>
  42450. Move the specified message to the destination folder.
  42451. </summary>
  42452. <remarks>
  42453. Moves the specified message to the destination folder.
  42454. </remarks>
  42455. <returns>The UID of the message in the destination folder, if available; otherwise, <c>null</c>.</returns>
  42456. <param name="uid">The UID of the message to move.</param>
  42457. <param name="destination">The destination folder.</param>
  42458. <param name="cancellationToken">The cancellation token.</param>
  42459. <exception cref="T:System.ArgumentNullException">
  42460. <paramref name="destination"/> is <c>null</c>.
  42461. </exception>
  42462. <exception cref="T:System.ArgumentException">
  42463. <para><paramref name="uid"/> is invalid.</para>
  42464. <para>-or-</para>
  42465. <para>The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.</para>
  42466. </exception>
  42467. <exception cref="T:System.ObjectDisposedException">
  42468. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42469. </exception>
  42470. <exception cref="T:MailKit.ServiceNotConnectedException">
  42471. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42472. </exception>
  42473. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42474. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42475. </exception>
  42476. <exception cref="T:MailKit.FolderNotOpenException">
  42477. The folder is not currently open in read-write mode.
  42478. </exception>
  42479. <exception cref="T:System.NotSupportedException">
  42480. The mail store does not support the UIDPLUS extension.
  42481. </exception>
  42482. <exception cref="T:System.OperationCanceledException">
  42483. The operation was canceled via the cancellation token.
  42484. </exception>
  42485. <exception cref="T:System.IO.IOException">
  42486. An I/O error occurred.
  42487. </exception>
  42488. <exception cref="T:MailKit.ProtocolException">
  42489. The server's response contained unexpected tokens.
  42490. </exception>
  42491. <exception cref="T:MailKit.CommandException">
  42492. The command failed.
  42493. </exception>
  42494. </member>
  42495. <member name="M:MailKit.MailFolder.MoveToAsync(MailKit.UniqueId,MailKit.IMailFolder,System.Threading.CancellationToken)">
  42496. <summary>
  42497. Asynchronously move the specified message to the destination folder.
  42498. </summary>
  42499. <remarks>
  42500. Asynchronously moves the specified message to the destination folder.
  42501. </remarks>
  42502. <returns>The UID of the message in the destination folder, if available; otherwise, <c>null</c>.</returns>
  42503. <param name="uid">The UID of the message to move.</param>
  42504. <param name="destination">The destination folder.</param>
  42505. <param name="cancellationToken">The cancellation token.</param>
  42506. <exception cref="T:System.ArgumentNullException">
  42507. <paramref name="destination"/> is <c>null</c>.
  42508. </exception>
  42509. <exception cref="T:System.ArgumentException">
  42510. <para><paramref name="uid"/> is invalid.</para>
  42511. <para>-or-</para>
  42512. <para>The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.</para>
  42513. </exception>
  42514. <exception cref="T:System.ObjectDisposedException">
  42515. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42516. </exception>
  42517. <exception cref="T:MailKit.ServiceNotConnectedException">
  42518. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42519. </exception>
  42520. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42521. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42522. </exception>
  42523. <exception cref="T:MailKit.FolderNotOpenException">
  42524. The folder is not currently open in read-write mode.
  42525. </exception>
  42526. <exception cref="T:System.NotSupportedException">
  42527. The mail store does not support the UIDPLUS extension.
  42528. </exception>
  42529. <exception cref="T:System.OperationCanceledException">
  42530. The operation was canceled via the cancellation token.
  42531. </exception>
  42532. <exception cref="T:System.IO.IOException">
  42533. An I/O error occurred.
  42534. </exception>
  42535. <exception cref="T:MailKit.ProtocolException">
  42536. The server's response contained unexpected tokens.
  42537. </exception>
  42538. <exception cref="T:MailKit.CommandException">
  42539. The command failed.
  42540. </exception>
  42541. </member>
  42542. <member name="M:MailKit.MailFolder.MoveTo(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.IMailFolder,System.Threading.CancellationToken)">
  42543. <summary>
  42544. Move the specified messages to the destination folder.
  42545. </summary>
  42546. <remarks>
  42547. Moves the specified messages to the destination folder.
  42548. </remarks>
  42549. <returns>The UID mapping of the messages in the destination folder, if available; otherwise an empty mapping.</returns>
  42550. <param name="uids">The UIDs of the messages to move.</param>
  42551. <param name="destination">The destination folder.</param>
  42552. <param name="cancellationToken">The cancellation token.</param>
  42553. <exception cref="T:System.ArgumentNullException">
  42554. <para><paramref name="uids"/> is <c>null</c>.</para>
  42555. <para>-or-</para>
  42556. <para><paramref name="destination"/> is <c>null</c>.</para>
  42557. </exception>
  42558. <exception cref="T:System.ArgumentException">
  42559. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  42560. <para>-or-</para>
  42561. <para>The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.</para>
  42562. </exception>
  42563. <exception cref="T:System.ObjectDisposedException">
  42564. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42565. </exception>
  42566. <exception cref="T:MailKit.ServiceNotConnectedException">
  42567. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42568. </exception>
  42569. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42570. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42571. </exception>
  42572. <exception cref="T:MailKit.FolderNotOpenException">
  42573. The folder is not currently open in read-write mode.
  42574. </exception>
  42575. <exception cref="T:System.NotSupportedException">
  42576. The mail store does not support the UIDPLUS extension.
  42577. </exception>
  42578. <exception cref="T:System.OperationCanceledException">
  42579. The operation was canceled via the cancellation token.
  42580. </exception>
  42581. <exception cref="T:System.IO.IOException">
  42582. An I/O error occurred.
  42583. </exception>
  42584. <exception cref="T:MailKit.ProtocolException">
  42585. The server's response contained unexpected tokens.
  42586. </exception>
  42587. <exception cref="T:MailKit.CommandException">
  42588. The command failed.
  42589. </exception>
  42590. </member>
  42591. <member name="M:MailKit.MailFolder.MoveToAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.IMailFolder,System.Threading.CancellationToken)">
  42592. <summary>
  42593. Asynchronously move the specified messages to the destination folder.
  42594. </summary>
  42595. <remarks>
  42596. Asynchronously moves the specified messages to the destination folder.
  42597. </remarks>
  42598. <returns>The UID mapping of the messages in the destination folder, if available; otherwise an empty mapping.</returns>
  42599. <param name="uids">The UIDs of the messages to move.</param>
  42600. <param name="destination">The destination folder.</param>
  42601. <param name="cancellationToken">The cancellation token.</param>
  42602. <exception cref="T:System.ArgumentNullException">
  42603. <para><paramref name="uids"/> is <c>null</c>.</para>
  42604. <para>-or-</para>
  42605. <para><paramref name="destination"/> is <c>null</c>.</para>
  42606. </exception>
  42607. <exception cref="T:System.ArgumentException">
  42608. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  42609. <para>-or-</para>
  42610. <para>The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.</para>
  42611. </exception>
  42612. <exception cref="T:System.ObjectDisposedException">
  42613. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42614. </exception>
  42615. <exception cref="T:MailKit.ServiceNotConnectedException">
  42616. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42617. </exception>
  42618. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42619. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42620. </exception>
  42621. <exception cref="T:MailKit.FolderNotOpenException">
  42622. The folder is not currently open in read-write mode.
  42623. </exception>
  42624. <exception cref="T:System.NotSupportedException">
  42625. The mail store does not support the UIDPLUS extension.
  42626. </exception>
  42627. <exception cref="T:System.OperationCanceledException">
  42628. The operation was canceled via the cancellation token.
  42629. </exception>
  42630. <exception cref="T:System.IO.IOException">
  42631. An I/O error occurred.
  42632. </exception>
  42633. <exception cref="T:MailKit.ProtocolException">
  42634. The server's response contained unexpected tokens.
  42635. </exception>
  42636. <exception cref="T:MailKit.CommandException">
  42637. The command failed.
  42638. </exception>
  42639. </member>
  42640. <member name="M:MailKit.MailFolder.CopyTo(System.Int32,MailKit.IMailFolder,System.Threading.CancellationToken)">
  42641. <summary>
  42642. Copy the specified message to the destination folder.
  42643. </summary>
  42644. <remarks>
  42645. Copies the specified message to the destination folder.
  42646. </remarks>
  42647. <param name="index">The index of the message to copy.</param>
  42648. <param name="destination">The destination folder.</param>
  42649. <param name="cancellationToken">The cancellation token.</param>
  42650. <exception cref="T:System.ArgumentNullException">
  42651. <paramref name="destination"/> is <c>null</c>.
  42652. </exception>
  42653. <exception cref="T:System.ArgumentOutOfRangeException">
  42654. <paramref name="index"/> does not refer to a valid message index.
  42655. </exception>
  42656. <exception cref="T:System.ArgumentException">
  42657. The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.
  42658. </exception>
  42659. <exception cref="T:System.ObjectDisposedException">
  42660. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42661. </exception>
  42662. <exception cref="T:MailKit.ServiceNotConnectedException">
  42663. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42664. </exception>
  42665. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42666. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42667. </exception>
  42668. <exception cref="T:MailKit.FolderNotOpenException">
  42669. The folder is not currently open.
  42670. </exception>
  42671. <exception cref="T:System.OperationCanceledException">
  42672. The operation was canceled via the cancellation token.
  42673. </exception>
  42674. <exception cref="T:System.IO.IOException">
  42675. An I/O error occurred.
  42676. </exception>
  42677. <exception cref="T:MailKit.ProtocolException">
  42678. The server's response contained unexpected tokens.
  42679. </exception>
  42680. <exception cref="T:MailKit.CommandException">
  42681. The command failed.
  42682. </exception>
  42683. </member>
  42684. <member name="M:MailKit.MailFolder.CopyToAsync(System.Int32,MailKit.IMailFolder,System.Threading.CancellationToken)">
  42685. <summary>
  42686. Asynchronously copy the specified message to the destination folder.
  42687. </summary>
  42688. <remarks>
  42689. Asynchronously copies the specified message to the destination folder.
  42690. </remarks>
  42691. <returns>An asynchronous task context.</returns>
  42692. <param name="index">The indexes of the message to copy.</param>
  42693. <param name="destination">The destination folder.</param>
  42694. <param name="cancellationToken">The cancellation token.</param>
  42695. <exception cref="T:System.ArgumentNullException">
  42696. <paramref name="destination"/> is <c>null</c>.
  42697. </exception>
  42698. <exception cref="T:System.ArgumentOutOfRangeException">
  42699. <paramref name="index"/> does not refer to a valid message index.
  42700. </exception>
  42701. <exception cref="T:System.ArgumentException">
  42702. The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.
  42703. </exception>
  42704. <exception cref="T:System.ObjectDisposedException">
  42705. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42706. </exception>
  42707. <exception cref="T:MailKit.ServiceNotConnectedException">
  42708. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42709. </exception>
  42710. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42711. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42712. </exception>
  42713. <exception cref="T:MailKit.FolderNotOpenException">
  42714. The folder is not currently open.
  42715. </exception>
  42716. <exception cref="T:System.OperationCanceledException">
  42717. The operation was canceled via the cancellation token.
  42718. </exception>
  42719. <exception cref="T:System.IO.IOException">
  42720. An I/O error occurred.
  42721. </exception>
  42722. <exception cref="T:MailKit.ProtocolException">
  42723. The server's response contained unexpected tokens.
  42724. </exception>
  42725. <exception cref="T:MailKit.CommandException">
  42726. The command failed.
  42727. </exception>
  42728. </member>
  42729. <member name="M:MailKit.MailFolder.CopyTo(System.Collections.Generic.IList{System.Int32},MailKit.IMailFolder,System.Threading.CancellationToken)">
  42730. <summary>
  42731. Copy the specified messages to the destination folder.
  42732. </summary>
  42733. <remarks>
  42734. Copies the specified messages to the destination folder.
  42735. </remarks>
  42736. <param name="indexes">The indexes of the messages to copy.</param>
  42737. <param name="destination">The destination folder.</param>
  42738. <param name="cancellationToken">The cancellation token.</param>
  42739. <exception cref="T:System.ArgumentNullException">
  42740. <para><paramref name="indexes"/> is <c>null</c>.</para>
  42741. <para>-or-</para>
  42742. <para><paramref name="destination"/> is <c>null</c>.</para>
  42743. </exception>
  42744. <exception cref="T:System.ArgumentException">
  42745. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  42746. <para>-or-</para>
  42747. <para>The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.</para>
  42748. </exception>
  42749. <exception cref="T:System.ObjectDisposedException">
  42750. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42751. </exception>
  42752. <exception cref="T:MailKit.ServiceNotConnectedException">
  42753. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42754. </exception>
  42755. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42756. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42757. </exception>
  42758. <exception cref="T:MailKit.FolderNotOpenException">
  42759. The folder is not currently open.
  42760. </exception>
  42761. <exception cref="T:System.OperationCanceledException">
  42762. The operation was canceled via the cancellation token.
  42763. </exception>
  42764. <exception cref="T:System.IO.IOException">
  42765. An I/O error occurred.
  42766. </exception>
  42767. <exception cref="T:MailKit.ProtocolException">
  42768. The server's response contained unexpected tokens.
  42769. </exception>
  42770. <exception cref="T:MailKit.CommandException">
  42771. The command failed.
  42772. </exception>
  42773. </member>
  42774. <member name="M:MailKit.MailFolder.CopyToAsync(System.Collections.Generic.IList{System.Int32},MailKit.IMailFolder,System.Threading.CancellationToken)">
  42775. <summary>
  42776. Asynchronously copy the specified messages to the destination folder.
  42777. </summary>
  42778. <remarks>
  42779. Asynchronously copies the specified messages to the destination folder.
  42780. </remarks>
  42781. <returns>An asynchronous task context.</returns>
  42782. <param name="indexes">The indexes of the messages to copy.</param>
  42783. <param name="destination">The destination folder.</param>
  42784. <param name="cancellationToken">The cancellation token.</param>
  42785. <exception cref="T:System.ArgumentNullException">
  42786. <para><paramref name="indexes"/> is <c>null</c>.</para>
  42787. <para>-or-</para>
  42788. <para><paramref name="destination"/> is <c>null</c>.</para>
  42789. </exception>
  42790. <exception cref="T:System.ArgumentException">
  42791. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  42792. <para>-or-</para>
  42793. <para>The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.</para>
  42794. </exception>
  42795. <exception cref="T:System.ObjectDisposedException">
  42796. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42797. </exception>
  42798. <exception cref="T:MailKit.ServiceNotConnectedException">
  42799. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42800. </exception>
  42801. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42802. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42803. </exception>
  42804. <exception cref="T:MailKit.FolderNotOpenException">
  42805. The folder is not currently open.
  42806. </exception>
  42807. <exception cref="T:System.OperationCanceledException">
  42808. The operation was canceled via the cancellation token.
  42809. </exception>
  42810. <exception cref="T:System.IO.IOException">
  42811. An I/O error occurred.
  42812. </exception>
  42813. <exception cref="T:MailKit.ProtocolException">
  42814. The server's response contained unexpected tokens.
  42815. </exception>
  42816. <exception cref="T:MailKit.CommandException">
  42817. The command failed.
  42818. </exception>
  42819. </member>
  42820. <member name="M:MailKit.MailFolder.MoveTo(System.Int32,MailKit.IMailFolder,System.Threading.CancellationToken)">
  42821. <summary>
  42822. Move the specified message to the destination folder.
  42823. </summary>
  42824. <remarks>
  42825. Moves the specified message to the destination folder.
  42826. </remarks>
  42827. <param name="index">The index of the message to move.</param>
  42828. <param name="destination">The destination folder.</param>
  42829. <param name="cancellationToken">The cancellation token.</param>
  42830. <exception cref="T:System.ArgumentNullException">
  42831. <paramref name="destination"/> is <c>null</c>.
  42832. </exception>
  42833. <exception cref="T:System.ArgumentOutOfRangeException">
  42834. <paramref name="index"/> does not refer to a valid message index.
  42835. </exception>
  42836. <exception cref="T:System.ArgumentException">
  42837. The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.
  42838. </exception>
  42839. <exception cref="T:System.ObjectDisposedException">
  42840. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42841. </exception>
  42842. <exception cref="T:MailKit.ServiceNotConnectedException">
  42843. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42844. </exception>
  42845. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42846. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42847. </exception>
  42848. <exception cref="T:MailKit.FolderNotOpenException">
  42849. The folder is not currently open in read-write mode.
  42850. </exception>
  42851. <exception cref="T:System.OperationCanceledException">
  42852. The operation was canceled via the cancellation token.
  42853. </exception>
  42854. <exception cref="T:System.IO.IOException">
  42855. An I/O error occurred.
  42856. </exception>
  42857. <exception cref="T:MailKit.ProtocolException">
  42858. The server's response contained unexpected tokens.
  42859. </exception>
  42860. <exception cref="T:MailKit.CommandException">
  42861. The command failed.
  42862. </exception>
  42863. </member>
  42864. <member name="M:MailKit.MailFolder.MoveToAsync(System.Int32,MailKit.IMailFolder,System.Threading.CancellationToken)">
  42865. <summary>
  42866. Asynchronously move the specified message to the destination folder.
  42867. </summary>
  42868. <remarks>
  42869. Asynchronously moves the specified message to the destination folder.
  42870. </remarks>
  42871. <returns>An asynchronous task context.</returns>
  42872. <param name="index">The index of the message to move.</param>
  42873. <param name="destination">The destination folder.</param>
  42874. <param name="cancellationToken">The cancellation token.</param>
  42875. <exception cref="T:System.ArgumentNullException">
  42876. <paramref name="destination"/> is <c>null</c>.
  42877. </exception>
  42878. <exception cref="T:System.ArgumentOutOfRangeException">
  42879. <paramref name="index"/> does not refer to a valid message index.
  42880. </exception>
  42881. <exception cref="T:System.ArgumentException">
  42882. The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.
  42883. </exception>
  42884. <exception cref="T:System.ObjectDisposedException">
  42885. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42886. </exception>
  42887. <exception cref="T:MailKit.ServiceNotConnectedException">
  42888. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42889. </exception>
  42890. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42891. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42892. </exception>
  42893. <exception cref="T:MailKit.FolderNotOpenException">
  42894. The folder is not currently open in read-write mode.
  42895. </exception>
  42896. <exception cref="T:System.OperationCanceledException">
  42897. The operation was canceled via the cancellation token.
  42898. </exception>
  42899. <exception cref="T:System.IO.IOException">
  42900. An I/O error occurred.
  42901. </exception>
  42902. <exception cref="T:MailKit.ProtocolException">
  42903. The server's response contained unexpected tokens.
  42904. </exception>
  42905. <exception cref="T:MailKit.CommandException">
  42906. The command failed.
  42907. </exception>
  42908. </member>
  42909. <member name="M:MailKit.MailFolder.MoveTo(System.Collections.Generic.IList{System.Int32},MailKit.IMailFolder,System.Threading.CancellationToken)">
  42910. <summary>
  42911. Move the specified messages to the destination folder.
  42912. </summary>
  42913. <remarks>
  42914. Moves the specified messages to the destination folder.
  42915. </remarks>
  42916. <param name="indexes">The indexes of the messages to move.</param>
  42917. <param name="destination">The destination folder.</param>
  42918. <param name="cancellationToken">The cancellation token.</param>
  42919. <exception cref="T:System.ArgumentNullException">
  42920. <para><paramref name="indexes"/> is <c>null</c>.</para>
  42921. <para>-or-</para>
  42922. <para><paramref name="destination"/> is <c>null</c>.</para>
  42923. </exception>
  42924. <exception cref="T:System.ArgumentException">
  42925. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  42926. <para>-or-</para>
  42927. <para>The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.</para>
  42928. </exception>
  42929. <exception cref="T:System.ObjectDisposedException">
  42930. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42931. </exception>
  42932. <exception cref="T:MailKit.ServiceNotConnectedException">
  42933. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42934. </exception>
  42935. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42936. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42937. </exception>
  42938. <exception cref="T:MailKit.FolderNotOpenException">
  42939. The folder is not currently open in read-write mode.
  42940. </exception>
  42941. <exception cref="T:System.OperationCanceledException">
  42942. The operation was canceled via the cancellation token.
  42943. </exception>
  42944. <exception cref="T:System.IO.IOException">
  42945. An I/O error occurred.
  42946. </exception>
  42947. <exception cref="T:MailKit.ProtocolException">
  42948. The server's response contained unexpected tokens.
  42949. </exception>
  42950. <exception cref="T:MailKit.CommandException">
  42951. The command failed.
  42952. </exception>
  42953. </member>
  42954. <member name="M:MailKit.MailFolder.MoveToAsync(System.Collections.Generic.IList{System.Int32},MailKit.IMailFolder,System.Threading.CancellationToken)">
  42955. <summary>
  42956. Asynchronously move the specified messages to the destination folder.
  42957. </summary>
  42958. <remarks>
  42959. Asynchronously moves the specified messages to the destination folder.
  42960. </remarks>
  42961. <returns>An asynchronous task context.</returns>
  42962. <param name="indexes">The indexes of the messages to move.</param>
  42963. <param name="destination">The destination folder.</param>
  42964. <param name="cancellationToken">The cancellation token.</param>
  42965. <exception cref="T:System.ArgumentNullException">
  42966. <para><paramref name="indexes"/> is <c>null</c>.</para>
  42967. <para>-or-</para>
  42968. <para><paramref name="destination"/> is <c>null</c>.</para>
  42969. </exception>
  42970. <exception cref="T:System.ArgumentException">
  42971. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  42972. <para>-or-</para>
  42973. <para>The destination folder does not belong to the <see cref="T:MailKit.IMailStore"/>.</para>
  42974. </exception>
  42975. <exception cref="T:System.ObjectDisposedException">
  42976. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  42977. </exception>
  42978. <exception cref="T:MailKit.ServiceNotConnectedException">
  42979. The <see cref="T:MailKit.IMailStore"/> is not connected.
  42980. </exception>
  42981. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  42982. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  42983. </exception>
  42984. <exception cref="T:MailKit.FolderNotOpenException">
  42985. The folder is not currently open in read-write mode.
  42986. </exception>
  42987. <exception cref="T:System.OperationCanceledException">
  42988. The operation was canceled via the cancellation token.
  42989. </exception>
  42990. <exception cref="T:System.IO.IOException">
  42991. An I/O error occurred.
  42992. </exception>
  42993. <exception cref="T:MailKit.ProtocolException">
  42994. The server's response contained unexpected tokens.
  42995. </exception>
  42996. <exception cref="T:MailKit.CommandException">
  42997. The command failed.
  42998. </exception>
  42999. </member>
  43000. <member name="M:MailKit.MailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  43001. <summary>
  43002. Fetch the message summaries for the specified message UIDs.
  43003. </summary>
  43004. <remarks>
  43005. <para>Fetches the message summaries for the specified message UIDs.</para>
  43006. <para>It should be noted that if another client has modified any message
  43007. in the folder, the mail service may choose to return information that was
  43008. not explicitly requested. It is therefore important to be prepared to
  43009. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43010. messages that were requested as well as summaries for messages that were
  43011. not requested at all.</para>
  43012. </remarks>
  43013. <example>
  43014. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  43015. </example>
  43016. <returns>An enumeration of summaries for the requested messages.</returns>
  43017. <param name="uids">The UIDs.</param>
  43018. <param name="items">The message summary items to fetch.</param>
  43019. <param name="cancellationToken">The cancellation token.</param>
  43020. <exception cref="T:System.ArgumentNullException">
  43021. <paramref name="uids"/> is <c>null</c>.
  43022. </exception>
  43023. <exception cref="T:System.ArgumentOutOfRangeException">
  43024. <paramref name="items"/> is empty.
  43025. </exception>
  43026. <exception cref="T:System.ArgumentException">
  43027. One or more of the <paramref name="uids"/> is invalid.
  43028. </exception>
  43029. <exception cref="T:System.ObjectDisposedException">
  43030. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43031. </exception>
  43032. <exception cref="T:MailKit.ServiceNotConnectedException">
  43033. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43034. </exception>
  43035. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43036. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43037. </exception>
  43038. <exception cref="T:MailKit.FolderNotOpenException">
  43039. The folder is not currently open.
  43040. </exception>
  43041. <exception cref="T:System.OperationCanceledException">
  43042. The operation was canceled via the cancellation token.
  43043. </exception>
  43044. <exception cref="T:System.IO.IOException">
  43045. An I/O error occurred.
  43046. </exception>
  43047. <exception cref="T:MailKit.ProtocolException">
  43048. The server's response contained unexpected tokens.
  43049. </exception>
  43050. <exception cref="T:MailKit.CommandException">
  43051. The command failed.
  43052. </exception>
  43053. </member>
  43054. <member name="M:MailKit.MailFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  43055. <summary>
  43056. Asynchronously fetch the message summaries for the specified message UIDs.
  43057. </summary>
  43058. <remarks>
  43059. <para>Asynchronously fetches the message summaries for the specified message
  43060. UIDs.</para>
  43061. <para>It should be noted that if another client has modified any message
  43062. in the folder, the mail service may choose to return information that was
  43063. not explicitly requested. It is therefore important to be prepared to
  43064. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43065. messages that were requested as well as summaries for messages that were
  43066. not requested at all.</para>
  43067. </remarks>
  43068. <returns>An enumeration of summaries for the requested messages.</returns>
  43069. <param name="uids">The UIDs.</param>
  43070. <param name="items">The message summary items to fetch.</param>
  43071. <param name="cancellationToken">The cancellation token.</param>
  43072. <exception cref="T:System.ArgumentNullException">
  43073. <paramref name="uids"/> is <c>null</c>.
  43074. </exception>
  43075. <exception cref="T:System.ArgumentOutOfRangeException">
  43076. <paramref name="items"/> is empty.
  43077. </exception>
  43078. <exception cref="T:System.ArgumentException">
  43079. One or more of the <paramref name="uids"/> is invalid.
  43080. </exception>
  43081. <exception cref="T:System.ObjectDisposedException">
  43082. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43083. </exception>
  43084. <exception cref="T:MailKit.ServiceNotConnectedException">
  43085. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43086. </exception>
  43087. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43088. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43089. </exception>
  43090. <exception cref="T:MailKit.FolderNotOpenException">
  43091. The folder is not currently open.
  43092. </exception>
  43093. <exception cref="T:System.OperationCanceledException">
  43094. The operation was canceled via the cancellation token.
  43095. </exception>
  43096. <exception cref="T:System.IO.IOException">
  43097. An I/O error occurred.
  43098. </exception>
  43099. <exception cref="T:MailKit.ProtocolException">
  43100. The server's response contained unexpected tokens.
  43101. </exception>
  43102. <exception cref="T:MailKit.CommandException">
  43103. The command failed.
  43104. </exception>
  43105. </member>
  43106. <member name="M:MailKit.MailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  43107. <summary>
  43108. Fetch the message summaries for the specified message UIDs.
  43109. </summary>
  43110. <remarks>
  43111. <para>Fetches the message summaries for the specified message UIDs.</para>
  43112. <para>It should be noted that if another client has modified any message
  43113. in the folder, the mail service may choose to return information that was
  43114. not explicitly requested. It is therefore important to be prepared to
  43115. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43116. messages that were requested as well as summaries for messages that were
  43117. not requested at all.</para>
  43118. </remarks>
  43119. <returns>An enumeration of summaries for the requested messages.</returns>
  43120. <param name="uids">The UIDs.</param>
  43121. <param name="items">The message summary items to fetch.</param>
  43122. <param name="headers">The desired header fields.</param>
  43123. <param name="cancellationToken">The cancellation token.</param>
  43124. <exception cref="T:System.ArgumentNullException">
  43125. <para><paramref name="uids"/> is <c>null</c>.</para>
  43126. <para>-or-</para>
  43127. <para><paramref name="headers"/> is <c>null</c>.</para>
  43128. </exception>
  43129. <exception cref="T:System.ArgumentException">
  43130. One or more of the <paramref name="uids"/> is invalid.
  43131. </exception>
  43132. <exception cref="T:System.ObjectDisposedException">
  43133. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43134. </exception>
  43135. <exception cref="T:MailKit.ServiceNotConnectedException">
  43136. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43137. </exception>
  43138. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43139. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43140. </exception>
  43141. <exception cref="T:MailKit.FolderNotOpenException">
  43142. The folder is not currently open.
  43143. </exception>
  43144. <exception cref="T:System.OperationCanceledException">
  43145. The operation was canceled via the cancellation token.
  43146. </exception>
  43147. <exception cref="T:System.IO.IOException">
  43148. An I/O error occurred.
  43149. </exception>
  43150. <exception cref="T:MailKit.ProtocolException">
  43151. The server's response contained unexpected tokens.
  43152. </exception>
  43153. <exception cref="T:MailKit.CommandException">
  43154. The command failed.
  43155. </exception>
  43156. </member>
  43157. <member name="M:MailKit.MailFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  43158. <summary>
  43159. Asynchronously fetch the message summaries for the specified message UIDs.
  43160. </summary>
  43161. <remarks>
  43162. <para>Asynchronously fetches the message summaries for the specified message
  43163. UIDs.</para>
  43164. <para>It should be noted that if another client has modified any message
  43165. in the folder, the mail service may choose to return information that was
  43166. not explicitly requested. It is therefore important to be prepared to
  43167. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43168. messages that were requested as well as summaries for messages that were
  43169. not requested at all.</para>
  43170. </remarks>
  43171. <returns>An enumeration of summaries for the requested messages.</returns>
  43172. <param name="uids">The UIDs.</param>
  43173. <param name="items">The message summary items to fetch.</param>
  43174. <param name="headers">The desired header fields.</param>
  43175. <param name="cancellationToken">The cancellation token.</param>
  43176. <exception cref="T:System.ArgumentNullException">
  43177. <para><paramref name="uids"/> is <c>null</c>.</para>
  43178. <para>-or-</para>
  43179. <para><paramref name="headers"/> is <c>null</c>.</para>
  43180. </exception>
  43181. <exception cref="T:System.ArgumentException">
  43182. One or more of the <paramref name="uids"/> is invalid.
  43183. </exception>
  43184. <exception cref="T:System.ObjectDisposedException">
  43185. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43186. </exception>
  43187. <exception cref="T:MailKit.ServiceNotConnectedException">
  43188. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43189. </exception>
  43190. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43191. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43192. </exception>
  43193. <exception cref="T:MailKit.FolderNotOpenException">
  43194. The folder is not currently open.
  43195. </exception>
  43196. <exception cref="T:System.OperationCanceledException">
  43197. The operation was canceled via the cancellation token.
  43198. </exception>
  43199. <exception cref="T:System.IO.IOException">
  43200. An I/O error occurred.
  43201. </exception>
  43202. <exception cref="T:MailKit.ProtocolException">
  43203. The server's response contained unexpected tokens.
  43204. </exception>
  43205. <exception cref="T:MailKit.CommandException">
  43206. The command failed.
  43207. </exception>
  43208. </member>
  43209. <member name="M:MailKit.MailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  43210. <summary>
  43211. Fetch the message summaries for the specified message UIDs.
  43212. </summary>
  43213. <remarks>
  43214. <para>Fetches the message summaries for the specified message UIDs.</para>
  43215. <para>It should be noted that if another client has modified any message
  43216. in the folder, the mail service may choose to return information that was
  43217. not explicitly requested. It is therefore important to be prepared to
  43218. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43219. messages that were requested as well as summaries for messages that were
  43220. not requested at all.</para>
  43221. </remarks>
  43222. <returns>An enumeration of summaries for the requested messages.</returns>
  43223. <param name="uids">The UIDs.</param>
  43224. <param name="items">The message summary items to fetch.</param>
  43225. <param name="headers">The desired header fields.</param>
  43226. <param name="cancellationToken">The cancellation token.</param>
  43227. <exception cref="T:System.ArgumentNullException">
  43228. <para><paramref name="uids"/> is <c>null</c>.</para>
  43229. <para>-or-</para>
  43230. <para><paramref name="headers"/> is <c>null</c>.</para>
  43231. </exception>
  43232. <exception cref="T:System.ArgumentException">
  43233. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  43234. <para>-or-</para>
  43235. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  43236. </exception>
  43237. <exception cref="T:System.ObjectDisposedException">
  43238. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43239. </exception>
  43240. <exception cref="T:MailKit.ServiceNotConnectedException">
  43241. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43242. </exception>
  43243. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43244. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43245. </exception>
  43246. <exception cref="T:MailKit.FolderNotOpenException">
  43247. The folder is not currently open.
  43248. </exception>
  43249. <exception cref="T:System.OperationCanceledException">
  43250. The operation was canceled via the cancellation token.
  43251. </exception>
  43252. <exception cref="T:System.IO.IOException">
  43253. An I/O error occurred.
  43254. </exception>
  43255. <exception cref="T:MailKit.ProtocolException">
  43256. The server's response contained unexpected tokens.
  43257. </exception>
  43258. <exception cref="T:MailKit.CommandException">
  43259. The command failed.
  43260. </exception>
  43261. </member>
  43262. <member name="M:MailKit.MailFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  43263. <summary>
  43264. Asynchronously fetch the message summaries for the specified message UIDs.
  43265. </summary>
  43266. <remarks>
  43267. <para>Asynchronously fetches the message summaries for the specified message
  43268. UIDs.</para>
  43269. <para>It should be noted that if another client has modified any message
  43270. in the folder, the mail service may choose to return information that was
  43271. not explicitly requested. It is therefore important to be prepared to
  43272. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43273. messages that were requested as well as summaries for messages that were
  43274. not requested at all.</para>
  43275. </remarks>
  43276. <returns>An enumeration of summaries for the requested messages.</returns>
  43277. <param name="uids">The UIDs.</param>
  43278. <param name="items">The message summary items to fetch.</param>
  43279. <param name="headers">The desired header fields.</param>
  43280. <param name="cancellationToken">The cancellation token.</param>
  43281. <exception cref="T:System.ArgumentNullException">
  43282. <para><paramref name="uids"/> is <c>null</c>.</para>
  43283. <para>-or-</para>
  43284. <para><paramref name="headers"/> is <c>null</c>.</para>
  43285. </exception>
  43286. <exception cref="T:System.ArgumentException">
  43287. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  43288. <para>-or-</para>
  43289. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  43290. </exception>
  43291. <exception cref="T:System.ObjectDisposedException">
  43292. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43293. </exception>
  43294. <exception cref="T:MailKit.ServiceNotConnectedException">
  43295. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43296. </exception>
  43297. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43298. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43299. </exception>
  43300. <exception cref="T:MailKit.FolderNotOpenException">
  43301. The folder is not currently open.
  43302. </exception>
  43303. <exception cref="T:System.OperationCanceledException">
  43304. The operation was canceled via the cancellation token.
  43305. </exception>
  43306. <exception cref="T:System.IO.IOException">
  43307. An I/O error occurred.
  43308. </exception>
  43309. <exception cref="T:MailKit.ProtocolException">
  43310. The server's response contained unexpected tokens.
  43311. </exception>
  43312. <exception cref="T:MailKit.CommandException">
  43313. The command failed.
  43314. </exception>
  43315. </member>
  43316. <member name="M:MailKit.MailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  43317. <summary>
  43318. Fetch the message summaries for the specified message UIDs that have a
  43319. higher mod-sequence value than the one specified.
  43320. </summary>
  43321. <remarks>
  43322. <para>Fetches the message summaries for the specified message UIDs that
  43323. have a higher mod-sequence value than the one specified.</para>
  43324. <para>If the mail store supports quick resynchronization and the application has
  43325. enabled this feature via <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/>,
  43326. then this method will emit <see cref="E:MailKit.MailFolder.MessagesVanished"/> events for messages that
  43327. have vanished since the specified mod-sequence value.</para>
  43328. <para>It should be noted that if another client has modified any message
  43329. in the folder, the mail service may choose to return information that was
  43330. not explicitly requested. It is therefore important to be prepared to
  43331. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43332. messages that were requested as well as summaries for messages that were
  43333. not requested at all.</para>
  43334. </remarks>
  43335. <returns>An enumeration of summaries for the requested messages.</returns>
  43336. <param name="uids">The UIDs.</param>
  43337. <param name="modseq">The mod-sequence value.</param>
  43338. <param name="items">The message summary items to fetch.</param>
  43339. <param name="cancellationToken">The cancellation token.</param>
  43340. <exception cref="T:System.ArgumentNullException">
  43341. <paramref name="uids"/> is <c>null</c>.
  43342. </exception>
  43343. <exception cref="T:System.ArgumentOutOfRangeException">
  43344. <paramref name="items"/> is empty.
  43345. </exception>
  43346. <exception cref="T:System.ArgumentException">
  43347. One or more of the <paramref name="uids"/> is invalid.
  43348. </exception>
  43349. <exception cref="T:System.ObjectDisposedException">
  43350. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43351. </exception>
  43352. <exception cref="T:MailKit.ServiceNotConnectedException">
  43353. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43354. </exception>
  43355. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43356. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43357. </exception>
  43358. <exception cref="T:MailKit.FolderNotOpenException">
  43359. The folder is not currently open.
  43360. </exception>
  43361. <exception cref="T:System.NotSupportedException">
  43362. The <see cref="T:MailKit.IMailStore"/> does not support mod-sequences.
  43363. </exception>
  43364. <exception cref="T:System.OperationCanceledException">
  43365. The operation was canceled via the cancellation token.
  43366. </exception>
  43367. <exception cref="T:System.IO.IOException">
  43368. An I/O error occurred.
  43369. </exception>
  43370. <exception cref="T:MailKit.ProtocolException">
  43371. The server's response contained unexpected tokens.
  43372. </exception>
  43373. <exception cref="T:MailKit.CommandException">
  43374. The command failed.
  43375. </exception>
  43376. </member>
  43377. <member name="M:MailKit.MailFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  43378. <summary>
  43379. Asynchronously fetch the message summaries for the specified message UIDs that have a
  43380. higher mod-sequence value than the one specified.
  43381. </summary>
  43382. <remarks>
  43383. <para>Asynchronously fetches the message summaries for the specified message UIDs that
  43384. have a higher mod-sequence value than the one specified.</para>
  43385. <para>If the mail store supports quick resynchronization and the application has
  43386. enabled this feature via <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/>,
  43387. then this method will emit <see cref="E:MailKit.MailFolder.MessagesVanished"/> events for messages that
  43388. have vanished since the specified mod-sequence value.</para>
  43389. <para>It should be noted that if another client has modified any message
  43390. in the folder, the mail service may choose to return information that was
  43391. not explicitly requested. It is therefore important to be prepared to
  43392. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43393. messages that were requested as well as summaries for messages that were
  43394. not requested at all.</para>
  43395. </remarks>
  43396. <returns>An enumeration of summaries for the requested messages.</returns>
  43397. <param name="uids">The UIDs.</param>
  43398. <param name="modseq">The mod-sequence value.</param>
  43399. <param name="items">The message summary items to fetch.</param>
  43400. <param name="cancellationToken">The cancellation token.</param>
  43401. <exception cref="T:System.ArgumentNullException">
  43402. <paramref name="uids"/> is <c>null</c>.
  43403. </exception>
  43404. <exception cref="T:System.ArgumentOutOfRangeException">
  43405. <paramref name="items"/> is empty.
  43406. </exception>
  43407. <exception cref="T:System.ArgumentException">
  43408. One or more of the <paramref name="uids"/> is invalid.
  43409. </exception>
  43410. <exception cref="T:System.ObjectDisposedException">
  43411. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43412. </exception>
  43413. <exception cref="T:MailKit.ServiceNotConnectedException">
  43414. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43415. </exception>
  43416. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43417. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43418. </exception>
  43419. <exception cref="T:MailKit.FolderNotOpenException">
  43420. The folder is not currently open.
  43421. </exception>
  43422. <exception cref="T:System.NotSupportedException">
  43423. The <see cref="T:MailKit.IMailStore"/> does not support mod-sequences.
  43424. </exception>
  43425. <exception cref="T:System.OperationCanceledException">
  43426. The operation was canceled via the cancellation token.
  43427. </exception>
  43428. <exception cref="T:System.IO.IOException">
  43429. An I/O error occurred.
  43430. </exception>
  43431. <exception cref="T:MailKit.ProtocolException">
  43432. The server's response contained unexpected tokens.
  43433. </exception>
  43434. <exception cref="T:MailKit.CommandException">
  43435. The command failed.
  43436. </exception>
  43437. </member>
  43438. <member name="M:MailKit.MailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  43439. <summary>
  43440. Fetch the message summaries for the specified message UIDs that have a
  43441. higher mod-sequence value than the one specified.
  43442. </summary>
  43443. <remarks>
  43444. <para>Fetches the message summaries for the specified message UIDs that
  43445. have a higher mod-sequence value than the one specified.</para>
  43446. <para>If the mail store supports quick resynchronization and the application has
  43447. enabled this feature via <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/>,
  43448. then this method will emit <see cref="E:MailKit.MailFolder.MessagesVanished"/> events for messages that
  43449. have vanished since the specified mod-sequence value.</para>
  43450. <para>It should be noted that if another client has modified any message
  43451. in the folder, the mail service may choose to return information that was
  43452. not explicitly requested. It is therefore important to be prepared to
  43453. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43454. messages that were requested as well as summaries for messages that were
  43455. not requested at all.</para>
  43456. </remarks>
  43457. <returns>An enumeration of summaries for the requested messages.</returns>
  43458. <param name="uids">The UIDs.</param>
  43459. <param name="modseq">The mod-sequence value.</param>
  43460. <param name="items">The message summary items to fetch.</param>
  43461. <param name="headers">The desired header fields.</param>
  43462. <param name="cancellationToken">The cancellation token.</param>
  43463. <exception cref="T:System.ArgumentNullException">
  43464. <para><paramref name="uids"/> is <c>null</c>.</para>
  43465. <para>-or-</para>
  43466. <para><paramref name="headers"/> is <c>null</c>.</para>
  43467. </exception>
  43468. <exception cref="T:System.ArgumentException">
  43469. One or more of the <paramref name="uids"/> is invalid.
  43470. </exception>
  43471. <exception cref="T:System.ObjectDisposedException">
  43472. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43473. </exception>
  43474. <exception cref="T:MailKit.ServiceNotConnectedException">
  43475. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43476. </exception>
  43477. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43478. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43479. </exception>
  43480. <exception cref="T:MailKit.FolderNotOpenException">
  43481. The folder is not currently open.
  43482. </exception>
  43483. <exception cref="T:System.NotSupportedException">
  43484. The <see cref="T:MailKit.IMailStore"/> does not support mod-sequences.
  43485. </exception>
  43486. <exception cref="T:System.OperationCanceledException">
  43487. The operation was canceled via the cancellation token.
  43488. </exception>
  43489. <exception cref="T:System.IO.IOException">
  43490. An I/O error occurred.
  43491. </exception>
  43492. <exception cref="T:MailKit.ProtocolException">
  43493. The server's response contained unexpected tokens.
  43494. </exception>
  43495. <exception cref="T:MailKit.CommandException">
  43496. The command failed.
  43497. </exception>
  43498. </member>
  43499. <member name="M:MailKit.MailFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  43500. <summary>
  43501. Asynchronously fetch the message summaries for the specified message UIDs that have a
  43502. higher mod-sequence value than the one specified.
  43503. </summary>
  43504. <remarks>
  43505. <para>Asynchronously fetches the message summaries for the specified message UIDs that
  43506. have a higher mod-sequence value than the one specified.</para>
  43507. <para>If the mail store supports quick resynchronization and the application has
  43508. enabled this feature via <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/>,
  43509. then this method will emit <see cref="E:MailKit.MailFolder.MessagesVanished"/> events for messages that
  43510. have vanished since the specified mod-sequence value.</para>
  43511. <para>It should be noted that if another client has modified any message
  43512. in the folder, the mail service may choose to return information that was
  43513. not explicitly requested. It is therefore important to be prepared to
  43514. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43515. messages that were requested as well as summaries for messages that were
  43516. not requested at all.</para>
  43517. </remarks>
  43518. <returns>An enumeration of summaries for the requested messages.</returns>
  43519. <param name="uids">The UIDs.</param>
  43520. <param name="modseq">The mod-sequence value.</param>
  43521. <param name="items">The message summary items to fetch.</param>
  43522. <param name="headers">The desired header fields.</param>
  43523. <param name="cancellationToken">The cancellation token.</param>
  43524. <exception cref="T:System.ArgumentNullException">
  43525. <para><paramref name="uids"/> is <c>null</c>.</para>
  43526. <para>-or-</para>
  43527. <para><paramref name="headers"/> is <c>null</c>.</para>
  43528. </exception>
  43529. <exception cref="T:System.ArgumentException">
  43530. One or more of the <paramref name="uids"/> is invalid.
  43531. </exception>
  43532. <exception cref="T:System.ObjectDisposedException">
  43533. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43534. </exception>
  43535. <exception cref="T:MailKit.ServiceNotConnectedException">
  43536. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43537. </exception>
  43538. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43539. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43540. </exception>
  43541. <exception cref="T:MailKit.FolderNotOpenException">
  43542. The folder is not currently open.
  43543. </exception>
  43544. <exception cref="T:System.NotSupportedException">
  43545. The <see cref="T:MailKit.IMailStore"/> does not support mod-sequences.
  43546. </exception>
  43547. <exception cref="T:System.OperationCanceledException">
  43548. The operation was canceled via the cancellation token.
  43549. </exception>
  43550. <exception cref="T:System.IO.IOException">
  43551. An I/O error occurred.
  43552. </exception>
  43553. <exception cref="T:MailKit.ProtocolException">
  43554. The server's response contained unexpected tokens.
  43555. </exception>
  43556. <exception cref="T:MailKit.CommandException">
  43557. The command failed.
  43558. </exception>
  43559. </member>
  43560. <member name="M:MailKit.MailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  43561. <summary>
  43562. Fetch the message summaries for the specified message UIDs that have a
  43563. higher mod-sequence value than the one specified.
  43564. </summary>
  43565. <remarks>
  43566. <para>Fetches the message summaries for the specified message UIDs that
  43567. have a higher mod-sequence value than the one specified.</para>
  43568. <para>If the mail store supports quick resynchronization and the application has
  43569. enabled this feature via <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/>,
  43570. then this method will emit <see cref="E:MailKit.MailFolder.MessagesVanished"/> events for messages that
  43571. have vanished since the specified mod-sequence value.</para>
  43572. <para>It should be noted that if another client has modified any message
  43573. in the folder, the mail service may choose to return information that was
  43574. not explicitly requested. It is therefore important to be prepared to
  43575. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43576. messages that were requested as well as summaries for messages that were
  43577. not requested at all.</para>
  43578. </remarks>
  43579. <returns>An enumeration of summaries for the requested messages.</returns>
  43580. <param name="uids">The UIDs.</param>
  43581. <param name="modseq">The mod-sequence value.</param>
  43582. <param name="items">The message summary items to fetch.</param>
  43583. <param name="headers">The desired header fields.</param>
  43584. <param name="cancellationToken">The cancellation token.</param>
  43585. <exception cref="T:System.ArgumentNullException">
  43586. <para><paramref name="uids"/> is <c>null</c>.</para>
  43587. <para>-or-</para>
  43588. <para><paramref name="headers"/> is <c>null</c>.</para>
  43589. </exception>
  43590. <exception cref="T:System.ArgumentException">
  43591. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  43592. <para>-or-</para>
  43593. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  43594. </exception>
  43595. <exception cref="T:System.ObjectDisposedException">
  43596. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43597. </exception>
  43598. <exception cref="T:MailKit.ServiceNotConnectedException">
  43599. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43600. </exception>
  43601. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43602. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43603. </exception>
  43604. <exception cref="T:MailKit.FolderNotOpenException">
  43605. The folder is not currently open.
  43606. </exception>
  43607. <exception cref="T:System.NotSupportedException">
  43608. The <see cref="T:MailKit.IMailStore"/> does not support mod-sequences.
  43609. </exception>
  43610. <exception cref="T:System.OperationCanceledException">
  43611. The operation was canceled via the cancellation token.
  43612. </exception>
  43613. <exception cref="T:System.IO.IOException">
  43614. An I/O error occurred.
  43615. </exception>
  43616. <exception cref="T:MailKit.ProtocolException">
  43617. The server's response contained unexpected tokens.
  43618. </exception>
  43619. <exception cref="T:MailKit.CommandException">
  43620. The command failed.
  43621. </exception>
  43622. </member>
  43623. <member name="M:MailKit.MailFolder.FetchAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  43624. <summary>
  43625. Asynchronously fetch the message summaries for the specified message UIDs that have a
  43626. higher mod-sequence value than the one specified.
  43627. </summary>
  43628. <remarks>
  43629. <para>Asynchronously fetches the message summaries for the specified message UIDs that
  43630. have a higher mod-sequence value than the one specified.</para>
  43631. <para>If the mail store supports quick resynchronization and the application has
  43632. enabled this feature via <see cref="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)"/>,
  43633. then this method will emit <see cref="E:MailKit.MailFolder.MessagesVanished"/> events for messages that
  43634. have vanished since the specified mod-sequence value.</para>
  43635. <para>It should be noted that if another client has modified any message
  43636. in the folder, the mail service may choose to return information that was
  43637. not explicitly requested. It is therefore important to be prepared to
  43638. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43639. messages that were requested as well as summaries for messages that were
  43640. not requested at all.</para>
  43641. </remarks>
  43642. <returns>An enumeration of summaries for the requested messages.</returns>
  43643. <param name="uids">The UIDs.</param>
  43644. <param name="modseq">The mod-sequence value.</param>
  43645. <param name="items">The message summary items to fetch.</param>
  43646. <param name="headers">The desired header fields.</param>
  43647. <param name="cancellationToken">The cancellation token.</param>
  43648. <exception cref="T:System.ArgumentNullException">
  43649. <para><paramref name="uids"/> is <c>null</c>.</para>
  43650. <para>-or-</para>
  43651. <para><paramref name="headers"/> is <c>null</c>.</para>
  43652. </exception>
  43653. <exception cref="T:System.ArgumentException">
  43654. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  43655. <para>-or-</para>
  43656. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  43657. </exception>
  43658. <exception cref="T:System.ObjectDisposedException">
  43659. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43660. </exception>
  43661. <exception cref="T:MailKit.ServiceNotConnectedException">
  43662. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43663. </exception>
  43664. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43665. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43666. </exception>
  43667. <exception cref="T:MailKit.FolderNotOpenException">
  43668. The folder is not currently open.
  43669. </exception>
  43670. <exception cref="T:System.NotSupportedException">
  43671. The <see cref="T:MailKit.IMailStore"/> does not support mod-sequences.
  43672. </exception>
  43673. <exception cref="T:System.OperationCanceledException">
  43674. The operation was canceled via the cancellation token.
  43675. </exception>
  43676. <exception cref="T:System.IO.IOException">
  43677. An I/O error occurred.
  43678. </exception>
  43679. <exception cref="T:MailKit.ProtocolException">
  43680. The server's response contained unexpected tokens.
  43681. </exception>
  43682. <exception cref="T:MailKit.CommandException">
  43683. The command failed.
  43684. </exception>
  43685. </member>
  43686. <member name="M:MailKit.MailFolder.Fetch(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  43687. <summary>
  43688. Fetch the message summaries for the specified message indexes.
  43689. </summary>
  43690. <remarks>
  43691. <para>Fetches the message summaries for the specified message indexes.</para>
  43692. <para>It should be noted that if another client has modified any message
  43693. in the folder, the mail service may choose to return information that was
  43694. not explicitly requested. It is therefore important to be prepared to
  43695. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43696. messages that were requested as well as summaries for messages that were
  43697. not requested at all.</para>
  43698. </remarks>
  43699. <returns>An enumeration of summaries for the requested messages.</returns>
  43700. <param name="indexes">The indexes.</param>
  43701. <param name="items">The message summary items to fetch.</param>
  43702. <param name="cancellationToken">The cancellation token.</param>
  43703. <exception cref="T:System.ArgumentNullException">
  43704. <paramref name="indexes"/> is <c>null</c>.
  43705. </exception>
  43706. <exception cref="T:System.ArgumentOutOfRangeException">
  43707. <paramref name="items"/> is empty.
  43708. </exception>
  43709. <exception cref="T:System.ArgumentException">
  43710. One or more of the <paramref name="indexes"/> is invalid.
  43711. </exception>
  43712. <exception cref="T:System.ObjectDisposedException">
  43713. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43714. </exception>
  43715. <exception cref="T:MailKit.ServiceNotConnectedException">
  43716. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43717. </exception>
  43718. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43719. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43720. </exception>
  43721. <exception cref="T:MailKit.FolderNotOpenException">
  43722. The folder is not currently open.
  43723. </exception>
  43724. <exception cref="T:System.OperationCanceledException">
  43725. The operation was canceled via the cancellation token.
  43726. </exception>
  43727. <exception cref="T:System.IO.IOException">
  43728. An I/O error occurred.
  43729. </exception>
  43730. <exception cref="T:MailKit.ProtocolException">
  43731. The server's response contained unexpected tokens.
  43732. </exception>
  43733. <exception cref="T:MailKit.CommandException">
  43734. The command failed.
  43735. </exception>
  43736. </member>
  43737. <member name="M:MailKit.MailFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  43738. <summary>
  43739. Asynchronously fetch the message summaries for the specified message indexes.
  43740. </summary>
  43741. <remarks>
  43742. <para>Asynchronously fetches the message summaries for the specified message
  43743. indexes.</para>
  43744. <para>It should be noted that if another client has modified any message
  43745. in the folder, the mail service may choose to return information that was
  43746. not explicitly requested. It is therefore important to be prepared to
  43747. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43748. messages that were requested as well as summaries for messages that were
  43749. not requested at all.</para>
  43750. </remarks>
  43751. <returns>An enumeration of summaries for the requested messages.</returns>
  43752. <param name="indexes">The indexes.</param>
  43753. <param name="items">The message summary items to fetch.</param>
  43754. <param name="cancellationToken">The cancellation token.</param>
  43755. <exception cref="T:System.ArgumentNullException">
  43756. <paramref name="indexes"/> is <c>null</c>.
  43757. </exception>
  43758. <exception cref="T:System.ArgumentOutOfRangeException">
  43759. <paramref name="items"/> is empty.
  43760. </exception>
  43761. <exception cref="T:System.ArgumentException">
  43762. One or more of the <paramref name="indexes"/> is invalid.
  43763. </exception>
  43764. <exception cref="T:System.ObjectDisposedException">
  43765. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43766. </exception>
  43767. <exception cref="T:MailKit.ServiceNotConnectedException">
  43768. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43769. </exception>
  43770. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43771. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43772. </exception>
  43773. <exception cref="T:MailKit.FolderNotOpenException">
  43774. The folder is not currently open.
  43775. </exception>
  43776. <exception cref="T:System.OperationCanceledException">
  43777. The operation was canceled via the cancellation token.
  43778. </exception>
  43779. <exception cref="T:System.IO.IOException">
  43780. An I/O error occurred.
  43781. </exception>
  43782. <exception cref="T:MailKit.ProtocolException">
  43783. The server's response contained unexpected tokens.
  43784. </exception>
  43785. <exception cref="T:MailKit.CommandException">
  43786. The command failed.
  43787. </exception>
  43788. </member>
  43789. <member name="M:MailKit.MailFolder.Fetch(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  43790. <summary>
  43791. Fetch the message summaries for the specified message indexes.
  43792. </summary>
  43793. <remarks>
  43794. <para>Fetches the message summaries for the specified message indexes.</para>
  43795. <para>It should be noted that if another client has modified any message
  43796. in the folder, the mail service may choose to return information that was
  43797. not explicitly requested. It is therefore important to be prepared to
  43798. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43799. messages that were requested as well as summaries for messages that were
  43800. not requested at all.</para>
  43801. </remarks>
  43802. <returns>An enumeration of summaries for the requested messages.</returns>
  43803. <param name="indexes">The indexes.</param>
  43804. <param name="items">The message summary items to fetch.</param>
  43805. <param name="headers">The desired header fields.</param>
  43806. <param name="cancellationToken">The cancellation token.</param>
  43807. <exception cref="T:System.ArgumentNullException">
  43808. <para><paramref name="indexes"/> is <c>null</c>.</para>
  43809. <para>-or-</para>
  43810. <para><paramref name="headers"/> is <c>null</c>.</para>
  43811. </exception>
  43812. <exception cref="T:System.ArgumentException">
  43813. One or more of the <paramref name="indexes"/> is invalid.
  43814. </exception>
  43815. <exception cref="T:System.ObjectDisposedException">
  43816. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43817. </exception>
  43818. <exception cref="T:MailKit.ServiceNotConnectedException">
  43819. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43820. </exception>
  43821. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43822. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43823. </exception>
  43824. <exception cref="T:MailKit.FolderNotOpenException">
  43825. The folder is not currently open.
  43826. </exception>
  43827. <exception cref="T:System.OperationCanceledException">
  43828. The operation was canceled via the cancellation token.
  43829. </exception>
  43830. <exception cref="T:System.IO.IOException">
  43831. An I/O error occurred.
  43832. </exception>
  43833. <exception cref="T:MailKit.ProtocolException">
  43834. The server's response contained unexpected tokens.
  43835. </exception>
  43836. <exception cref="T:MailKit.CommandException">
  43837. The command failed.
  43838. </exception>
  43839. </member>
  43840. <member name="M:MailKit.MailFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  43841. <summary>
  43842. Asynchronously fetch the message summaries for the specified message indexes.
  43843. </summary>
  43844. <remarks>
  43845. <para>Asynchronously fetches the message summaries for the specified message
  43846. indexes.</para>
  43847. <para>It should be noted that if another client has modified any message
  43848. in the folder, the mail service may choose to return information that was
  43849. not explicitly requested. It is therefore important to be prepared to
  43850. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43851. messages that were requested as well as summaries for messages that were
  43852. not requested at all.</para>
  43853. </remarks>
  43854. <returns>An enumeration of summaries for the requested messages.</returns>
  43855. <param name="indexes">The indexes.</param>
  43856. <param name="items">The message summary items to fetch.</param>
  43857. <param name="headers">The desired header fields.</param>
  43858. <param name="cancellationToken">The cancellation token.</param>
  43859. <exception cref="T:System.ArgumentNullException">
  43860. <para><paramref name="indexes"/> is <c>null</c>.</para>
  43861. <para>-or-</para>
  43862. <para><paramref name="headers"/> is <c>null</c>.</para>
  43863. </exception>
  43864. <exception cref="T:System.ArgumentException">
  43865. One or more of the <paramref name="indexes"/> is invalid.
  43866. </exception>
  43867. <exception cref="T:System.ObjectDisposedException">
  43868. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43869. </exception>
  43870. <exception cref="T:MailKit.ServiceNotConnectedException">
  43871. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43872. </exception>
  43873. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43874. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43875. </exception>
  43876. <exception cref="T:MailKit.FolderNotOpenException">
  43877. The folder is not currently open.
  43878. </exception>
  43879. <exception cref="T:System.OperationCanceledException">
  43880. The operation was canceled via the cancellation token.
  43881. </exception>
  43882. <exception cref="T:System.IO.IOException">
  43883. An I/O error occurred.
  43884. </exception>
  43885. <exception cref="T:MailKit.ProtocolException">
  43886. The server's response contained unexpected tokens.
  43887. </exception>
  43888. <exception cref="T:MailKit.CommandException">
  43889. The command failed.
  43890. </exception>
  43891. </member>
  43892. <member name="M:MailKit.MailFolder.Fetch(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  43893. <summary>
  43894. Fetch the message summaries for the specified message indexes.
  43895. </summary>
  43896. <remarks>
  43897. <para>Fetches the message summaries for the specified message indexes.</para>
  43898. <para>It should be noted that if another client has modified any message
  43899. in the folder, the mail service may choose to return information that was
  43900. not explicitly requested. It is therefore important to be prepared to
  43901. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43902. messages that were requested as well as summaries for messages that were
  43903. not requested at all.</para>
  43904. </remarks>
  43905. <returns>An enumeration of summaries for the requested messages.</returns>
  43906. <param name="indexes">The indexes.</param>
  43907. <param name="items">The message summary items to fetch.</param>
  43908. <param name="headers">The desired header fields.</param>
  43909. <param name="cancellationToken">The cancellation token.</param>
  43910. <exception cref="T:System.ArgumentNullException">
  43911. <para><paramref name="indexes"/> is <c>null</c>.</para>
  43912. <para>-or-</para>
  43913. <para><paramref name="headers"/> is <c>null</c>.</para>
  43914. </exception>
  43915. <exception cref="T:System.ArgumentException">
  43916. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  43917. <para>-or-</para>
  43918. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  43919. </exception>
  43920. <exception cref="T:System.ObjectDisposedException">
  43921. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43922. </exception>
  43923. <exception cref="T:MailKit.ServiceNotConnectedException">
  43924. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43925. </exception>
  43926. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43927. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43928. </exception>
  43929. <exception cref="T:MailKit.FolderNotOpenException">
  43930. The folder is not currently open.
  43931. </exception>
  43932. <exception cref="T:System.OperationCanceledException">
  43933. The operation was canceled via the cancellation token.
  43934. </exception>
  43935. <exception cref="T:System.IO.IOException">
  43936. An I/O error occurred.
  43937. </exception>
  43938. <exception cref="T:MailKit.ProtocolException">
  43939. The server's response contained unexpected tokens.
  43940. </exception>
  43941. <exception cref="T:MailKit.CommandException">
  43942. The command failed.
  43943. </exception>
  43944. </member>
  43945. <member name="M:MailKit.MailFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  43946. <summary>
  43947. Asynchronously fetch the message summaries for the specified message indexes.
  43948. </summary>
  43949. <remarks>
  43950. <para>Asynchronously fetches the message summaries for the specified message
  43951. indexes.</para>
  43952. <para>It should be noted that if another client has modified any message
  43953. in the folder, the mail service may choose to return information that was
  43954. not explicitly requested. It is therefore important to be prepared to
  43955. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  43956. messages that were requested as well as summaries for messages that were
  43957. not requested at all.</para>
  43958. </remarks>
  43959. <returns>An enumeration of summaries for the requested messages.</returns>
  43960. <param name="indexes">The indexes.</param>
  43961. <param name="items">The message summary items to fetch.</param>
  43962. <param name="headers">The desired header fields.</param>
  43963. <param name="cancellationToken">The cancellation token.</param>
  43964. <exception cref="T:System.ArgumentNullException">
  43965. <para><paramref name="indexes"/> is <c>null</c>.</para>
  43966. <para>-or-</para>
  43967. <para><paramref name="headers"/> is <c>null</c>.</para>
  43968. </exception>
  43969. <exception cref="T:System.ArgumentException">
  43970. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  43971. <para>-or-</para>
  43972. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  43973. </exception>
  43974. <exception cref="T:System.ObjectDisposedException">
  43975. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  43976. </exception>
  43977. <exception cref="T:MailKit.ServiceNotConnectedException">
  43978. The <see cref="T:MailKit.IMailStore"/> is not connected.
  43979. </exception>
  43980. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  43981. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  43982. </exception>
  43983. <exception cref="T:MailKit.FolderNotOpenException">
  43984. The folder is not currently open.
  43985. </exception>
  43986. <exception cref="T:System.OperationCanceledException">
  43987. The operation was canceled via the cancellation token.
  43988. </exception>
  43989. <exception cref="T:System.IO.IOException">
  43990. An I/O error occurred.
  43991. </exception>
  43992. <exception cref="T:MailKit.ProtocolException">
  43993. The server's response contained unexpected tokens.
  43994. </exception>
  43995. <exception cref="T:MailKit.CommandException">
  43996. The command failed.
  43997. </exception>
  43998. </member>
  43999. <member name="M:MailKit.MailFolder.Fetch(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  44000. <summary>
  44001. Fetch the message summaries for the specified message indexes that have a
  44002. higher mod-sequence value than the one specified.
  44003. </summary>
  44004. <remarks>
  44005. <para>Fetches the message summaries for the specified message indexes that
  44006. have a higher mod-sequence value than the one specified.</para>
  44007. <para>It should be noted that if another client has modified any message
  44008. in the folder, the mail service may choose to return information that was
  44009. not explicitly requested. It is therefore important to be prepared to
  44010. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44011. messages that were requested as well as summaries for messages that were
  44012. not requested at all.</para>
  44013. </remarks>
  44014. <returns>An enumeration of summaries for the requested messages.</returns>
  44015. <param name="indexes">The indexes.</param>
  44016. <param name="modseq">The mod-sequence value.</param>
  44017. <param name="items">The message summary items to fetch.</param>
  44018. <param name="cancellationToken">The cancellation token.</param>
  44019. <exception cref="T:System.ArgumentNullException">
  44020. <paramref name="indexes"/> is <c>null</c>.
  44021. </exception>
  44022. <exception cref="T:System.ArgumentOutOfRangeException">
  44023. <paramref name="items"/> is empty.
  44024. </exception>
  44025. <exception cref="T:System.ArgumentException">
  44026. One or more of the <paramref name="indexes"/> is invalid.
  44027. </exception>
  44028. <exception cref="T:System.ObjectDisposedException">
  44029. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44030. </exception>
  44031. <exception cref="T:MailKit.ServiceNotConnectedException">
  44032. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44033. </exception>
  44034. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44035. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44036. </exception>
  44037. <exception cref="T:MailKit.FolderNotOpenException">
  44038. The folder is not currently open.
  44039. </exception>
  44040. <exception cref="T:System.NotSupportedException">
  44041. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  44042. </exception>
  44043. <exception cref="T:System.OperationCanceledException">
  44044. The operation was canceled via the cancellation token.
  44045. </exception>
  44046. <exception cref="T:System.IO.IOException">
  44047. An I/O error occurred.
  44048. </exception>
  44049. <exception cref="T:MailKit.ProtocolException">
  44050. The server's response contained unexpected tokens.
  44051. </exception>
  44052. <exception cref="T:MailKit.CommandException">
  44053. The command failed.
  44054. </exception>
  44055. </member>
  44056. <member name="M:MailKit.MailFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  44057. <summary>
  44058. Asynchronously fetch the message summaries for the specified message indexes that
  44059. have a higher mod-sequence value than the one specified.
  44060. </summary>
  44061. <remarks>
  44062. <para>Asynchronously fetches the message summaries for the specified message
  44063. indexes that have a higher mod-sequence value than the one specified.</para>
  44064. <para>It should be noted that if another client has modified any message
  44065. in the folder, the mail service may choose to return information that was
  44066. not explicitly requested. It is therefore important to be prepared to
  44067. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44068. messages that were requested as well as summaries for messages that were
  44069. not requested at all.</para>
  44070. </remarks>
  44071. <returns>An enumeration of summaries for the requested messages.</returns>
  44072. <param name="indexes">The indexes.</param>
  44073. <param name="modseq">The mod-sequence value.</param>
  44074. <param name="items">The message summary items to fetch.</param>
  44075. <param name="cancellationToken">The cancellation token.</param>
  44076. <exception cref="T:System.ArgumentNullException">
  44077. <paramref name="indexes"/> is <c>null</c>.
  44078. </exception>
  44079. <exception cref="T:System.ArgumentOutOfRangeException">
  44080. <paramref name="items"/> is empty.
  44081. </exception>
  44082. <exception cref="T:System.ArgumentException">
  44083. One or more of the <paramref name="indexes"/> is invalid.
  44084. </exception>
  44085. <exception cref="T:System.ObjectDisposedException">
  44086. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44087. </exception>
  44088. <exception cref="T:MailKit.ServiceNotConnectedException">
  44089. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44090. </exception>
  44091. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44092. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44093. </exception>
  44094. <exception cref="T:MailKit.FolderNotOpenException">
  44095. The folder is not currently open.
  44096. </exception>
  44097. <exception cref="T:System.NotSupportedException">
  44098. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  44099. </exception>
  44100. <exception cref="T:System.OperationCanceledException">
  44101. The operation was canceled via the cancellation token.
  44102. </exception>
  44103. <exception cref="T:System.IO.IOException">
  44104. An I/O error occurred.
  44105. </exception>
  44106. <exception cref="T:MailKit.ProtocolException">
  44107. The server's response contained unexpected tokens.
  44108. </exception>
  44109. <exception cref="T:MailKit.CommandException">
  44110. The command failed.
  44111. </exception>
  44112. </member>
  44113. <member name="M:MailKit.MailFolder.Fetch(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  44114. <summary>
  44115. Fetch the message summaries for the specified message indexes that
  44116. have a higher mod-sequence value than the one specified.
  44117. </summary>
  44118. <remarks>
  44119. <para>Fetches the message summaries for the specified message indexes that
  44120. have a higher mod-sequence value than the one specified.</para>
  44121. <para>It should be noted that if another client has modified any message
  44122. in the folder, the mail service may choose to return information that was
  44123. not explicitly requested. It is therefore important to be prepared to
  44124. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44125. messages that were requested as well as summaries for messages that were
  44126. not requested at all.</para>
  44127. </remarks>
  44128. <returns>An enumeration of summaries for the requested messages.</returns>
  44129. <param name="indexes">The indexes.</param>
  44130. <param name="modseq">The mod-sequence value.</param>
  44131. <param name="items">The message summary items to fetch.</param>
  44132. <param name="headers">The desired header fields.</param>
  44133. <param name="cancellationToken">The cancellation token.</param>
  44134. <exception cref="T:System.ArgumentNullException">
  44135. <para><paramref name="indexes"/> is <c>null</c>.</para>
  44136. <para>-or-</para>
  44137. <para><paramref name="headers"/> is <c>null</c>.</para>
  44138. </exception>
  44139. <exception cref="T:System.ArgumentException">
  44140. One or more of the <paramref name="indexes"/> is invalid.
  44141. </exception>
  44142. <exception cref="T:System.ObjectDisposedException">
  44143. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44144. </exception>
  44145. <exception cref="T:MailKit.ServiceNotConnectedException">
  44146. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44147. </exception>
  44148. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44149. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44150. </exception>
  44151. <exception cref="T:MailKit.FolderNotOpenException">
  44152. The folder is not currently open.
  44153. </exception>
  44154. <exception cref="T:System.OperationCanceledException">
  44155. The operation was canceled via the cancellation token.
  44156. </exception>
  44157. <exception cref="T:System.IO.IOException">
  44158. An I/O error occurred.
  44159. </exception>
  44160. <exception cref="T:MailKit.ProtocolException">
  44161. The server's response contained unexpected tokens.
  44162. </exception>
  44163. <exception cref="T:MailKit.CommandException">
  44164. The command failed.
  44165. </exception>
  44166. </member>
  44167. <member name="M:MailKit.MailFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  44168. <summary>
  44169. Asynchronously fetch the message summaries for the specified message indexes that
  44170. have a higher mod-sequence value than the one specified.
  44171. </summary>
  44172. <remarks>
  44173. <para>Asynchronously fetches the message summaries for the specified message
  44174. indexes that have a higher mod-sequence value than the one specified.</para>
  44175. <para>It should be noted that if another client has modified any message
  44176. in the folder, the mail service may choose to return information that was
  44177. not explicitly requested. It is therefore important to be prepared to
  44178. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44179. messages that were requested as well as summaries for messages that were
  44180. not requested at all.</para>
  44181. </remarks>
  44182. <returns>An enumeration of summaries for the requested messages.</returns>
  44183. <param name="indexes">The indexes.</param>
  44184. <param name="modseq">The mod-sequence value.</param>
  44185. <param name="items">The message summary items to fetch.</param>
  44186. <param name="headers">The desired header fields.</param>
  44187. <param name="cancellationToken">The cancellation token.</param>
  44188. <exception cref="T:System.ArgumentNullException">
  44189. <para><paramref name="indexes"/> is <c>null</c>.</para>
  44190. <para>-or-</para>
  44191. <para><paramref name="headers"/> is <c>null</c>.</para>
  44192. </exception>
  44193. <exception cref="T:System.ArgumentException">
  44194. One or more of the <paramref name="indexes"/> is invalid.
  44195. </exception>
  44196. <exception cref="T:System.ObjectDisposedException">
  44197. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44198. </exception>
  44199. <exception cref="T:MailKit.ServiceNotConnectedException">
  44200. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44201. </exception>
  44202. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44203. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44204. </exception>
  44205. <exception cref="T:MailKit.FolderNotOpenException">
  44206. The folder is not currently open.
  44207. </exception>
  44208. <exception cref="T:System.OperationCanceledException">
  44209. The operation was canceled via the cancellation token.
  44210. </exception>
  44211. <exception cref="T:System.IO.IOException">
  44212. An I/O error occurred.
  44213. </exception>
  44214. <exception cref="T:MailKit.ProtocolException">
  44215. The server's response contained unexpected tokens.
  44216. </exception>
  44217. <exception cref="T:MailKit.CommandException">
  44218. The command failed.
  44219. </exception>
  44220. </member>
  44221. <member name="M:MailKit.MailFolder.Fetch(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  44222. <summary>
  44223. Fetch the message summaries for the specified message indexes that
  44224. have a higher mod-sequence value than the one specified.
  44225. </summary>
  44226. <remarks>
  44227. <para>Fetches the message summaries for the specified message indexes that
  44228. have a higher mod-sequence value than the one specified.</para>
  44229. <para>It should be noted that if another client has modified any message
  44230. in the folder, the mail service may choose to return information that was
  44231. not explicitly requested. It is therefore important to be prepared to
  44232. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44233. messages that were requested as well as summaries for messages that were
  44234. not requested at all.</para>
  44235. </remarks>
  44236. <returns>An enumeration of summaries for the requested messages.</returns>
  44237. <param name="indexes">The indexes.</param>
  44238. <param name="modseq">The mod-sequence value.</param>
  44239. <param name="items">The message summary items to fetch.</param>
  44240. <param name="headers">The desired header fields.</param>
  44241. <param name="cancellationToken">The cancellation token.</param>
  44242. <exception cref="T:System.ArgumentNullException">
  44243. <para><paramref name="indexes"/> is <c>null</c>.</para>
  44244. <para>-or-</para>
  44245. <para><paramref name="headers"/> is <c>null</c>.</para>
  44246. </exception>
  44247. <exception cref="T:System.ArgumentException">
  44248. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  44249. <para>-or-</para>
  44250. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  44251. </exception>
  44252. <exception cref="T:System.ObjectDisposedException">
  44253. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44254. </exception>
  44255. <exception cref="T:MailKit.ServiceNotConnectedException">
  44256. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44257. </exception>
  44258. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44259. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44260. </exception>
  44261. <exception cref="T:MailKit.FolderNotOpenException">
  44262. The folder is not currently open.
  44263. </exception>
  44264. <exception cref="T:System.OperationCanceledException">
  44265. The operation was canceled via the cancellation token.
  44266. </exception>
  44267. <exception cref="T:System.IO.IOException">
  44268. An I/O error occurred.
  44269. </exception>
  44270. <exception cref="T:MailKit.ProtocolException">
  44271. The server's response contained unexpected tokens.
  44272. </exception>
  44273. <exception cref="T:MailKit.CommandException">
  44274. The command failed.
  44275. </exception>
  44276. </member>
  44277. <member name="M:MailKit.MailFolder.FetchAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  44278. <summary>
  44279. Asynchronously fetch the message summaries for the specified message indexes that
  44280. have a higher mod-sequence value than the one specified.
  44281. </summary>
  44282. <remarks>
  44283. <para>Asynchronously fetches the message summaries for the specified message
  44284. indexes that have a higher mod-sequence value than the one specified.</para>
  44285. <para>It should be noted that if another client has modified any message
  44286. in the folder, the mail service may choose to return information that was
  44287. not explicitly requested. It is therefore important to be prepared to
  44288. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44289. messages that were requested as well as summaries for messages that were
  44290. not requested at all.</para>
  44291. </remarks>
  44292. <returns>An enumeration of summaries for the requested messages.</returns>
  44293. <param name="indexes">The indexes.</param>
  44294. <param name="modseq">The mod-sequence value.</param>
  44295. <param name="items">The message summary items to fetch.</param>
  44296. <param name="headers">The desired header fields.</param>
  44297. <param name="cancellationToken">The cancellation token.</param>
  44298. <exception cref="T:System.ArgumentNullException">
  44299. <para><paramref name="indexes"/> is <c>null</c>.</para>
  44300. <para>-or-</para>
  44301. <para><paramref name="headers"/> is <c>null</c>.</para>
  44302. </exception>
  44303. <exception cref="T:System.ArgumentException">
  44304. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  44305. <para>-or-</para>
  44306. <para>One or more of the specified <paramref name="headers"/> is invalid.</para>
  44307. </exception>
  44308. <exception cref="T:System.ObjectDisposedException">
  44309. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44310. </exception>
  44311. <exception cref="T:MailKit.ServiceNotConnectedException">
  44312. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44313. </exception>
  44314. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44315. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44316. </exception>
  44317. <exception cref="T:MailKit.FolderNotOpenException">
  44318. The folder is not currently open.
  44319. </exception>
  44320. <exception cref="T:System.OperationCanceledException">
  44321. The operation was canceled via the cancellation token.
  44322. </exception>
  44323. <exception cref="T:System.IO.IOException">
  44324. An I/O error occurred.
  44325. </exception>
  44326. <exception cref="T:MailKit.ProtocolException">
  44327. The server's response contained unexpected tokens.
  44328. </exception>
  44329. <exception cref="T:MailKit.CommandException">
  44330. The command failed.
  44331. </exception>
  44332. </member>
  44333. <member name="M:MailKit.MailFolder.Fetch(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  44334. <summary>
  44335. Fetch the message summaries for the messages between the two indexes, inclusive.
  44336. </summary>
  44337. <remarks>
  44338. <para>Fetches the message summaries for the messages between the two
  44339. indexes, inclusive.</para>
  44340. <para>It should be noted that if another client has modified any message
  44341. in the folder, the mail service may choose to return information that was
  44342. not explicitly requested. It is therefore important to be prepared to
  44343. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44344. messages that were requested as well as summaries for messages that were
  44345. not requested at all.</para>
  44346. </remarks>
  44347. <returns>An enumeration of summaries for the requested messages.</returns>
  44348. <param name="min">The minimum index.</param>
  44349. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  44350. <param name="items">The message summary items to fetch.</param>
  44351. <param name="cancellationToken">The cancellation token.</param>
  44352. <exception cref="T:System.ArgumentOutOfRangeException">
  44353. <para><paramref name="min"/> is out of range.</para>
  44354. <para>-or-</para>
  44355. <para><paramref name="max"/> is out of range.</para>
  44356. <para>-or-</para>
  44357. <para><paramref name="items"/> is empty.</para>
  44358. </exception>
  44359. <exception cref="T:System.ObjectDisposedException">
  44360. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44361. </exception>
  44362. <exception cref="T:MailKit.ServiceNotConnectedException">
  44363. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44364. </exception>
  44365. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44366. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44367. </exception>
  44368. <exception cref="T:MailKit.FolderNotOpenException">
  44369. The folder is not currently open.
  44370. </exception>
  44371. <exception cref="T:System.OperationCanceledException">
  44372. The operation was canceled via the cancellation token.
  44373. </exception>
  44374. <exception cref="T:System.IO.IOException">
  44375. An I/O error occurred.
  44376. </exception>
  44377. <exception cref="T:MailKit.ProtocolException">
  44378. The server's response contained unexpected tokens.
  44379. </exception>
  44380. <exception cref="T:MailKit.CommandException">
  44381. The command failed.
  44382. </exception>
  44383. </member>
  44384. <member name="M:MailKit.MailFolder.FetchAsync(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  44385. <summary>
  44386. Asynchronously fetch the message summaries for the messages between the two indexes, inclusive.
  44387. </summary>
  44388. <remarks>
  44389. <para>Asynchronously fetches the message summaries for the messages between
  44390. the two indexes, inclusive.</para>
  44391. <para>It should be noted that if another client has modified any message
  44392. in the folder, the mail service may choose to return information that was
  44393. not explicitly requested. It is therefore important to be prepared to
  44394. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44395. messages that were requested as well as summaries for messages that were
  44396. not requested at all.</para>
  44397. </remarks>
  44398. <returns>An enumeration of summaries for the requested messages.</returns>
  44399. <param name="min">The minimum index.</param>
  44400. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  44401. <param name="items">The message summary items to fetch.</param>
  44402. <param name="cancellationToken">The cancellation token.</param>
  44403. <exception cref="T:System.ArgumentOutOfRangeException">
  44404. <para><paramref name="min"/> is out of range.</para>
  44405. <para>-or-</para>
  44406. <para><paramref name="max"/> is out of range.</para>
  44407. <para>-or-</para>
  44408. <para><paramref name="items"/> is empty.</para>
  44409. </exception>
  44410. <exception cref="T:System.ObjectDisposedException">
  44411. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44412. </exception>
  44413. <exception cref="T:MailKit.ServiceNotConnectedException">
  44414. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44415. </exception>
  44416. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44417. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44418. </exception>
  44419. <exception cref="T:MailKit.FolderNotOpenException">
  44420. The folder is not currently open.
  44421. </exception>
  44422. <exception cref="T:System.OperationCanceledException">
  44423. The operation was canceled via the cancellation token.
  44424. </exception>
  44425. <exception cref="T:System.IO.IOException">
  44426. An I/O error occurred.
  44427. </exception>
  44428. <exception cref="T:MailKit.ProtocolException">
  44429. The server's response contained unexpected tokens.
  44430. </exception>
  44431. <exception cref="T:MailKit.CommandException">
  44432. The command failed.
  44433. </exception>
  44434. </member>
  44435. <member name="M:MailKit.MailFolder.Fetch(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  44436. <summary>
  44437. Fetch the message summaries for the messages between the two indexes, inclusive.
  44438. </summary>
  44439. <remarks>
  44440. <para>Fetches the message summaries for the messages between the two
  44441. indexes, inclusive.</para>
  44442. <para>It should be noted that if another client has modified any message
  44443. in the folder, the mail service may choose to return information that was
  44444. not explicitly requested. It is therefore important to be prepared to
  44445. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44446. messages that were requested as well as summaries for messages that were
  44447. not requested at all.</para>
  44448. </remarks>
  44449. <returns>An enumeration of summaries for the requested messages.</returns>
  44450. <param name="min">The minimum index.</param>
  44451. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  44452. <param name="items">The message summary items to fetch.</param>
  44453. <param name="headers">The desired header fields.</param>
  44454. <param name="cancellationToken">The cancellation token.</param>
  44455. <exception cref="T:System.ArgumentOutOfRangeException">
  44456. <para><paramref name="min"/> is out of range.</para>
  44457. <para>-or-</para>
  44458. <para><paramref name="max"/> is out of range.</para>
  44459. </exception>
  44460. <exception cref="T:System.ArgumentNullException">
  44461. <paramref name="headers"/> is <c>null</c>.
  44462. </exception>
  44463. <exception cref="T:System.ObjectDisposedException">
  44464. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44465. </exception>
  44466. <exception cref="T:MailKit.ServiceNotConnectedException">
  44467. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44468. </exception>
  44469. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44470. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44471. </exception>
  44472. <exception cref="T:MailKit.FolderNotOpenException">
  44473. The folder is not currently open.
  44474. </exception>
  44475. <exception cref="T:System.OperationCanceledException">
  44476. The operation was canceled via the cancellation token.
  44477. </exception>
  44478. <exception cref="T:System.IO.IOException">
  44479. An I/O error occurred.
  44480. </exception>
  44481. <exception cref="T:MailKit.ProtocolException">
  44482. The server's response contained unexpected tokens.
  44483. </exception>
  44484. <exception cref="T:MailKit.CommandException">
  44485. The command failed.
  44486. </exception>
  44487. </member>
  44488. <member name="M:MailKit.MailFolder.FetchAsync(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  44489. <summary>
  44490. Asynchronously fetch the message summaries for the messages between the two indexes, inclusive.
  44491. </summary>
  44492. <remarks>
  44493. <para>Asynchronously fetches the message summaries for the messages between
  44494. the two indexes, inclusive.</para>
  44495. <para>It should be noted that if another client has modified any message
  44496. in the folder, the mail service may choose to return information that was
  44497. not explicitly requested. It is therefore important to be prepared to
  44498. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44499. messages that were requested as well as summaries for messages that were
  44500. not requested at all.</para>
  44501. </remarks>
  44502. <returns>An enumeration of summaries for the requested messages.</returns>
  44503. <param name="min">The minimum index.</param>
  44504. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  44505. <param name="items">The message summary items to fetch.</param>
  44506. <param name="headers">The desired header fields.</param>
  44507. <param name="cancellationToken">The cancellation token.</param>
  44508. <exception cref="T:System.ArgumentOutOfRangeException">
  44509. <para><paramref name="min"/> is out of range.</para>
  44510. <para>-or-</para>
  44511. <para><paramref name="max"/> is out of range.</para>
  44512. </exception>
  44513. <exception cref="T:System.ArgumentNullException">
  44514. <paramref name="headers"/> is <c>null</c>.
  44515. </exception>
  44516. <exception cref="T:System.ObjectDisposedException">
  44517. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44518. </exception>
  44519. <exception cref="T:MailKit.ServiceNotConnectedException">
  44520. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44521. </exception>
  44522. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44523. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44524. </exception>
  44525. <exception cref="T:MailKit.FolderNotOpenException">
  44526. The folder is not currently open.
  44527. </exception>
  44528. <exception cref="T:System.OperationCanceledException">
  44529. The operation was canceled via the cancellation token.
  44530. </exception>
  44531. <exception cref="T:System.IO.IOException">
  44532. An I/O error occurred.
  44533. </exception>
  44534. <exception cref="T:MailKit.ProtocolException">
  44535. The server's response contained unexpected tokens.
  44536. </exception>
  44537. <exception cref="T:MailKit.CommandException">
  44538. The command failed.
  44539. </exception>
  44540. </member>
  44541. <member name="M:MailKit.MailFolder.Fetch(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  44542. <summary>
  44543. Fetch the message summaries for the messages between the two indexes, inclusive.
  44544. </summary>
  44545. <remarks>
  44546. <para>Fetches the message summaries for the messages between the two
  44547. indexes, inclusive.</para>
  44548. <para>It should be noted that if another client has modified any message
  44549. in the folder, the mail service may choose to return information that was
  44550. not explicitly requested. It is therefore important to be prepared to
  44551. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44552. messages that were requested as well as summaries for messages that were
  44553. not requested at all.</para>
  44554. </remarks>
  44555. <returns>An enumeration of summaries for the requested messages.</returns>
  44556. <param name="min">The minimum index.</param>
  44557. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  44558. <param name="items">The message summary items to fetch.</param>
  44559. <param name="headers">The desired header fields.</param>
  44560. <param name="cancellationToken">The cancellation token.</param>
  44561. <exception cref="T:System.ArgumentOutOfRangeException">
  44562. <para><paramref name="min"/> is out of range.</para>
  44563. <para>-or-</para>
  44564. <para><paramref name="max"/> is out of range.</para>
  44565. </exception>
  44566. <exception cref="T:System.ArgumentNullException">
  44567. <paramref name="headers"/> is <c>null</c>.
  44568. </exception>
  44569. <exception cref="T:System.ArgumentException">
  44570. One or more of the specified <paramref name="headers"/> is invalid.
  44571. </exception>
  44572. <exception cref="T:System.ObjectDisposedException">
  44573. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44574. </exception>
  44575. <exception cref="T:MailKit.ServiceNotConnectedException">
  44576. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44577. </exception>
  44578. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44579. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44580. </exception>
  44581. <exception cref="T:MailKit.FolderNotOpenException">
  44582. The folder is not currently open.
  44583. </exception>
  44584. <exception cref="T:System.OperationCanceledException">
  44585. The operation was canceled via the cancellation token.
  44586. </exception>
  44587. <exception cref="T:System.IO.IOException">
  44588. An I/O error occurred.
  44589. </exception>
  44590. <exception cref="T:MailKit.ProtocolException">
  44591. The server's response contained unexpected tokens.
  44592. </exception>
  44593. <exception cref="T:MailKit.CommandException">
  44594. The command failed.
  44595. </exception>
  44596. </member>
  44597. <member name="M:MailKit.MailFolder.FetchAsync(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  44598. <summary>
  44599. Asynchronously fetch the message summaries for the messages between the two indexes, inclusive.
  44600. </summary>
  44601. <remarks>
  44602. <para>Asynchronously fetches the message summaries for the messages between
  44603. the two indexes, inclusive.</para>
  44604. <para>It should be noted that if another client has modified any message
  44605. in the folder, the mail service may choose to return information that was
  44606. not explicitly requested. It is therefore important to be prepared to
  44607. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44608. messages that were requested as well as summaries for messages that were
  44609. not requested at all.</para>
  44610. </remarks>
  44611. <returns>An enumeration of summaries for the requested messages.</returns>
  44612. <param name="min">The minimum index.</param>
  44613. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  44614. <param name="items">The message summary items to fetch.</param>
  44615. <param name="headers">The desired header fields.</param>
  44616. <param name="cancellationToken">The cancellation token.</param>
  44617. <exception cref="T:System.ArgumentOutOfRangeException">
  44618. <para><paramref name="min"/> is out of range.</para>
  44619. <para>-or-</para>
  44620. <para><paramref name="max"/> is out of range.</para>
  44621. </exception>
  44622. <exception cref="T:System.ArgumentNullException">
  44623. <paramref name="headers"/> is <c>null</c>.
  44624. </exception>
  44625. <exception cref="T:System.ArgumentException">
  44626. One or more of the specified <paramref name="headers"/> is invalid.
  44627. </exception>
  44628. <exception cref="T:System.ObjectDisposedException">
  44629. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44630. </exception>
  44631. <exception cref="T:MailKit.ServiceNotConnectedException">
  44632. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44633. </exception>
  44634. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44635. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44636. </exception>
  44637. <exception cref="T:MailKit.FolderNotOpenException">
  44638. The folder is not currently open.
  44639. </exception>
  44640. <exception cref="T:System.OperationCanceledException">
  44641. The operation was canceled via the cancellation token.
  44642. </exception>
  44643. <exception cref="T:System.IO.IOException">
  44644. An I/O error occurred.
  44645. </exception>
  44646. <exception cref="T:MailKit.ProtocolException">
  44647. The server's response contained unexpected tokens.
  44648. </exception>
  44649. <exception cref="T:MailKit.CommandException">
  44650. The command failed.
  44651. </exception>
  44652. </member>
  44653. <member name="M:MailKit.MailFolder.Fetch(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  44654. <summary>
  44655. Fetch the message summaries for the messages between the two indexes (inclusive)
  44656. that have a higher mod-sequence value than the one specified.
  44657. </summary>
  44658. <remarks>
  44659. <para>Fetches the message summaries for the messages between the two
  44660. indexes (inclusive) that have a higher mod-sequence value than the one
  44661. specified.</para>
  44662. <para>It should be noted that if another client has modified any message
  44663. in the folder, the mail service may choose to return information that was
  44664. not explicitly requested. It is therefore important to be prepared to
  44665. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44666. messages that were requested as well as summaries for messages that were
  44667. not requested at all.</para>
  44668. </remarks>
  44669. <returns>An enumeration of summaries for the requested messages.</returns>
  44670. <param name="min">The minimum index.</param>
  44671. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  44672. <param name="modseq">The mod-sequence value.</param>
  44673. <param name="items">The message summary items to fetch.</param>
  44674. <param name="cancellationToken">The cancellation token.</param>
  44675. <exception cref="T:System.ArgumentOutOfRangeException">
  44676. <para><paramref name="min"/> is out of range.</para>
  44677. <para>-or-</para>
  44678. <para><paramref name="max"/> is out of range.</para>
  44679. <para>-or-</para>
  44680. <para><paramref name="items"/> is empty.</para>
  44681. </exception>
  44682. <exception cref="T:System.ObjectDisposedException">
  44683. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44684. </exception>
  44685. <exception cref="T:MailKit.ServiceNotConnectedException">
  44686. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44687. </exception>
  44688. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44689. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44690. </exception>
  44691. <exception cref="T:MailKit.FolderNotOpenException">
  44692. The folder is not currently open.
  44693. </exception>
  44694. <exception cref="T:System.NotSupportedException">
  44695. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  44696. </exception>
  44697. <exception cref="T:System.OperationCanceledException">
  44698. The operation was canceled via the cancellation token.
  44699. </exception>
  44700. <exception cref="T:System.IO.IOException">
  44701. An I/O error occurred.
  44702. </exception>
  44703. <exception cref="T:MailKit.ProtocolException">
  44704. The server's response contained unexpected tokens.
  44705. </exception>
  44706. <exception cref="T:MailKit.CommandException">
  44707. The command failed.
  44708. </exception>
  44709. </member>
  44710. <member name="M:MailKit.MailFolder.FetchAsync(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Threading.CancellationToken)">
  44711. <summary>
  44712. Asynchronously fetch the message summaries for the messages between the two indexes
  44713. (inclusive) that have a higher mod-sequence value than the one specified.
  44714. </summary>
  44715. <remarks>
  44716. <para>Asynchronously fetches the message summaries for the messages between
  44717. the two indexes (inclusive) that have a higher mod-sequence value than the
  44718. one specified.</para>
  44719. <para>It should be noted that if another client has modified any message
  44720. in the folder, the mail service may choose to return information that was
  44721. not explicitly requested. It is therefore important to be prepared to
  44722. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44723. messages that were requested as well as summaries for messages that were
  44724. not requested at all.</para>
  44725. </remarks>
  44726. <returns>An enumeration of summaries for the requested messages.</returns>
  44727. <param name="min">The minimum index.</param>
  44728. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  44729. <param name="modseq">The mod-sequence value.</param>
  44730. <param name="items">The message summary items to fetch.</param>
  44731. <param name="cancellationToken">The cancellation token.</param>
  44732. <exception cref="T:System.ArgumentOutOfRangeException">
  44733. <para><paramref name="min"/> is out of range.</para>
  44734. <para>-or-</para>
  44735. <para><paramref name="max"/> is out of range.</para>
  44736. <para>-or-</para>
  44737. <para><paramref name="items"/> is empty.</para>
  44738. </exception>
  44739. <exception cref="T:System.ObjectDisposedException">
  44740. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44741. </exception>
  44742. <exception cref="T:MailKit.ServiceNotConnectedException">
  44743. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44744. </exception>
  44745. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44746. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44747. </exception>
  44748. <exception cref="T:MailKit.FolderNotOpenException">
  44749. The folder is not currently open.
  44750. </exception>
  44751. <exception cref="T:System.NotSupportedException">
  44752. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  44753. </exception>
  44754. <exception cref="T:System.OperationCanceledException">
  44755. The operation was canceled via the cancellation token.
  44756. </exception>
  44757. <exception cref="T:System.IO.IOException">
  44758. An I/O error occurred.
  44759. </exception>
  44760. <exception cref="T:MailKit.ProtocolException">
  44761. The server's response contained unexpected tokens.
  44762. </exception>
  44763. <exception cref="T:MailKit.CommandException">
  44764. The command failed.
  44765. </exception>
  44766. </member>
  44767. <member name="M:MailKit.MailFolder.Fetch(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  44768. <summary>
  44769. Fetch the message summaries for the messages between the two indexes (inclusive)
  44770. that have a higher mod-sequence value than the one specified.
  44771. </summary>
  44772. <remarks>
  44773. <para>Fetches the message summaries for the messages between the two
  44774. indexes (inclusive) that have a higher mod-sequence value than the one
  44775. specified.</para>
  44776. <para>It should be noted that if another client has modified any message
  44777. in the folder, the mail service may choose to return information that was
  44778. not explicitly requested. It is therefore important to be prepared to
  44779. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44780. messages that were requested as well as summaries for messages that were
  44781. not requested at all.</para>
  44782. </remarks>
  44783. <returns>An enumeration of summaries for the requested messages.</returns>
  44784. <param name="min">The minimum index.</param>
  44785. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  44786. <param name="modseq">The mod-sequence value.</param>
  44787. <param name="items">The message summary items to fetch.</param>
  44788. <param name="headers">The desired header fields.</param>
  44789. <param name="cancellationToken">The cancellation token.</param>
  44790. <exception cref="T:System.ArgumentOutOfRangeException">
  44791. <para><paramref name="min"/> is out of range.</para>
  44792. <para>-or-</para>
  44793. <para><paramref name="max"/> is out of range.</para>
  44794. </exception>
  44795. <exception cref="T:System.ArgumentNullException">
  44796. <paramref name="headers"/> is <c>null</c>.
  44797. </exception>
  44798. <exception cref="T:System.ObjectDisposedException">
  44799. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44800. </exception>
  44801. <exception cref="T:MailKit.ServiceNotConnectedException">
  44802. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44803. </exception>
  44804. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44805. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44806. </exception>
  44807. <exception cref="T:MailKit.FolderNotOpenException">
  44808. The folder is not currently open.
  44809. </exception>
  44810. <exception cref="T:System.NotSupportedException">
  44811. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  44812. </exception>
  44813. <exception cref="T:System.OperationCanceledException">
  44814. The operation was canceled via the cancellation token.
  44815. </exception>
  44816. <exception cref="T:System.IO.IOException">
  44817. An I/O error occurred.
  44818. </exception>
  44819. <exception cref="T:MailKit.ProtocolException">
  44820. The server's response contained unexpected tokens.
  44821. </exception>
  44822. <exception cref="T:MailKit.CommandException">
  44823. The command failed.
  44824. </exception>
  44825. </member>
  44826. <member name="M:MailKit.MailFolder.FetchAsync(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)">
  44827. <summary>
  44828. Asynchronously fetch the message summaries for the messages between the two indexes
  44829. (inclusive) that have a higher mod-sequence value than the one specified.
  44830. </summary>
  44831. <remarks>
  44832. <para>Asynchronously fetches the message summaries for the messages between
  44833. the two indexes (inclusive) that have a higher mod-sequence value than the
  44834. one specified.</para>
  44835. <para>It should be noted that if another client has modified any message
  44836. in the folder, the mail service may choose to return information that was
  44837. not explicitly requested. It is therefore important to be prepared to
  44838. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44839. messages that were requested as well as summaries for messages that were
  44840. not requested at all.</para>
  44841. </remarks>
  44842. <returns>An enumeration of summaries for the requested messages.</returns>
  44843. <param name="min">The minimum index.</param>
  44844. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  44845. <param name="modseq">The mod-sequence value.</param>
  44846. <param name="items">The message summary items to fetch.</param>
  44847. <param name="headers">The desired header fields.</param>
  44848. <param name="cancellationToken">The cancellation token.</param>
  44849. <exception cref="T:System.ArgumentOutOfRangeException">
  44850. <para><paramref name="min"/> is out of range.</para>
  44851. <para>-or-</para>
  44852. <para><paramref name="max"/> is out of range.</para>
  44853. </exception>
  44854. <exception cref="T:System.ArgumentNullException">
  44855. <paramref name="headers"/> is <c>null</c>.
  44856. </exception>
  44857. <exception cref="T:System.ObjectDisposedException">
  44858. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44859. </exception>
  44860. <exception cref="T:MailKit.ServiceNotConnectedException">
  44861. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44862. </exception>
  44863. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44864. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44865. </exception>
  44866. <exception cref="T:MailKit.FolderNotOpenException">
  44867. The folder is not currently open.
  44868. </exception>
  44869. <exception cref="T:System.NotSupportedException">
  44870. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  44871. </exception>
  44872. <exception cref="T:System.OperationCanceledException">
  44873. The operation was canceled via the cancellation token.
  44874. </exception>
  44875. <exception cref="T:System.IO.IOException">
  44876. An I/O error occurred.
  44877. </exception>
  44878. <exception cref="T:MailKit.ProtocolException">
  44879. The server's response contained unexpected tokens.
  44880. </exception>
  44881. <exception cref="T:MailKit.CommandException">
  44882. The command failed.
  44883. </exception>
  44884. </member>
  44885. <member name="M:MailKit.MailFolder.Fetch(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  44886. <summary>
  44887. Fetch the message summaries for the messages between the two indexes (inclusive)
  44888. that have a higher mod-sequence value than the one specified.
  44889. </summary>
  44890. <remarks>
  44891. <para>Fetches the message summaries for the messages between the two
  44892. indexes (inclusive) that have a higher mod-sequence value than the one
  44893. specified.</para>
  44894. <para>It should be noted that if another client has modified any message
  44895. in the folder, the mail service may choose to return information that was
  44896. not explicitly requested. It is therefore important to be prepared to
  44897. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44898. messages that were requested as well as summaries for messages that were
  44899. not requested at all.</para>
  44900. </remarks>
  44901. <returns>An enumeration of summaries for the requested messages.</returns>
  44902. <param name="min">The minimum index.</param>
  44903. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  44904. <param name="modseq">The mod-sequence value.</param>
  44905. <param name="items">The message summary items to fetch.</param>
  44906. <param name="headers">The desired header fields.</param>
  44907. <param name="cancellationToken">The cancellation token.</param>
  44908. <exception cref="T:System.ArgumentOutOfRangeException">
  44909. <para><paramref name="min"/> is out of range.</para>
  44910. <para>-or-</para>
  44911. <para><paramref name="max"/> is out of range.</para>
  44912. </exception>
  44913. <exception cref="T:System.ArgumentNullException">
  44914. <paramref name="headers"/> is <c>null</c>.
  44915. </exception>
  44916. <exception cref="T:System.ArgumentException">
  44917. One or more of the specified <paramref name="headers"/> is invalid.
  44918. </exception>
  44919. <exception cref="T:System.ObjectDisposedException">
  44920. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44921. </exception>
  44922. <exception cref="T:MailKit.ServiceNotConnectedException">
  44923. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44924. </exception>
  44925. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44926. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44927. </exception>
  44928. <exception cref="T:MailKit.FolderNotOpenException">
  44929. The folder is not currently open.
  44930. </exception>
  44931. <exception cref="T:System.NotSupportedException">
  44932. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  44933. </exception>
  44934. <exception cref="T:System.OperationCanceledException">
  44935. The operation was canceled via the cancellation token.
  44936. </exception>
  44937. <exception cref="T:System.IO.IOException">
  44938. An I/O error occurred.
  44939. </exception>
  44940. <exception cref="T:MailKit.ProtocolException">
  44941. The server's response contained unexpected tokens.
  44942. </exception>
  44943. <exception cref="T:MailKit.CommandException">
  44944. The command failed.
  44945. </exception>
  44946. </member>
  44947. <member name="M:MailKit.MailFolder.FetchAsync(System.Int32,System.Int32,System.UInt64,MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{System.String},System.Threading.CancellationToken)">
  44948. <summary>
  44949. Asynchronously fetch the message summaries for the messages between the two indexes
  44950. (inclusive) that have a higher mod-sequence value than the one specified.
  44951. </summary>
  44952. <remarks>
  44953. <para>Asynchronously fetches the message summaries for the messages between
  44954. the two indexes (inclusive) that have a higher mod-sequence value than the
  44955. one specified.</para>
  44956. <para>It should be noted that if another client has modified any message
  44957. in the folder, the mail service may choose to return information that was
  44958. not explicitly requested. It is therefore important to be prepared to
  44959. handle both additional fields on a <see cref="T:MailKit.IMessageSummary"/> for
  44960. messages that were requested as well as summaries for messages that were
  44961. not requested at all.</para>
  44962. </remarks>
  44963. <returns>An enumeration of summaries for the requested messages.</returns>
  44964. <param name="min">The minimum index.</param>
  44965. <param name="max">The maximum index, or <c>-1</c> to specify no upper bound.</param>
  44966. <param name="modseq">The mod-sequence value.</param>
  44967. <param name="items">The message summary items to fetch.</param>
  44968. <param name="headers">The desired header fields.</param>
  44969. <param name="cancellationToken">The cancellation token.</param>
  44970. <exception cref="T:System.ArgumentOutOfRangeException">
  44971. <para><paramref name="min"/> is out of range.</para>
  44972. <para>-or-</para>
  44973. <para><paramref name="max"/> is out of range.</para>
  44974. </exception>
  44975. <exception cref="T:System.ArgumentNullException">
  44976. <paramref name="headers"/> is <c>null</c>.
  44977. </exception>
  44978. <exception cref="T:System.ArgumentException">
  44979. One or more of the specified <paramref name="headers"/> is invalid.
  44980. </exception>
  44981. <exception cref="T:System.ObjectDisposedException">
  44982. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  44983. </exception>
  44984. <exception cref="T:MailKit.ServiceNotConnectedException">
  44985. The <see cref="T:MailKit.IMailStore"/> is not connected.
  44986. </exception>
  44987. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  44988. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  44989. </exception>
  44990. <exception cref="T:MailKit.FolderNotOpenException">
  44991. The folder is not currently open.
  44992. </exception>
  44993. <exception cref="T:System.NotSupportedException">
  44994. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  44995. </exception>
  44996. <exception cref="T:System.OperationCanceledException">
  44997. The operation was canceled via the cancellation token.
  44998. </exception>
  44999. <exception cref="T:System.IO.IOException">
  45000. An I/O error occurred.
  45001. </exception>
  45002. <exception cref="T:MailKit.ProtocolException">
  45003. The server's response contained unexpected tokens.
  45004. </exception>
  45005. <exception cref="T:MailKit.CommandException">
  45006. The command failed.
  45007. </exception>
  45008. </member>
  45009. <member name="M:MailKit.MailFolder.GetHeaders(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45010. <summary>
  45011. Get the specified message headers.
  45012. </summary>
  45013. <remarks>
  45014. Gets the specified message headers.
  45015. </remarks>
  45016. <returns>The message headers.</returns>
  45017. <param name="uid">The UID of the message.</param>
  45018. <param name="cancellationToken">The cancellation token.</param>
  45019. <param name="progress">The progress reporting mechanism.</param>
  45020. <exception cref="T:System.ArgumentException">
  45021. <paramref name="uid"/> is invalid.
  45022. </exception>
  45023. <exception cref="T:System.ObjectDisposedException">
  45024. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45025. </exception>
  45026. <exception cref="T:MailKit.ServiceNotConnectedException">
  45027. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45028. </exception>
  45029. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45030. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45031. </exception>
  45032. <exception cref="T:MailKit.FolderNotOpenException">
  45033. The folder is not currently open.
  45034. </exception>
  45035. <exception cref="T:MailKit.MessageNotFoundException">
  45036. The <see cref="T:MailKit.IMailStore"/> did not return the requested message headers.
  45037. </exception>
  45038. <exception cref="T:System.OperationCanceledException">
  45039. The operation was canceled via the cancellation token.
  45040. </exception>
  45041. <exception cref="T:System.IO.IOException">
  45042. An I/O error occurred.
  45043. </exception>
  45044. <exception cref="T:MailKit.ProtocolException">
  45045. The server's response contained unexpected tokens.
  45046. </exception>
  45047. <exception cref="T:MailKit.CommandException">
  45048. The command failed.
  45049. </exception>
  45050. </member>
  45051. <member name="M:MailKit.MailFolder.GetHeadersAsync(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45052. <summary>
  45053. Asynchronously get the specified message headers.
  45054. </summary>
  45055. <remarks>
  45056. Asynchronously gets the specified message headers.
  45057. </remarks>
  45058. <returns>The message headers.</returns>
  45059. <param name="uid">The UID of the message.</param>
  45060. <param name="cancellationToken">The cancellation token.</param>
  45061. <param name="progress">The progress reporting mechanism.</param>
  45062. <exception cref="T:System.ArgumentException">
  45063. <paramref name="uid"/> is invalid.
  45064. </exception>
  45065. <exception cref="T:System.ObjectDisposedException">
  45066. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45067. </exception>
  45068. <exception cref="T:MailKit.ServiceNotConnectedException">
  45069. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45070. </exception>
  45071. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45072. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45073. </exception>
  45074. <exception cref="T:MailKit.FolderNotOpenException">
  45075. The folder is not currently open.
  45076. </exception>
  45077. <exception cref="T:MailKit.MessageNotFoundException">
  45078. The <see cref="T:MailKit.IMailStore"/> did not return the requested message headers.
  45079. </exception>
  45080. <exception cref="T:System.OperationCanceledException">
  45081. The operation was canceled via the cancellation token.
  45082. </exception>
  45083. <exception cref="T:System.IO.IOException">
  45084. An I/O error occurred.
  45085. </exception>
  45086. <exception cref="T:MailKit.ProtocolException">
  45087. The server's response contained unexpected tokens.
  45088. </exception>
  45089. <exception cref="T:MailKit.CommandException">
  45090. The command failed.
  45091. </exception>
  45092. </member>
  45093. <member name="M:MailKit.MailFolder.GetHeaders(MailKit.UniqueId,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45094. <summary>
  45095. Get the specified body part headers.
  45096. </summary>
  45097. <remarks>
  45098. Gets the specified body part headers.
  45099. </remarks>
  45100. <returns>The body part headers.</returns>
  45101. <param name="uid">The UID of the message.</param>
  45102. <param name="part">The body part.</param>
  45103. <param name="cancellationToken">The cancellation token.</param>
  45104. <param name="progress">The progress reporting mechanism.</param>
  45105. <exception cref="T:System.ArgumentNullException">
  45106. <paramref name="part"/> is <c>null</c>.
  45107. </exception>
  45108. <exception cref="T:System.ArgumentException">
  45109. <paramref name="uid"/> is invalid.
  45110. </exception>
  45111. <exception cref="T:System.ObjectDisposedException">
  45112. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45113. </exception>
  45114. <exception cref="T:MailKit.ServiceNotConnectedException">
  45115. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45116. </exception>
  45117. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45118. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45119. </exception>
  45120. <exception cref="T:MailKit.FolderNotOpenException">
  45121. The folder is not currently open.
  45122. </exception>
  45123. <exception cref="T:MailKit.MessageNotFoundException">
  45124. The <see cref="T:MailKit.IMailStore"/> did not return the requested body part headers.
  45125. </exception>
  45126. <exception cref="T:System.OperationCanceledException">
  45127. The operation was canceled via the cancellation token.
  45128. </exception>
  45129. <exception cref="T:System.IO.IOException">
  45130. An I/O error occurred.
  45131. </exception>
  45132. <exception cref="T:MailKit.ProtocolException">
  45133. The server's response contained unexpected tokens.
  45134. </exception>
  45135. <exception cref="T:MailKit.CommandException">
  45136. The command failed.
  45137. </exception>
  45138. </member>
  45139. <member name="M:MailKit.MailFolder.GetHeadersAsync(MailKit.UniqueId,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45140. <summary>
  45141. Asynchronously get the specified body part headers.
  45142. </summary>
  45143. <remarks>
  45144. Asynchronously gets the specified body part headers.
  45145. </remarks>
  45146. <returns>The body part headers.</returns>
  45147. <param name="uid">The UID of the message.</param>
  45148. <param name="part">The body part.</param>
  45149. <param name="cancellationToken">The cancellation token.</param>
  45150. <param name="progress">The progress reporting mechanism.</param>
  45151. <exception cref="T:System.ArgumentNullException">
  45152. <paramref name="part"/> is <c>null</c>.
  45153. </exception>
  45154. <exception cref="T:System.ArgumentException">
  45155. <paramref name="uid"/> is invalid.
  45156. </exception>
  45157. <exception cref="T:System.ObjectDisposedException">
  45158. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45159. </exception>
  45160. <exception cref="T:MailKit.ServiceNotConnectedException">
  45161. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45162. </exception>
  45163. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45164. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45165. </exception>
  45166. <exception cref="T:MailKit.FolderNotOpenException">
  45167. The folder is not currently open.
  45168. </exception>
  45169. <exception cref="T:MailKit.MessageNotFoundException">
  45170. The <see cref="T:MailKit.IMailStore"/> did not return the requested body part headers.
  45171. </exception>
  45172. <exception cref="T:System.OperationCanceledException">
  45173. The operation was canceled via the cancellation token.
  45174. </exception>
  45175. <exception cref="T:System.IO.IOException">
  45176. An I/O error occurred.
  45177. </exception>
  45178. <exception cref="T:MailKit.ProtocolException">
  45179. The server's response contained unexpected tokens.
  45180. </exception>
  45181. <exception cref="T:MailKit.CommandException">
  45182. The command failed.
  45183. </exception>
  45184. </member>
  45185. <member name="M:MailKit.MailFolder.GetHeaders(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45186. <summary>
  45187. Get the specified message headers.
  45188. </summary>
  45189. <remarks>
  45190. Gets the specified message headers.
  45191. </remarks>
  45192. <returns>The message headers.</returns>
  45193. <param name="index">The index of the message.</param>
  45194. <param name="cancellationToken">The cancellation token.</param>
  45195. <param name="progress">The progress reporting mechanism.</param>
  45196. <exception cref="T:System.ArgumentOutOfRangeException">
  45197. <paramref name="index"/> is out of range.
  45198. </exception>
  45199. <exception cref="T:System.ObjectDisposedException">
  45200. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45201. </exception>
  45202. <exception cref="T:MailKit.ServiceNotConnectedException">
  45203. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45204. </exception>
  45205. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45206. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45207. </exception>
  45208. <exception cref="T:MailKit.FolderNotOpenException">
  45209. The folder is not currently open.
  45210. </exception>
  45211. <exception cref="T:MailKit.MessageNotFoundException">
  45212. The <see cref="T:MailKit.IMailStore"/> did not return the requested message headers.
  45213. </exception>
  45214. <exception cref="T:System.OperationCanceledException">
  45215. The operation was canceled via the cancellation token.
  45216. </exception>
  45217. <exception cref="T:System.IO.IOException">
  45218. An I/O error occurred.
  45219. </exception>
  45220. <exception cref="T:MailKit.ProtocolException">
  45221. The server's response contained unexpected tokens.
  45222. </exception>
  45223. <exception cref="T:MailKit.CommandException">
  45224. The command failed.
  45225. </exception>
  45226. </member>
  45227. <member name="M:MailKit.MailFolder.GetHeadersAsync(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45228. <summary>
  45229. Asynchronously get the specified message headers.
  45230. </summary>
  45231. <remarks>
  45232. Asynchronously gets the specified message headers.
  45233. </remarks>
  45234. <returns>The message headers.</returns>
  45235. <param name="index">The index of the message.</param>
  45236. <param name="cancellationToken">The cancellation token.</param>
  45237. <param name="progress">The progress reporting mechanism.</param>
  45238. <exception cref="T:System.ArgumentOutOfRangeException">
  45239. <paramref name="index"/> is out of range.
  45240. </exception>
  45241. <exception cref="T:System.ObjectDisposedException">
  45242. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45243. </exception>
  45244. <exception cref="T:MailKit.ServiceNotConnectedException">
  45245. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45246. </exception>
  45247. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45248. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45249. </exception>
  45250. <exception cref="T:MailKit.FolderNotOpenException">
  45251. The folder is not currently open.
  45252. </exception>
  45253. <exception cref="T:MailKit.MessageNotFoundException">
  45254. The <see cref="T:MailKit.IMailStore"/> did not return the requested message headers.
  45255. </exception>
  45256. <exception cref="T:System.OperationCanceledException">
  45257. The operation was canceled via the cancellation token.
  45258. </exception>
  45259. <exception cref="T:System.IO.IOException">
  45260. An I/O error occurred.
  45261. </exception>
  45262. <exception cref="T:MailKit.ProtocolException">
  45263. The server's response contained unexpected tokens.
  45264. </exception>
  45265. <exception cref="T:MailKit.CommandException">
  45266. The command failed.
  45267. </exception>
  45268. </member>
  45269. <member name="M:MailKit.MailFolder.GetHeaders(System.Int32,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45270. <summary>
  45271. Get the specified body part headers.
  45272. </summary>
  45273. <remarks>
  45274. Gets the specified body part headers.
  45275. </remarks>
  45276. <returns>The body part headers.</returns>
  45277. <param name="index">The index of the message.</param>
  45278. <param name="part">The body part.</param>
  45279. <param name="cancellationToken">The cancellation token.</param>
  45280. <param name="progress">The progress reporting mechanism.</param>
  45281. <exception cref="T:System.ArgumentOutOfRangeException">
  45282. <paramref name="index"/> is out of range.
  45283. </exception>
  45284. <exception cref="T:System.ArgumentNullException">
  45285. <paramref name="part"/> is <c>null</c>.
  45286. </exception>
  45287. <exception cref="T:System.ObjectDisposedException">
  45288. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45289. </exception>
  45290. <exception cref="T:MailKit.ServiceNotConnectedException">
  45291. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45292. </exception>
  45293. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45294. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45295. </exception>
  45296. <exception cref="T:MailKit.FolderNotOpenException">
  45297. The folder is not currently open.
  45298. </exception>
  45299. <exception cref="T:MailKit.MessageNotFoundException">
  45300. The <see cref="T:MailKit.IMailStore"/> did not return the requested body part headers.
  45301. </exception>
  45302. <exception cref="T:System.OperationCanceledException">
  45303. The operation was canceled via the cancellation token.
  45304. </exception>
  45305. <exception cref="T:System.IO.IOException">
  45306. An I/O error occurred.
  45307. </exception>
  45308. <exception cref="T:MailKit.ProtocolException">
  45309. The server's response contained unexpected tokens.
  45310. </exception>
  45311. <exception cref="T:MailKit.CommandException">
  45312. The command failed.
  45313. </exception>
  45314. </member>
  45315. <member name="M:MailKit.MailFolder.GetHeadersAsync(System.Int32,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45316. <summary>
  45317. Asynchronously get the specified body part headers.
  45318. </summary>
  45319. <remarks>
  45320. Asynchronously gets the specified body part headers.
  45321. </remarks>
  45322. <returns>The body part headers.</returns>
  45323. <param name="index">The index of the message.</param>
  45324. <param name="part">The body part.</param>
  45325. <param name="cancellationToken">The cancellation token.</param>
  45326. <param name="progress">The progress reporting mechanism.</param>
  45327. <exception cref="T:System.ArgumentOutOfRangeException">
  45328. <paramref name="index"/> is out of range.
  45329. </exception>
  45330. <exception cref="T:System.ArgumentNullException">
  45331. <paramref name="part"/> is <c>null</c>.
  45332. </exception>
  45333. <exception cref="T:System.ObjectDisposedException">
  45334. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45335. </exception>
  45336. <exception cref="T:MailKit.ServiceNotConnectedException">
  45337. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45338. </exception>
  45339. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45340. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45341. </exception>
  45342. <exception cref="T:MailKit.FolderNotOpenException">
  45343. The folder is not currently open.
  45344. </exception>
  45345. <exception cref="T:MailKit.MessageNotFoundException">
  45346. The <see cref="T:MailKit.IMailStore"/> did not return the requested body part headers.
  45347. </exception>
  45348. <exception cref="T:System.OperationCanceledException">
  45349. The operation was canceled via the cancellation token.
  45350. </exception>
  45351. <exception cref="T:System.IO.IOException">
  45352. An I/O error occurred.
  45353. </exception>
  45354. <exception cref="T:MailKit.ProtocolException">
  45355. The server's response contained unexpected tokens.
  45356. </exception>
  45357. <exception cref="T:MailKit.CommandException">
  45358. The command failed.
  45359. </exception>
  45360. </member>
  45361. <member name="M:MailKit.MailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45362. <summary>
  45363. Get the specified message.
  45364. </summary>
  45365. <remarks>
  45366. Gets the specified message.
  45367. </remarks>
  45368. <returns>The message.</returns>
  45369. <param name="uid">The UID of the message.</param>
  45370. <param name="cancellationToken">The cancellation token.</param>
  45371. <param name="progress">The progress reporting mechanism.</param>
  45372. <exception cref="T:System.ArgumentException">
  45373. <paramref name="uid"/> is invalid.
  45374. </exception>
  45375. <exception cref="T:System.ObjectDisposedException">
  45376. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45377. </exception>
  45378. <exception cref="T:MailKit.ServiceNotConnectedException">
  45379. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45380. </exception>
  45381. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45382. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45383. </exception>
  45384. <exception cref="T:MailKit.FolderNotOpenException">
  45385. The folder is not currently open.
  45386. </exception>
  45387. <exception cref="T:MailKit.MessageNotFoundException">
  45388. The <see cref="T:MailKit.IMailStore"/> did not return the requested message.
  45389. </exception>
  45390. <exception cref="T:System.OperationCanceledException">
  45391. The operation was canceled via the cancellation token.
  45392. </exception>
  45393. <exception cref="T:System.IO.IOException">
  45394. An I/O error occurred.
  45395. </exception>
  45396. <exception cref="T:MailKit.ProtocolException">
  45397. The server's response contained unexpected tokens.
  45398. </exception>
  45399. <exception cref="T:MailKit.CommandException">
  45400. The command failed.
  45401. </exception>
  45402. </member>
  45403. <member name="M:MailKit.MailFolder.GetMessageAsync(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45404. <summary>
  45405. Asynchronously get the specified message.
  45406. </summary>
  45407. <remarks>
  45408. Asynchronously gets the specified message.
  45409. </remarks>
  45410. <returns>The message.</returns>
  45411. <param name="uid">The UID of the message.</param>
  45412. <param name="cancellationToken">The cancellation token.</param>
  45413. <param name="progress">The progress reporting mechanism.</param>
  45414. <exception cref="T:System.ArgumentException">
  45415. <paramref name="uid"/> is invalid.
  45416. </exception>
  45417. <exception cref="T:System.ObjectDisposedException">
  45418. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45419. </exception>
  45420. <exception cref="T:MailKit.ServiceNotConnectedException">
  45421. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45422. </exception>
  45423. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45424. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45425. </exception>
  45426. <exception cref="T:MailKit.FolderNotOpenException">
  45427. The folder is not currently open.
  45428. </exception>
  45429. <exception cref="T:MailKit.MessageNotFoundException">
  45430. The <see cref="T:MailKit.IMailStore"/> did not return the requested message.
  45431. </exception>
  45432. <exception cref="T:System.OperationCanceledException">
  45433. The operation was canceled via the cancellation token.
  45434. </exception>
  45435. <exception cref="T:System.IO.IOException">
  45436. An I/O error occurred.
  45437. </exception>
  45438. <exception cref="T:MailKit.ProtocolException">
  45439. The server's response contained unexpected tokens.
  45440. </exception>
  45441. <exception cref="T:MailKit.CommandException">
  45442. The command failed.
  45443. </exception>
  45444. </member>
  45445. <member name="M:MailKit.MailFolder.GetMessage(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45446. <summary>
  45447. Get the specified message.
  45448. </summary>
  45449. <remarks>
  45450. Gets the specified message.
  45451. </remarks>
  45452. <returns>The message.</returns>
  45453. <param name="index">The index of the message.</param>
  45454. <param name="cancellationToken">The cancellation token.</param>
  45455. <param name="progress">The progress reporting mechanism.</param>
  45456. <exception cref="T:System.ArgumentOutOfRangeException">
  45457. <paramref name="index"/> is out of range.
  45458. </exception>
  45459. <exception cref="T:System.ObjectDisposedException">
  45460. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45461. </exception>
  45462. <exception cref="T:MailKit.ServiceNotConnectedException">
  45463. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45464. </exception>
  45465. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45466. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45467. </exception>
  45468. <exception cref="T:MailKit.FolderNotOpenException">
  45469. The folder is not currently open.
  45470. </exception>
  45471. <exception cref="T:MailKit.MessageNotFoundException">
  45472. The <see cref="T:MailKit.IMailStore"/> did not return the requested message.
  45473. </exception>
  45474. <exception cref="T:System.OperationCanceledException">
  45475. The operation was canceled via the cancellation token.
  45476. </exception>
  45477. <exception cref="T:System.IO.IOException">
  45478. An I/O error occurred.
  45479. </exception>
  45480. <exception cref="T:MailKit.ProtocolException">
  45481. The server's response contained unexpected tokens.
  45482. </exception>
  45483. <exception cref="T:MailKit.CommandException">
  45484. The command failed.
  45485. </exception>
  45486. </member>
  45487. <member name="M:MailKit.MailFolder.GetMessageAsync(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45488. <summary>
  45489. Asynchronously get the specified message.
  45490. </summary>
  45491. <remarks>
  45492. Asynchronously gets the specified message.
  45493. </remarks>
  45494. <returns>The message.</returns>
  45495. <param name="index">The index of the message.</param>
  45496. <param name="cancellationToken">The cancellation token.</param>
  45497. <param name="progress">The progress reporting mechanism.</param>
  45498. <exception cref="T:System.ArgumentOutOfRangeException">
  45499. <paramref name="index"/> is out of range.
  45500. </exception>
  45501. <exception cref="T:System.ObjectDisposedException">
  45502. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45503. </exception>
  45504. <exception cref="T:MailKit.ServiceNotConnectedException">
  45505. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45506. </exception>
  45507. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45508. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45509. </exception>
  45510. <exception cref="T:MailKit.FolderNotOpenException">
  45511. The folder is not currently open.
  45512. </exception>
  45513. <exception cref="T:MailKit.MessageNotFoundException">
  45514. The <see cref="T:MailKit.IMailStore"/> did not return the requested message.
  45515. </exception>
  45516. <exception cref="T:System.OperationCanceledException">
  45517. The operation was canceled via the cancellation token.
  45518. </exception>
  45519. <exception cref="T:System.IO.IOException">
  45520. An I/O error occurred.
  45521. </exception>
  45522. <exception cref="T:MailKit.ProtocolException">
  45523. The server's response contained unexpected tokens.
  45524. </exception>
  45525. <exception cref="T:MailKit.CommandException">
  45526. The command failed.
  45527. </exception>
  45528. </member>
  45529. <member name="M:MailKit.MailFolder.GetBodyPart(MailKit.UniqueId,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45530. <summary>
  45531. Get the specified body part.
  45532. </summary>
  45533. <remarks>
  45534. Gets the specified body part.
  45535. </remarks>
  45536. <example>
  45537. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  45538. </example>
  45539. <returns>The body part.</returns>
  45540. <param name="uid">The UID of the message.</param>
  45541. <param name="part">The body part.</param>
  45542. <param name="cancellationToken">The cancellation token.</param>
  45543. <param name="progress">The progress reporting mechanism.</param>
  45544. <exception cref="T:System.ArgumentNullException">
  45545. <paramref name="part"/> is <c>null</c>.
  45546. </exception>
  45547. <exception cref="T:System.ArgumentException">
  45548. <paramref name="uid"/> is invalid.
  45549. </exception>
  45550. <exception cref="T:System.ObjectDisposedException">
  45551. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45552. </exception>
  45553. <exception cref="T:MailKit.ServiceNotConnectedException">
  45554. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45555. </exception>
  45556. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45557. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45558. </exception>
  45559. <exception cref="T:MailKit.FolderNotOpenException">
  45560. The folder is not currently open.
  45561. </exception>
  45562. <exception cref="T:MailKit.MessageNotFoundException">
  45563. The <see cref="T:MailKit.IMailStore"/> did not return the requested message body.
  45564. </exception>
  45565. <exception cref="T:System.OperationCanceledException">
  45566. The operation was canceled via the cancellation token.
  45567. </exception>
  45568. <exception cref="T:System.IO.IOException">
  45569. An I/O error occurred.
  45570. </exception>
  45571. <exception cref="T:MailKit.ProtocolException">
  45572. The server's response contained unexpected tokens.
  45573. </exception>
  45574. <exception cref="T:MailKit.CommandException">
  45575. The command failed.
  45576. </exception>
  45577. </member>
  45578. <member name="M:MailKit.MailFolder.GetBodyPartAsync(MailKit.UniqueId,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45579. <summary>
  45580. Asynchronously get the specified body part.
  45581. </summary>
  45582. <remarks>
  45583. Asynchronously gets the specified body part.
  45584. </remarks>
  45585. <returns>The body part.</returns>
  45586. <param name="uid">The UID of the message.</param>
  45587. <param name="part">The body part.</param>
  45588. <param name="cancellationToken">The cancellation token.</param>
  45589. <param name="progress">The progress reporting mechanism.</param>
  45590. <exception cref="T:System.ArgumentNullException">
  45591. <paramref name="part"/> is <c>null</c>.
  45592. </exception>
  45593. <exception cref="T:System.ArgumentException">
  45594. <paramref name="uid"/> is invalid.
  45595. </exception>
  45596. <exception cref="T:System.ObjectDisposedException">
  45597. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45598. </exception>
  45599. <exception cref="T:MailKit.ServiceNotConnectedException">
  45600. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45601. </exception>
  45602. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45603. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45604. </exception>
  45605. <exception cref="T:MailKit.FolderNotOpenException">
  45606. The folder is not currently open.
  45607. </exception>
  45608. <exception cref="T:MailKit.MessageNotFoundException">
  45609. The <see cref="T:MailKit.IMailStore"/> did not return the requested message body.
  45610. </exception>
  45611. <exception cref="T:System.OperationCanceledException">
  45612. The operation was canceled via the cancellation token.
  45613. </exception>
  45614. <exception cref="T:System.IO.IOException">
  45615. An I/O error occurred.
  45616. </exception>
  45617. <exception cref="T:MailKit.ProtocolException">
  45618. The server's response contained unexpected tokens.
  45619. </exception>
  45620. <exception cref="T:MailKit.CommandException">
  45621. The command failed.
  45622. </exception>
  45623. </member>
  45624. <member name="M:MailKit.MailFolder.GetBodyPart(System.Int32,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45625. <summary>
  45626. Get the specified body part.
  45627. </summary>
  45628. <remarks>
  45629. Gets the specified body part.
  45630. </remarks>
  45631. <returns>The body part.</returns>
  45632. <param name="index">The index of the message.</param>
  45633. <param name="part">The body part.</param>
  45634. <param name="cancellationToken">The cancellation token.</param>
  45635. <param name="progress">The progress reporting mechanism.</param>
  45636. <exception cref="T:System.ArgumentNullException">
  45637. <paramref name="part"/> is <c>null</c>.
  45638. </exception>
  45639. <exception cref="T:System.ArgumentOutOfRangeException">
  45640. <paramref name="index"/> is out of range.
  45641. </exception>
  45642. <exception cref="T:System.ObjectDisposedException">
  45643. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45644. </exception>
  45645. <exception cref="T:MailKit.ServiceNotConnectedException">
  45646. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45647. </exception>
  45648. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45649. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45650. </exception>
  45651. <exception cref="T:MailKit.FolderNotOpenException">
  45652. The folder is not currently open.
  45653. </exception>
  45654. <exception cref="T:MailKit.MessageNotFoundException">
  45655. The <see cref="T:MailKit.IMailStore"/> did not return the requested message body.
  45656. </exception>
  45657. <exception cref="T:System.OperationCanceledException">
  45658. The operation was canceled via the cancellation token.
  45659. </exception>
  45660. <exception cref="T:System.IO.IOException">
  45661. An I/O error occurred.
  45662. </exception>
  45663. <exception cref="T:MailKit.ProtocolException">
  45664. The server's response contained unexpected tokens.
  45665. </exception>
  45666. <exception cref="T:MailKit.CommandException">
  45667. The command failed.
  45668. </exception>
  45669. </member>
  45670. <member name="M:MailKit.MailFolder.GetBodyPartAsync(System.Int32,MailKit.BodyPart,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45671. <summary>
  45672. Asynchronously get the specified body part.
  45673. </summary>
  45674. <remarks>
  45675. Asynchronously gets the specified body part.
  45676. </remarks>
  45677. <returns>The body part.</returns>
  45678. <param name="index">The index of the message.</param>
  45679. <param name="part">The body part.</param>
  45680. <param name="cancellationToken">The cancellation token.</param>
  45681. <param name="progress">The progress reporting mechanism.</param>
  45682. <exception cref="T:System.ArgumentNullException">
  45683. <paramref name="part"/> is <c>null</c>.
  45684. </exception>
  45685. <exception cref="T:System.ArgumentOutOfRangeException">
  45686. <paramref name="index"/> is out of range.
  45687. </exception>
  45688. <exception cref="T:System.ObjectDisposedException">
  45689. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45690. </exception>
  45691. <exception cref="T:MailKit.ServiceNotConnectedException">
  45692. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45693. </exception>
  45694. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45695. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45696. </exception>
  45697. <exception cref="T:MailKit.FolderNotOpenException">
  45698. The folder is not currently open.
  45699. </exception>
  45700. <exception cref="T:MailKit.MessageNotFoundException">
  45701. The <see cref="T:MailKit.IMailStore"/> did not return the requested message body.
  45702. </exception>
  45703. <exception cref="T:System.OperationCanceledException">
  45704. The operation was canceled via the cancellation token.
  45705. </exception>
  45706. <exception cref="T:System.IO.IOException">
  45707. An I/O error occurred.
  45708. </exception>
  45709. <exception cref="T:MailKit.ProtocolException">
  45710. The server's response contained unexpected tokens.
  45711. </exception>
  45712. <exception cref="T:MailKit.CommandException">
  45713. The command failed.
  45714. </exception>
  45715. </member>
  45716. <member name="M:MailKit.MailFolder.GetStream(MailKit.UniqueId,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45717. <summary>
  45718. Get a substream of the specified message.
  45719. </summary>
  45720. <remarks>
  45721. Gets a substream of the message. If the starting offset is beyond
  45722. the end of the message, an empty stream is returned. If the number of
  45723. bytes desired extends beyond the end of the message, a truncated stream
  45724. will be returned.
  45725. </remarks>
  45726. <returns>The stream.</returns>
  45727. <param name="uid">The UID of the message.</param>
  45728. <param name="offset">The starting offset of the first desired byte.</param>
  45729. <param name="count">The number of bytes desired.</param>
  45730. <param name="cancellationToken">The cancellation token.</param>
  45731. <param name="progress">The progress reporting mechanism.</param>
  45732. <exception cref="T:System.ArgumentException">
  45733. <paramref name="uid"/> is invalid.
  45734. </exception>
  45735. <exception cref="T:System.ArgumentOutOfRangeException">
  45736. <para><paramref name="offset"/> is negative.</para>
  45737. <para>-or-</para>
  45738. <para><paramref name="count"/> is negative.</para>
  45739. </exception>
  45740. <exception cref="T:System.ObjectDisposedException">
  45741. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45742. </exception>
  45743. <exception cref="T:MailKit.ServiceNotConnectedException">
  45744. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45745. </exception>
  45746. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45747. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45748. </exception>
  45749. <exception cref="T:MailKit.FolderNotOpenException">
  45750. The folder is not currently open.
  45751. </exception>
  45752. <exception cref="T:MailKit.MessageNotFoundException">
  45753. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  45754. </exception>
  45755. <exception cref="T:System.OperationCanceledException">
  45756. The operation was canceled via the cancellation token.
  45757. </exception>
  45758. <exception cref="T:System.IO.IOException">
  45759. An I/O error occurred.
  45760. </exception>
  45761. <exception cref="T:MailKit.ProtocolException">
  45762. The server's response contained unexpected tokens.
  45763. </exception>
  45764. <exception cref="T:MailKit.CommandException">
  45765. The command failed.
  45766. </exception>
  45767. </member>
  45768. <member name="M:MailKit.MailFolder.GetStreamAsync(MailKit.UniqueId,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45769. <summary>
  45770. Asynchronously get a substream of the specified message.
  45771. </summary>
  45772. <remarks>
  45773. Asynchronously gets a substream of the message. If the starting offset is beyond
  45774. the end of the message, an empty stream is returned. If the number of
  45775. bytes desired extends beyond the end of the message, a truncated stream
  45776. will be returned.
  45777. </remarks>
  45778. <returns>The stream.</returns>
  45779. <param name="uid">The UID of the message.</param>
  45780. <param name="offset">The starting offset of the first desired byte.</param>
  45781. <param name="count">The number of bytes desired.</param>
  45782. <param name="cancellationToken">The cancellation token.</param>
  45783. <param name="progress">The progress reporting mechanism.</param>
  45784. <exception cref="T:System.ArgumentException">
  45785. <paramref name="uid"/> is invalid.
  45786. </exception>
  45787. <exception cref="T:System.ArgumentOutOfRangeException">
  45788. <para><paramref name="offset"/> is negative.</para>
  45789. <para>-or-</para>
  45790. <para><paramref name="count"/> is negative.</para>
  45791. </exception>
  45792. <exception cref="T:System.ObjectDisposedException">
  45793. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45794. </exception>
  45795. <exception cref="T:MailKit.ServiceNotConnectedException">
  45796. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45797. </exception>
  45798. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45799. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45800. </exception>
  45801. <exception cref="T:MailKit.FolderNotOpenException">
  45802. The folder is not currently open.
  45803. </exception>
  45804. <exception cref="T:MailKit.MessageNotFoundException">
  45805. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  45806. </exception>
  45807. <exception cref="T:System.OperationCanceledException">
  45808. The operation was canceled via the cancellation token.
  45809. </exception>
  45810. <exception cref="T:System.IO.IOException">
  45811. An I/O error occurred.
  45812. </exception>
  45813. <exception cref="T:MailKit.ProtocolException">
  45814. The server's response contained unexpected tokens.
  45815. </exception>
  45816. <exception cref="T:MailKit.CommandException">
  45817. The command failed.
  45818. </exception>
  45819. </member>
  45820. <member name="M:MailKit.MailFolder.GetStream(System.Int32,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45821. <summary>
  45822. Get a substream of the specified message.
  45823. </summary>
  45824. <remarks>
  45825. Gets a substream of the message. If the starting offset is beyond
  45826. the end of the message, an empty stream is returned. If the number of
  45827. bytes desired extends beyond the end of the message, a truncated stream
  45828. will be returned.
  45829. </remarks>
  45830. <returns>The stream.</returns>
  45831. <param name="index">The index of the message.</param>
  45832. <param name="offset">The starting offset of the first desired byte.</param>
  45833. <param name="count">The number of bytes desired.</param>
  45834. <param name="cancellationToken">The cancellation token.</param>
  45835. <param name="progress">The progress reporting mechanism.</param>
  45836. <exception cref="T:System.ArgumentOutOfRangeException">
  45837. <para><paramref name="index"/> is out of range.</para>
  45838. <para>-or-</para>
  45839. <para><paramref name="offset"/> is negative.</para>
  45840. <para>-or-</para>
  45841. <para><paramref name="count"/> is negative.</para>
  45842. </exception>
  45843. <exception cref="T:System.ObjectDisposedException">
  45844. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45845. </exception>
  45846. <exception cref="T:MailKit.ServiceNotConnectedException">
  45847. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45848. </exception>
  45849. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45850. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45851. </exception>
  45852. <exception cref="T:MailKit.FolderNotOpenException">
  45853. The folder is not currently open.
  45854. </exception>
  45855. <exception cref="T:MailKit.MessageNotFoundException">
  45856. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  45857. </exception>
  45858. <exception cref="T:System.OperationCanceledException">
  45859. The operation was canceled via the cancellation token.
  45860. </exception>
  45861. <exception cref="T:System.IO.IOException">
  45862. An I/O error occurred.
  45863. </exception>
  45864. <exception cref="T:MailKit.ProtocolException">
  45865. The server's response contained unexpected tokens.
  45866. </exception>
  45867. <exception cref="T:MailKit.CommandException">
  45868. The command failed.
  45869. </exception>
  45870. </member>
  45871. <member name="M:MailKit.MailFolder.GetStreamAsync(System.Int32,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45872. <summary>
  45873. Asynchronously get a substream of the specified message.
  45874. </summary>
  45875. <remarks>
  45876. Asynchronously gets a substream of the message. If the starting offset is beyond
  45877. the end of the message, an empty stream is returned. If the number of
  45878. bytes desired extends beyond the end of the message, a truncated stream
  45879. will be returned.
  45880. </remarks>
  45881. <returns>The stream.</returns>
  45882. <param name="index">The index of the message.</param>
  45883. <param name="offset">The starting offset of the first desired byte.</param>
  45884. <param name="count">The number of bytes desired.</param>
  45885. <param name="cancellationToken">The cancellation token.</param>
  45886. <param name="progress">The progress reporting mechanism.</param>
  45887. <exception cref="T:System.ArgumentOutOfRangeException">
  45888. <para><paramref name="index"/> is out of range.</para>
  45889. <para>-or-</para>
  45890. <para><paramref name="offset"/> is negative.</para>
  45891. <para>-or-</para>
  45892. <para><paramref name="count"/> is negative.</para>
  45893. </exception>
  45894. <exception cref="T:System.ObjectDisposedException">
  45895. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45896. </exception>
  45897. <exception cref="T:MailKit.ServiceNotConnectedException">
  45898. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45899. </exception>
  45900. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45901. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45902. </exception>
  45903. <exception cref="T:MailKit.FolderNotOpenException">
  45904. The folder is not currently open.
  45905. </exception>
  45906. <exception cref="T:MailKit.MessageNotFoundException">
  45907. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  45908. </exception>
  45909. <exception cref="T:System.OperationCanceledException">
  45910. The operation was canceled via the cancellation token.
  45911. </exception>
  45912. <exception cref="T:System.IO.IOException">
  45913. An I/O error occurred.
  45914. </exception>
  45915. <exception cref="T:MailKit.ProtocolException">
  45916. The server's response contained unexpected tokens.
  45917. </exception>
  45918. <exception cref="T:MailKit.CommandException">
  45919. The command failed.
  45920. </exception>
  45921. </member>
  45922. <member name="M:MailKit.MailFolder.GetStream(MailKit.UniqueId,MailKit.BodyPart,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45923. <summary>
  45924. Get a substream of the specified body part.
  45925. </summary>
  45926. <remarks>
  45927. Gets a substream of the body part. If the starting offset is beyond
  45928. the end of the body part, an empty stream is returned. If the number of
  45929. bytes desired extends beyond the end of the body part, a truncated stream
  45930. will be returned.
  45931. </remarks>
  45932. <returns>The stream.</returns>
  45933. <param name="uid">The UID of the message.</param>
  45934. <param name="part">The desired body part.</param>
  45935. <param name="offset">The starting offset of the first desired byte.</param>
  45936. <param name="count">The number of bytes desired.</param>
  45937. <param name="cancellationToken">The cancellation token.</param>
  45938. <param name="progress">The progress reporting mechanism.</param>
  45939. <exception cref="T:System.ArgumentException">
  45940. <paramref name="uid"/> is invalid.
  45941. </exception>
  45942. <exception cref="T:System.ArgumentNullException">
  45943. <paramref name="part"/> is <c>null</c>.
  45944. </exception>
  45945. <exception cref="T:System.ArgumentOutOfRangeException">
  45946. <para><paramref name="offset"/> is negative.</para>
  45947. <para>-or-</para>
  45948. <para><paramref name="count"/> is negative.</para>
  45949. </exception>
  45950. <exception cref="T:System.ObjectDisposedException">
  45951. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  45952. </exception>
  45953. <exception cref="T:MailKit.ServiceNotConnectedException">
  45954. The <see cref="T:MailKit.IMailStore"/> is not connected.
  45955. </exception>
  45956. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  45957. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  45958. </exception>
  45959. <exception cref="T:MailKit.FolderNotOpenException">
  45960. The folder is not currently open.
  45961. </exception>
  45962. <exception cref="T:MailKit.MessageNotFoundException">
  45963. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  45964. </exception>
  45965. <exception cref="T:System.OperationCanceledException">
  45966. The operation was canceled via the cancellation token.
  45967. </exception>
  45968. <exception cref="T:System.IO.IOException">
  45969. An I/O error occurred.
  45970. </exception>
  45971. <exception cref="T:MailKit.ProtocolException">
  45972. The server's response contained unexpected tokens.
  45973. </exception>
  45974. <exception cref="T:MailKit.CommandException">
  45975. The command failed.
  45976. </exception>
  45977. </member>
  45978. <member name="M:MailKit.MailFolder.GetStreamAsync(MailKit.UniqueId,MailKit.BodyPart,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  45979. <summary>
  45980. Asynchronously get a substream of the specified body part.
  45981. </summary>
  45982. <remarks>
  45983. Asynchronously gets a substream of the body part. If the starting offset is beyond
  45984. the end of the body part, an empty stream is returned. If the number of
  45985. bytes desired extends beyond the end of the body part, a truncated stream
  45986. will be returned.
  45987. </remarks>
  45988. <returns>The stream.</returns>
  45989. <param name="uid">The UID of the message.</param>
  45990. <param name="part">The desired body part.</param>
  45991. <param name="offset">The starting offset of the first desired byte.</param>
  45992. <param name="count">The number of bytes desired.</param>
  45993. <param name="cancellationToken">The cancellation token.</param>
  45994. <param name="progress">The progress reporting mechanism.</param>
  45995. <exception cref="T:System.ArgumentException">
  45996. <paramref name="uid"/> is invalid.
  45997. </exception>
  45998. <exception cref="T:System.ArgumentNullException">
  45999. <paramref name="part"/> is <c>null</c>.
  46000. </exception>
  46001. <exception cref="T:System.ArgumentOutOfRangeException">
  46002. <para><paramref name="offset"/> is negative.</para>
  46003. <para>-or-</para>
  46004. <para><paramref name="count"/> is negative.</para>
  46005. </exception>
  46006. <exception cref="T:System.ObjectDisposedException">
  46007. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46008. </exception>
  46009. <exception cref="T:MailKit.ServiceNotConnectedException">
  46010. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46011. </exception>
  46012. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46013. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46014. </exception>
  46015. <exception cref="T:MailKit.FolderNotOpenException">
  46016. The folder is not currently open.
  46017. </exception>
  46018. <exception cref="T:MailKit.MessageNotFoundException">
  46019. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  46020. </exception>
  46021. <exception cref="T:System.OperationCanceledException">
  46022. The operation was canceled via the cancellation token.
  46023. </exception>
  46024. <exception cref="T:System.IO.IOException">
  46025. An I/O error occurred.
  46026. </exception>
  46027. <exception cref="T:MailKit.ProtocolException">
  46028. The server's response contained unexpected tokens.
  46029. </exception>
  46030. <exception cref="T:MailKit.CommandException">
  46031. The command failed.
  46032. </exception>
  46033. </member>
  46034. <member name="M:MailKit.MailFolder.GetStream(System.Int32,MailKit.BodyPart,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  46035. <summary>
  46036. Get a substream of the specified body part.
  46037. </summary>
  46038. <remarks>
  46039. Gets a substream of the body part. If the starting offset is beyond
  46040. the end of the body part, an empty stream is returned. If the number of
  46041. bytes desired extends beyond the end of the body part, a truncated stream
  46042. will be returned.
  46043. </remarks>
  46044. <returns>The stream.</returns>
  46045. <param name="index">The index of the message.</param>
  46046. <param name="part">The desired body part.</param>
  46047. <param name="offset">The starting offset of the first desired byte.</param>
  46048. <param name="count">The number of bytes desired.</param>
  46049. <param name="cancellationToken">The cancellation token.</param>
  46050. <param name="progress">The progress reporting mechanism.</param>
  46051. <exception cref="T:System.ArgumentNullException">
  46052. <paramref name="part"/> is <c>null</c>.
  46053. </exception>
  46054. <exception cref="T:System.ArgumentOutOfRangeException">
  46055. <para><paramref name="index"/> is out of range.</para>
  46056. <para>-or-</para>
  46057. <para><paramref name="offset"/> is negative.</para>
  46058. <para>-or-</para>
  46059. <para><paramref name="count"/> is negative.</para>
  46060. </exception>
  46061. <exception cref="T:System.ObjectDisposedException">
  46062. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46063. </exception>
  46064. <exception cref="T:MailKit.ServiceNotConnectedException">
  46065. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46066. </exception>
  46067. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46068. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46069. </exception>
  46070. <exception cref="T:MailKit.FolderNotOpenException">
  46071. The folder is not currently open.
  46072. </exception>
  46073. <exception cref="T:MailKit.MessageNotFoundException">
  46074. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  46075. </exception>
  46076. <exception cref="T:System.OperationCanceledException">
  46077. The operation was canceled via the cancellation token.
  46078. </exception>
  46079. <exception cref="T:System.IO.IOException">
  46080. An I/O error occurred.
  46081. </exception>
  46082. <exception cref="T:MailKit.ProtocolException">
  46083. The server's response contained unexpected tokens.
  46084. </exception>
  46085. <exception cref="T:MailKit.CommandException">
  46086. The command failed.
  46087. </exception>
  46088. </member>
  46089. <member name="M:MailKit.MailFolder.GetStreamAsync(System.Int32,MailKit.BodyPart,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  46090. <summary>
  46091. Asynchronously get a substream of the specified body part.
  46092. </summary>
  46093. <remarks>
  46094. Asynchronously gets a substream of the body part. If the starting offset is beyond
  46095. the end of the body part, an empty stream is returned. If the number of
  46096. bytes desired extends beyond the end of the body part, a truncated stream
  46097. will be returned.
  46098. </remarks>
  46099. <returns>The stream.</returns>
  46100. <param name="index">The index of the message.</param>
  46101. <param name="part">The desired body part.</param>
  46102. <param name="offset">The starting offset of the first desired byte.</param>
  46103. <param name="count">The number of bytes desired.</param>
  46104. <param name="cancellationToken">The cancellation token.</param>
  46105. <param name="progress">The progress reporting mechanism.</param>
  46106. <exception cref="T:System.ArgumentNullException">
  46107. <paramref name="part"/> is <c>null</c>.
  46108. </exception>
  46109. <exception cref="T:System.ArgumentOutOfRangeException">
  46110. <para><paramref name="index"/> is out of range.</para>
  46111. <para>-or-</para>
  46112. <para><paramref name="offset"/> is negative.</para>
  46113. <para>-or-</para>
  46114. <para><paramref name="count"/> is negative.</para>
  46115. </exception>
  46116. <exception cref="T:System.ObjectDisposedException">
  46117. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46118. </exception>
  46119. <exception cref="T:MailKit.ServiceNotConnectedException">
  46120. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46121. </exception>
  46122. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46123. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46124. </exception>
  46125. <exception cref="T:MailKit.FolderNotOpenException">
  46126. The folder is not currently open.
  46127. </exception>
  46128. <exception cref="T:MailKit.MessageNotFoundException">
  46129. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  46130. </exception>
  46131. <exception cref="T:System.OperationCanceledException">
  46132. The operation was canceled via the cancellation token.
  46133. </exception>
  46134. <exception cref="T:System.IO.IOException">
  46135. An I/O error occurred.
  46136. </exception>
  46137. <exception cref="T:MailKit.ProtocolException">
  46138. The server's response contained unexpected tokens.
  46139. </exception>
  46140. <exception cref="T:MailKit.CommandException">
  46141. The command failed.
  46142. </exception>
  46143. </member>
  46144. <member name="M:MailKit.MailFolder.GetStream(MailKit.UniqueId,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  46145. <summary>
  46146. Get a substream of the specified message.
  46147. </summary>
  46148. <remarks>
  46149. <para>Gets a substream of the specified message.</para>
  46150. <para>For more information about how to construct the <paramref name="section"/>,
  46151. see Section 6.4.5 of RFC3501.</para>
  46152. </remarks>
  46153. <returns>The stream.</returns>
  46154. <param name="uid">The UID of the message.</param>
  46155. <param name="section">The desired section of the message.</param>
  46156. <param name="cancellationToken">The cancellation token.</param>
  46157. <param name="progress">The progress reporting mechanism.</param>
  46158. <exception cref="T:System.ArgumentException">
  46159. <paramref name="uid"/> is invalid.
  46160. </exception>
  46161. <exception cref="T:System.ArgumentNullException">
  46162. <paramref name="section"/> is <c>null</c>.
  46163. </exception>
  46164. <exception cref="T:System.ObjectDisposedException">
  46165. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46166. </exception>
  46167. <exception cref="T:MailKit.ServiceNotConnectedException">
  46168. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46169. </exception>
  46170. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46171. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46172. </exception>
  46173. <exception cref="T:MailKit.FolderNotOpenException">
  46174. The folder is not currently open.
  46175. </exception>
  46176. <exception cref="T:MailKit.MessageNotFoundException">
  46177. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  46178. </exception>
  46179. <exception cref="T:System.OperationCanceledException">
  46180. The operation was canceled via the cancellation token.
  46181. </exception>
  46182. <exception cref="T:System.IO.IOException">
  46183. An I/O error occurred.
  46184. </exception>
  46185. <exception cref="T:MailKit.ProtocolException">
  46186. The server's response contained unexpected tokens.
  46187. </exception>
  46188. <exception cref="T:MailKit.CommandException">
  46189. The command failed.
  46190. </exception>
  46191. </member>
  46192. <member name="M:MailKit.MailFolder.GetStreamAsync(MailKit.UniqueId,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  46193. <summary>
  46194. Asynchronously get a substream of the specified message.
  46195. </summary>
  46196. <remarks>
  46197. <para>Asynchronously gets a substream of the specified message.</para>
  46198. <para>For more information about how to construct the <paramref name="section"/>,
  46199. see Section 6.4.5 of RFC3501.</para>
  46200. </remarks>
  46201. <returns>The stream.</returns>
  46202. <param name="uid">The UID of the message.</param>
  46203. <param name="section">The desired section of the message.</param>
  46204. <param name="cancellationToken">The cancellation token.</param>
  46205. <param name="progress">The progress reporting mechanism.</param>
  46206. <exception cref="T:System.ArgumentException">
  46207. <paramref name="uid"/> is invalid.
  46208. </exception>
  46209. <exception cref="T:System.ArgumentNullException">
  46210. <paramref name="section"/> is <c>null</c>.
  46211. </exception>
  46212. <exception cref="T:System.ObjectDisposedException">
  46213. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46214. </exception>
  46215. <exception cref="T:MailKit.ServiceNotConnectedException">
  46216. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46217. </exception>
  46218. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46219. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46220. </exception>
  46221. <exception cref="T:MailKit.FolderNotOpenException">
  46222. The folder is not currently open.
  46223. </exception>
  46224. <exception cref="T:MailKit.MessageNotFoundException">
  46225. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  46226. </exception>
  46227. <exception cref="T:System.OperationCanceledException">
  46228. The operation was canceled via the cancellation token.
  46229. </exception>
  46230. <exception cref="T:System.IO.IOException">
  46231. An I/O error occurred.
  46232. </exception>
  46233. <exception cref="T:MailKit.ProtocolException">
  46234. The server's response contained unexpected tokens.
  46235. </exception>
  46236. <exception cref="T:MailKit.CommandException">
  46237. The command failed.
  46238. </exception>
  46239. </member>
  46240. <member name="M:MailKit.MailFolder.GetStream(MailKit.UniqueId,System.String,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  46241. <summary>
  46242. Get a substream of the specified message.
  46243. </summary>
  46244. <remarks>
  46245. <para>Gets a substream of the specified message. If the starting offset is beyond
  46246. the end of the specified section of the message, an empty stream is returned. If
  46247. the number of bytes desired extends beyond the end of the section, a truncated
  46248. stream will be returned.</para>
  46249. <para>For more information about how to construct the <paramref name="section"/>,
  46250. see Section 6.4.5 of RFC3501.</para>
  46251. </remarks>
  46252. <returns>The stream.</returns>
  46253. <param name="uid">The UID of the message.</param>
  46254. <param name="section">The desired section of the message.</param>
  46255. <param name="offset">The starting offset of the first desired byte.</param>
  46256. <param name="count">The number of bytes desired.</param>
  46257. <param name="cancellationToken">The cancellation token.</param>
  46258. <param name="progress">The progress reporting mechanism.</param>
  46259. <exception cref="T:System.ArgumentException">
  46260. <paramref name="uid"/> is invalid.
  46261. </exception>
  46262. <exception cref="T:System.ArgumentNullException">
  46263. <paramref name="section"/> is <c>null</c>.
  46264. </exception>
  46265. <exception cref="T:System.ArgumentOutOfRangeException">
  46266. <para><paramref name="offset"/> is negative.</para>
  46267. <para>-or-</para>
  46268. <para><paramref name="count"/> is negative.</para>
  46269. </exception>
  46270. <exception cref="T:System.ObjectDisposedException">
  46271. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46272. </exception>
  46273. <exception cref="T:MailKit.ServiceNotConnectedException">
  46274. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46275. </exception>
  46276. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46277. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46278. </exception>
  46279. <exception cref="T:MailKit.FolderNotOpenException">
  46280. The folder is not currently open.
  46281. </exception>
  46282. <exception cref="T:MailKit.MessageNotFoundException">
  46283. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  46284. </exception>
  46285. <exception cref="T:System.OperationCanceledException">
  46286. The operation was canceled via the cancellation token.
  46287. </exception>
  46288. <exception cref="T:System.IO.IOException">
  46289. An I/O error occurred.
  46290. </exception>
  46291. <exception cref="T:MailKit.ProtocolException">
  46292. The server's response contained unexpected tokens.
  46293. </exception>
  46294. <exception cref="T:MailKit.CommandException">
  46295. The command failed.
  46296. </exception>
  46297. </member>
  46298. <member name="M:MailKit.MailFolder.GetStreamAsync(MailKit.UniqueId,System.String,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  46299. <summary>
  46300. Asynchronously get a substream of the specified message.
  46301. </summary>
  46302. <remarks>
  46303. <para>Asynchronously gets a substream of the specified message. If the starting
  46304. offset is beyond the end of the specified section of the message, an empty stream
  46305. is returned. If the number of bytes desired extends beyond the end of the section,
  46306. a truncated stream will be returned.</para>
  46307. <para>For more information about how to construct the <paramref name="section"/>,
  46308. see Section 6.4.5 of RFC3501.</para>
  46309. </remarks>
  46310. <returns>The stream.</returns>
  46311. <param name="uid">The UID of the message.</param>
  46312. <param name="section">The desired section of the message.</param>
  46313. <param name="offset">The starting offset of the first desired byte.</param>
  46314. <param name="count">The number of bytes desired.</param>
  46315. <param name="cancellationToken">The cancellation token.</param>
  46316. <param name="progress">The progress reporting mechanism.</param>
  46317. <exception cref="T:System.ArgumentException">
  46318. <paramref name="uid"/> is invalid.
  46319. </exception>
  46320. <exception cref="T:System.ArgumentNullException">
  46321. <paramref name="section"/> is <c>null</c>.
  46322. </exception>
  46323. <exception cref="T:System.ArgumentOutOfRangeException">
  46324. <para><paramref name="offset"/> is negative.</para>
  46325. <para>-or-</para>
  46326. <para><paramref name="count"/> is negative.</para>
  46327. </exception>
  46328. <exception cref="T:System.ObjectDisposedException">
  46329. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46330. </exception>
  46331. <exception cref="T:MailKit.ServiceNotConnectedException">
  46332. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46333. </exception>
  46334. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46335. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46336. </exception>
  46337. <exception cref="T:MailKit.FolderNotOpenException">
  46338. The folder is not currently open.
  46339. </exception>
  46340. <exception cref="T:MailKit.MessageNotFoundException">
  46341. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  46342. </exception>
  46343. <exception cref="T:System.OperationCanceledException">
  46344. The operation was canceled via the cancellation token.
  46345. </exception>
  46346. <exception cref="T:System.IO.IOException">
  46347. An I/O error occurred.
  46348. </exception>
  46349. <exception cref="T:MailKit.ProtocolException">
  46350. The server's response contained unexpected tokens.
  46351. </exception>
  46352. <exception cref="T:MailKit.CommandException">
  46353. The command failed.
  46354. </exception>
  46355. </member>
  46356. <member name="M:MailKit.MailFolder.GetStream(System.Int32,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  46357. <summary>
  46358. Get a substream of the specified message.
  46359. </summary>
  46360. <remarks>
  46361. <para>Gets a substream of the specified message.</para>
  46362. <para>For more information about how to construct the <paramref name="section"/>,
  46363. see Section 6.4.5 of RFC3501.</para>
  46364. </remarks>
  46365. <returns>The stream.</returns>
  46366. <param name="index">The index of the message.</param>
  46367. <param name="section">The desired section of the message.</param>
  46368. <param name="cancellationToken">The cancellation token.</param>
  46369. <param name="progress">The progress reporting mechanism.</param>
  46370. <exception cref="T:System.ArgumentNullException">
  46371. <paramref name="section"/> is <c>null</c>.
  46372. </exception>
  46373. <exception cref="T:System.ArgumentOutOfRangeException">
  46374. <paramref name="index"/> is out of range.
  46375. </exception>
  46376. <exception cref="T:System.ObjectDisposedException">
  46377. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46378. </exception>
  46379. <exception cref="T:MailKit.ServiceNotConnectedException">
  46380. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46381. </exception>
  46382. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46383. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46384. </exception>
  46385. <exception cref="T:MailKit.FolderNotOpenException">
  46386. The folder is not currently open.
  46387. </exception>
  46388. <exception cref="T:MailKit.MessageNotFoundException">
  46389. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  46390. </exception>
  46391. <exception cref="T:System.OperationCanceledException">
  46392. The operation was canceled via the cancellation token.
  46393. </exception>
  46394. <exception cref="T:System.IO.IOException">
  46395. An I/O error occurred.
  46396. </exception>
  46397. <exception cref="T:MailKit.ProtocolException">
  46398. The server's response contained unexpected tokens.
  46399. </exception>
  46400. <exception cref="T:MailKit.CommandException">
  46401. The command failed.
  46402. </exception>
  46403. </member>
  46404. <member name="M:MailKit.MailFolder.GetStreamAsync(System.Int32,System.String,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  46405. <summary>
  46406. Asynchronously get a substream of the specified body part.
  46407. </summary>
  46408. <remarks>
  46409. <para>Asynchronously gets a substream of the specified message.</para>
  46410. <para>For more information about how to construct the <paramref name="section"/>,
  46411. see Section 6.4.5 of RFC3501.</para>
  46412. </remarks>
  46413. <returns>The stream.</returns>
  46414. <param name="index">The index of the message.</param>
  46415. <param name="section">The desired section of the message.</param>
  46416. <param name="cancellationToken">The cancellation token.</param>
  46417. <param name="progress">The progress reporting mechanism.</param>
  46418. <exception cref="T:System.ArgumentNullException">
  46419. <paramref name="section"/> is <c>null</c>.
  46420. </exception>
  46421. <exception cref="T:System.ArgumentOutOfRangeException">
  46422. <paramref name="index"/> is out of range.
  46423. </exception>
  46424. <exception cref="T:System.ObjectDisposedException">
  46425. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46426. </exception>
  46427. <exception cref="T:MailKit.ServiceNotConnectedException">
  46428. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46429. </exception>
  46430. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46431. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46432. </exception>
  46433. <exception cref="T:MailKit.FolderNotOpenException">
  46434. The folder is not currently open.
  46435. </exception>
  46436. <exception cref="T:MailKit.MessageNotFoundException">
  46437. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  46438. </exception>
  46439. <exception cref="T:System.OperationCanceledException">
  46440. The operation was canceled via the cancellation token.
  46441. </exception>
  46442. <exception cref="T:System.IO.IOException">
  46443. An I/O error occurred.
  46444. </exception>
  46445. <exception cref="T:MailKit.ProtocolException">
  46446. The server's response contained unexpected tokens.
  46447. </exception>
  46448. <exception cref="T:MailKit.CommandException">
  46449. The command failed.
  46450. </exception>
  46451. </member>
  46452. <member name="M:MailKit.MailFolder.GetStream(System.Int32,System.String,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  46453. <summary>
  46454. Get a substream of the specified message.
  46455. </summary>
  46456. <remarks>
  46457. <para>Gets a substream of the specified message. If the starting offset is beyond
  46458. the end of the specified section of the message, an empty stream is returned. If
  46459. the number of bytes desired extends beyond the end of the section, a truncated
  46460. stream will be returned.</para>
  46461. <para>For more information about how to construct the <paramref name="section"/>,
  46462. see Section 6.4.5 of RFC3501.</para>
  46463. </remarks>
  46464. <returns>The stream.</returns>
  46465. <param name="index">The index of the message.</param>
  46466. <param name="section">The desired section of the message.</param>
  46467. <param name="offset">The starting offset of the first desired byte.</param>
  46468. <param name="count">The number of bytes desired.</param>
  46469. <param name="cancellationToken">The cancellation token.</param>
  46470. <param name="progress">The progress reporting mechanism.</param>
  46471. <exception cref="T:System.ArgumentNullException">
  46472. <paramref name="section"/> is <c>null</c>.
  46473. </exception>
  46474. <exception cref="T:System.ArgumentOutOfRangeException">
  46475. <para><paramref name="index"/> is out of range.</para>
  46476. <para>-or-</para>
  46477. <para><paramref name="offset"/> is negative.</para>
  46478. <para>-or-</para>
  46479. <para><paramref name="count"/> is negative.</para>
  46480. </exception>
  46481. <exception cref="T:System.ObjectDisposedException">
  46482. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46483. </exception>
  46484. <exception cref="T:MailKit.ServiceNotConnectedException">
  46485. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46486. </exception>
  46487. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46488. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46489. </exception>
  46490. <exception cref="T:MailKit.FolderNotOpenException">
  46491. The folder is not currently open.
  46492. </exception>
  46493. <exception cref="T:MailKit.MessageNotFoundException">
  46494. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  46495. </exception>
  46496. <exception cref="T:System.OperationCanceledException">
  46497. The operation was canceled via the cancellation token.
  46498. </exception>
  46499. <exception cref="T:System.IO.IOException">
  46500. An I/O error occurred.
  46501. </exception>
  46502. <exception cref="T:MailKit.ProtocolException">
  46503. The server's response contained unexpected tokens.
  46504. </exception>
  46505. <exception cref="T:MailKit.CommandException">
  46506. The command failed.
  46507. </exception>
  46508. </member>
  46509. <member name="M:MailKit.MailFolder.GetStreamAsync(System.Int32,System.String,System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  46510. <summary>
  46511. Asynchronously get a substream of the specified body part.
  46512. </summary>
  46513. <remarks>
  46514. <para>Asynchronously gets a substream of the specified message. If the starting
  46515. offset is beyond the end of the specified section of the message, an empty stream
  46516. is returned. If the number of bytes desired extends beyond the end of the section,
  46517. a truncated stream will be returned.</para>
  46518. <para>For more information about how to construct the <paramref name="section"/>,
  46519. see Section 6.4.5 of RFC3501.</para>
  46520. </remarks>
  46521. <returns>The stream.</returns>
  46522. <param name="index">The index of the message.</param>
  46523. <param name="section">The desired section of the message.</param>
  46524. <param name="offset">The starting offset of the first desired byte.</param>
  46525. <param name="count">The number of bytes desired.</param>
  46526. <param name="cancellationToken">The cancellation token.</param>
  46527. <param name="progress">The progress reporting mechanism.</param>
  46528. <exception cref="T:System.ArgumentNullException">
  46529. <paramref name="section"/> is <c>null</c>.
  46530. </exception>
  46531. <exception cref="T:System.ArgumentOutOfRangeException">
  46532. <para><paramref name="index"/> is out of range.</para>
  46533. <para>-or-</para>
  46534. <para><paramref name="offset"/> is negative.</para>
  46535. <para>-or-</para>
  46536. <para><paramref name="count"/> is negative.</para>
  46537. </exception>
  46538. <exception cref="T:System.ObjectDisposedException">
  46539. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46540. </exception>
  46541. <exception cref="T:MailKit.ServiceNotConnectedException">
  46542. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46543. </exception>
  46544. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46545. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46546. </exception>
  46547. <exception cref="T:MailKit.FolderNotOpenException">
  46548. The folder is not currently open.
  46549. </exception>
  46550. <exception cref="T:MailKit.MessageNotFoundException">
  46551. The <see cref="T:MailKit.IMailStore"/> did not return the requested message stream.
  46552. </exception>
  46553. <exception cref="T:System.OperationCanceledException">
  46554. The operation was canceled via the cancellation token.
  46555. </exception>
  46556. <exception cref="T:System.IO.IOException">
  46557. An I/O error occurred.
  46558. </exception>
  46559. <exception cref="T:MailKit.ProtocolException">
  46560. The server's response contained unexpected tokens.
  46561. </exception>
  46562. <exception cref="T:MailKit.CommandException">
  46563. The command failed.
  46564. </exception>
  46565. </member>
  46566. <member name="M:MailKit.MailFolder.AddFlags(MailKit.UniqueId,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  46567. <summary>
  46568. Add a set of flags to the specified message.
  46569. </summary>
  46570. <remarks>
  46571. Adds a set of flags to the specified message.
  46572. </remarks>
  46573. <param name="uid">The UID of the message.</param>
  46574. <param name="flags">The message flags to add.</param>
  46575. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  46576. <param name="cancellationToken">The cancellation token.</param>
  46577. <exception cref="T:System.ArgumentException">
  46578. <para><paramref name="uid"/> is invalid.</para>
  46579. <para>-or-</para>
  46580. <para>No flags were specified.</para>
  46581. </exception>
  46582. <exception cref="T:System.ObjectDisposedException">
  46583. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46584. </exception>
  46585. <exception cref="T:MailKit.ServiceNotConnectedException">
  46586. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46587. </exception>
  46588. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46589. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46590. </exception>
  46591. <exception cref="T:MailKit.FolderNotOpenException">
  46592. The folder is not currently open in read-write mode.
  46593. </exception>
  46594. <exception cref="T:System.OperationCanceledException">
  46595. The operation was canceled via the cancellation token.
  46596. </exception>
  46597. <exception cref="T:System.IO.IOException">
  46598. An I/O error occurred.
  46599. </exception>
  46600. <exception cref="T:MailKit.ProtocolException">
  46601. The server's response contained unexpected tokens.
  46602. </exception>
  46603. <exception cref="T:MailKit.CommandException">
  46604. The command failed.
  46605. </exception>
  46606. </member>
  46607. <member name="M:MailKit.MailFolder.AddFlagsAsync(MailKit.UniqueId,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  46608. <summary>
  46609. Asynchronously add a set of flags to the specified message.
  46610. </summary>
  46611. <remarks>
  46612. Asynchronously adds a set of flags to the specified message.
  46613. </remarks>
  46614. <returns>An asynchronous task context.</returns>
  46615. <param name="uid">The UID of the message.</param>
  46616. <param name="flags">The message flags to add.</param>
  46617. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  46618. <param name="cancellationToken">The cancellation token.</param>
  46619. <exception cref="T:System.ArgumentException">
  46620. <para><paramref name="uid"/> is invalid.</para>
  46621. <para>-or-</para>
  46622. <para>No flags were specified.</para>
  46623. </exception>
  46624. <exception cref="T:System.ObjectDisposedException">
  46625. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46626. </exception>
  46627. <exception cref="T:MailKit.FolderNotOpenException">
  46628. The folder is not currently open in read-write mode.
  46629. </exception>
  46630. <exception cref="T:MailKit.ServiceNotConnectedException">
  46631. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46632. </exception>
  46633. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46634. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46635. </exception>
  46636. <exception cref="T:MailKit.FolderNotOpenException">
  46637. The folder is not currently open in read-write mode.
  46638. </exception>
  46639. <exception cref="T:System.OperationCanceledException">
  46640. The operation was canceled via the cancellation token.
  46641. </exception>
  46642. <exception cref="T:System.IO.IOException">
  46643. An I/O error occurred.
  46644. </exception>
  46645. <exception cref="T:MailKit.ProtocolException">
  46646. The server's response contained unexpected tokens.
  46647. </exception>
  46648. <exception cref="T:MailKit.CommandException">
  46649. The command failed.
  46650. </exception>
  46651. </member>
  46652. <member name="M:MailKit.MailFolder.AddFlags(MailKit.UniqueId,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  46653. <summary>
  46654. Add a set of flags to the specified message.
  46655. </summary>
  46656. <remarks>
  46657. Adds a set of flags to the specified message.
  46658. </remarks>
  46659. <param name="uid">The UID of the message.</param>
  46660. <param name="flags">The message flags to add.</param>
  46661. <param name="keywords">A set of user-defined flags to add.</param>
  46662. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  46663. <param name="cancellationToken">The cancellation token.</param>
  46664. <exception cref="T:System.ArgumentException">
  46665. <para><paramref name="uid"/> is invalid.</para>
  46666. <para>-or-</para>
  46667. <para>No flags were specified.</para>
  46668. </exception>
  46669. <exception cref="T:System.ObjectDisposedException">
  46670. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46671. </exception>
  46672. <exception cref="T:MailKit.FolderNotOpenException">
  46673. The folder is not currently open in read-write mode.
  46674. </exception>
  46675. <exception cref="T:MailKit.ServiceNotConnectedException">
  46676. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46677. </exception>
  46678. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46679. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46680. </exception>
  46681. <exception cref="T:MailKit.FolderNotOpenException">
  46682. The folder is not currently open in read-write mode.
  46683. </exception>
  46684. <exception cref="T:System.OperationCanceledException">
  46685. The operation was canceled via the cancellation token.
  46686. </exception>
  46687. <exception cref="T:System.IO.IOException">
  46688. An I/O error occurred.
  46689. </exception>
  46690. <exception cref="T:MailKit.ProtocolException">
  46691. The server's response contained unexpected tokens.
  46692. </exception>
  46693. <exception cref="T:MailKit.CommandException">
  46694. The command failed.
  46695. </exception>
  46696. </member>
  46697. <member name="M:MailKit.MailFolder.AddFlagsAsync(MailKit.UniqueId,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  46698. <summary>
  46699. Asynchronously add a set of flags to the specified message.
  46700. </summary>
  46701. <remarks>
  46702. Asynchronously adds a set of flags to the specified message.
  46703. </remarks>
  46704. <returns>An asynchronous task context.</returns>
  46705. <param name="uid">The UID of the message.</param>
  46706. <param name="flags">The message flags to add.</param>
  46707. <param name="keywords">A set of user-defined flags to add.</param>
  46708. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  46709. <param name="cancellationToken">The cancellation token.</param>
  46710. <exception cref="T:System.ArgumentException">
  46711. <para><paramref name="uid"/> is invalid.</para>
  46712. <para>-or-</para>
  46713. <para>No flags were specified.</para>
  46714. </exception>
  46715. <exception cref="T:System.ObjectDisposedException">
  46716. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46717. </exception>
  46718. <exception cref="T:MailKit.FolderNotOpenException">
  46719. The folder is not currently open in read-write mode.
  46720. </exception>
  46721. <exception cref="T:MailKit.ServiceNotConnectedException">
  46722. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46723. </exception>
  46724. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46725. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46726. </exception>
  46727. <exception cref="T:MailKit.FolderNotOpenException">
  46728. The folder is not currently open in read-write mode.
  46729. </exception>
  46730. <exception cref="T:System.OperationCanceledException">
  46731. The operation was canceled via the cancellation token.
  46732. </exception>
  46733. <exception cref="T:System.IO.IOException">
  46734. An I/O error occurred.
  46735. </exception>
  46736. <exception cref="T:MailKit.ProtocolException">
  46737. The server's response contained unexpected tokens.
  46738. </exception>
  46739. <exception cref="T:MailKit.CommandException">
  46740. The command failed.
  46741. </exception>
  46742. </member>
  46743. <member name="M:MailKit.MailFolder.AddFlags(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  46744. <summary>
  46745. Add a set of flags to the specified messages.
  46746. </summary>
  46747. <remarks>
  46748. Adds a set of flags to the specified messages.
  46749. </remarks>
  46750. <param name="uids">The UIDs of the messages.</param>
  46751. <param name="flags">The message flags to add.</param>
  46752. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  46753. <param name="cancellationToken">The cancellation token.</param>
  46754. <exception cref="T:System.ArgumentNullException">
  46755. <paramref name="uids"/> is <c>null</c>.
  46756. </exception>
  46757. <exception cref="T:System.ArgumentException">
  46758. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  46759. <para>-or-</para>
  46760. <para>No flags were specified.</para>
  46761. </exception>
  46762. <exception cref="T:System.ObjectDisposedException">
  46763. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46764. </exception>
  46765. <exception cref="T:MailKit.FolderNotOpenException">
  46766. The folder is not currently open in read-write mode.
  46767. </exception>
  46768. <exception cref="T:MailKit.ServiceNotConnectedException">
  46769. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46770. </exception>
  46771. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46772. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46773. </exception>
  46774. <exception cref="T:MailKit.FolderNotOpenException">
  46775. The folder is not currently open in read-write mode.
  46776. </exception>
  46777. <exception cref="T:System.OperationCanceledException">
  46778. The operation was canceled via the cancellation token.
  46779. </exception>
  46780. <exception cref="T:System.IO.IOException">
  46781. An I/O error occurred.
  46782. </exception>
  46783. <exception cref="T:MailKit.ProtocolException">
  46784. The server's response contained unexpected tokens.
  46785. </exception>
  46786. <exception cref="T:MailKit.CommandException">
  46787. The command failed.
  46788. </exception>
  46789. </member>
  46790. <member name="M:MailKit.MailFolder.AddFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  46791. <summary>
  46792. Asynchronously add a set of flags to the specified messages.
  46793. </summary>
  46794. <remarks>
  46795. Asynchronously adds a set of flags to the specified messages.
  46796. </remarks>
  46797. <returns>An asynchronous task context.</returns>
  46798. <param name="uids">The UIDs of the messages.</param>
  46799. <param name="flags">The message flags to add.</param>
  46800. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  46801. <param name="cancellationToken">The cancellation token.</param>
  46802. <exception cref="T:System.ArgumentNullException">
  46803. <paramref name="uids"/> is <c>null</c>.
  46804. </exception>
  46805. <exception cref="T:System.ArgumentException">
  46806. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  46807. <para>-or-</para>
  46808. <para>No flags were specified.</para>
  46809. </exception>
  46810. <exception cref="T:System.ObjectDisposedException">
  46811. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46812. </exception>
  46813. <exception cref="T:MailKit.FolderNotOpenException">
  46814. The folder is not currently open in read-write mode.
  46815. </exception>
  46816. <exception cref="T:MailKit.ServiceNotConnectedException">
  46817. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46818. </exception>
  46819. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46820. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46821. </exception>
  46822. <exception cref="T:MailKit.FolderNotOpenException">
  46823. The folder is not currently open in read-write mode.
  46824. </exception>
  46825. <exception cref="T:System.OperationCanceledException">
  46826. The operation was canceled via the cancellation token.
  46827. </exception>
  46828. <exception cref="T:System.IO.IOException">
  46829. An I/O error occurred.
  46830. </exception>
  46831. <exception cref="T:MailKit.ProtocolException">
  46832. The server's response contained unexpected tokens.
  46833. </exception>
  46834. <exception cref="T:MailKit.CommandException">
  46835. The command failed.
  46836. </exception>
  46837. </member>
  46838. <member name="M:MailKit.MailFolder.AddFlags(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  46839. <summary>
  46840. Add a set of flags to the specified messages.
  46841. </summary>
  46842. <remarks>
  46843. Adds a set of flags to the specified messages.
  46844. </remarks>
  46845. <param name="uids">The UIDs of the messages.</param>
  46846. <param name="flags">The message flags to add.</param>
  46847. <param name="keywords">A set of user-defined flags to add.</param>
  46848. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  46849. <param name="cancellationToken">The cancellation token.</param>
  46850. <exception cref="T:System.ArgumentNullException">
  46851. <paramref name="uids"/> is <c>null</c>.
  46852. </exception>
  46853. <exception cref="T:System.ArgumentException">
  46854. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  46855. <para>-or-</para>
  46856. <para>No flags were specified.</para>
  46857. </exception>
  46858. <exception cref="T:System.ObjectDisposedException">
  46859. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46860. </exception>
  46861. <exception cref="T:MailKit.FolderNotOpenException">
  46862. The folder is not currently open in read-write mode.
  46863. </exception>
  46864. <exception cref="T:MailKit.ServiceNotConnectedException">
  46865. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46866. </exception>
  46867. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46868. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46869. </exception>
  46870. <exception cref="T:MailKit.FolderNotOpenException">
  46871. The folder is not currently open in read-write mode.
  46872. </exception>
  46873. <exception cref="T:System.OperationCanceledException">
  46874. The operation was canceled via the cancellation token.
  46875. </exception>
  46876. <exception cref="T:System.IO.IOException">
  46877. An I/O error occurred.
  46878. </exception>
  46879. <exception cref="T:MailKit.ProtocolException">
  46880. The server's response contained unexpected tokens.
  46881. </exception>
  46882. <exception cref="T:MailKit.CommandException">
  46883. The command failed.
  46884. </exception>
  46885. </member>
  46886. <member name="M:MailKit.MailFolder.AddFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  46887. <summary>
  46888. Asynchronously add a set of flags to the specified messages.
  46889. </summary>
  46890. <remarks>
  46891. Asynchronously adds a set of flags to the specified messages.
  46892. </remarks>
  46893. <returns>An asynchronous task context.</returns>
  46894. <param name="uids">The UIDs of the messages.</param>
  46895. <param name="flags">The message flags to add.</param>
  46896. <param name="keywords">A set of user-defined flags to add.</param>
  46897. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  46898. <param name="cancellationToken">The cancellation token.</param>
  46899. <exception cref="T:System.ArgumentNullException">
  46900. <paramref name="uids"/> is <c>null</c>.
  46901. </exception>
  46902. <exception cref="T:System.ArgumentException">
  46903. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  46904. <para>-or-</para>
  46905. <para>No flags were specified.</para>
  46906. </exception>
  46907. <exception cref="T:System.ObjectDisposedException">
  46908. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46909. </exception>
  46910. <exception cref="T:MailKit.FolderNotOpenException">
  46911. The folder is not currently open in read-write mode.
  46912. </exception>
  46913. <exception cref="T:MailKit.ServiceNotConnectedException">
  46914. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46915. </exception>
  46916. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46917. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46918. </exception>
  46919. <exception cref="T:MailKit.FolderNotOpenException">
  46920. The folder is not currently open in read-write mode.
  46921. </exception>
  46922. <exception cref="T:System.OperationCanceledException">
  46923. The operation was canceled via the cancellation token.
  46924. </exception>
  46925. <exception cref="T:System.IO.IOException">
  46926. An I/O error occurred.
  46927. </exception>
  46928. <exception cref="T:MailKit.ProtocolException">
  46929. The server's response contained unexpected tokens.
  46930. </exception>
  46931. <exception cref="T:MailKit.CommandException">
  46932. The command failed.
  46933. </exception>
  46934. </member>
  46935. <member name="M:MailKit.MailFolder.RemoveFlags(MailKit.UniqueId,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  46936. <summary>
  46937. Remove a set of flags from the specified message.
  46938. </summary>
  46939. <remarks>
  46940. Removes a set of flags from the specified message.
  46941. </remarks>
  46942. <param name="uid">The UIDs of the message.</param>
  46943. <param name="flags">The message flags to remove.</param>
  46944. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  46945. <param name="cancellationToken">The cancellation token.</param>
  46946. <exception cref="T:System.ArgumentException">
  46947. <para><paramref name="uid"/> is invalid.</para>
  46948. <para>-or-</para>
  46949. <para>No flags were specified.</para>
  46950. </exception>
  46951. <exception cref="T:System.ObjectDisposedException">
  46952. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46953. </exception>
  46954. <exception cref="T:MailKit.FolderNotOpenException">
  46955. The folder is not currently open in read-write mode.
  46956. </exception>
  46957. <exception cref="T:MailKit.ServiceNotConnectedException">
  46958. The <see cref="T:MailKit.IMailStore"/> is not connected.
  46959. </exception>
  46960. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  46961. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  46962. </exception>
  46963. <exception cref="T:MailKit.FolderNotOpenException">
  46964. The folder is not currently open in read-write mode.
  46965. </exception>
  46966. <exception cref="T:System.OperationCanceledException">
  46967. The operation was canceled via the cancellation token.
  46968. </exception>
  46969. <exception cref="T:System.IO.IOException">
  46970. An I/O error occurred.
  46971. </exception>
  46972. <exception cref="T:MailKit.ProtocolException">
  46973. The server's response contained unexpected tokens.
  46974. </exception>
  46975. <exception cref="T:MailKit.CommandException">
  46976. The command failed.
  46977. </exception>
  46978. </member>
  46979. <member name="M:MailKit.MailFolder.RemoveFlagsAsync(MailKit.UniqueId,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  46980. <summary>
  46981. Asynchronously remove a set of flags from the specified message.
  46982. </summary>
  46983. <remarks>
  46984. Asynchronously removes a set of flags from the specified message.
  46985. </remarks>
  46986. <returns>An asynchronous task context.</returns>
  46987. <param name="uid">The UID of the message.</param>
  46988. <param name="flags">The message flags to remove.</param>
  46989. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  46990. <param name="cancellationToken">The cancellation token.</param>
  46991. <exception cref="T:System.ArgumentException">
  46992. <para><paramref name="uid"/> is invalid.</para>
  46993. <para>-or-</para>
  46994. <para>No flags were specified.</para>
  46995. </exception>
  46996. <exception cref="T:System.ObjectDisposedException">
  46997. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  46998. </exception>
  46999. <exception cref="T:MailKit.FolderNotOpenException">
  47000. The folder is not currently open in read-write mode.
  47001. </exception>
  47002. <exception cref="T:MailKit.ServiceNotConnectedException">
  47003. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47004. </exception>
  47005. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47006. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47007. </exception>
  47008. <exception cref="T:MailKit.FolderNotOpenException">
  47009. The folder is not currently open in read-write mode.
  47010. </exception>
  47011. <exception cref="T:System.OperationCanceledException">
  47012. The operation was canceled via the cancellation token.
  47013. </exception>
  47014. <exception cref="T:System.IO.IOException">
  47015. An I/O error occurred.
  47016. </exception>
  47017. <exception cref="T:MailKit.ProtocolException">
  47018. The server's response contained unexpected tokens.
  47019. </exception>
  47020. <exception cref="T:MailKit.CommandException">
  47021. The command failed.
  47022. </exception>
  47023. </member>
  47024. <member name="M:MailKit.MailFolder.RemoveFlags(MailKit.UniqueId,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  47025. <summary>
  47026. Remove a set of flags from the specified message.
  47027. </summary>
  47028. <remarks>
  47029. Removes a set of flags from the specified message.
  47030. </remarks>
  47031. <param name="uid">The UIDs of the message.</param>
  47032. <param name="flags">The message flags to remove.</param>
  47033. <param name="keywords">A set of user-defined flags to remove.</param>
  47034. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47035. <param name="cancellationToken">The cancellation token.</param>
  47036. <exception cref="T:System.ArgumentException">
  47037. <para><paramref name="uid"/> is invalid.</para>
  47038. <para>-or-</para>
  47039. <para>No flags were specified.</para>
  47040. </exception>
  47041. <exception cref="T:System.ObjectDisposedException">
  47042. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47043. </exception>
  47044. <exception cref="T:MailKit.FolderNotOpenException">
  47045. The folder is not currently open in read-write mode.
  47046. </exception>
  47047. <exception cref="T:MailKit.ServiceNotConnectedException">
  47048. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47049. </exception>
  47050. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47051. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47052. </exception>
  47053. <exception cref="T:MailKit.FolderNotOpenException">
  47054. The folder is not currently open in read-write mode.
  47055. </exception>
  47056. <exception cref="T:System.OperationCanceledException">
  47057. The operation was canceled via the cancellation token.
  47058. </exception>
  47059. <exception cref="T:System.IO.IOException">
  47060. An I/O error occurred.
  47061. </exception>
  47062. <exception cref="T:MailKit.ProtocolException">
  47063. The server's response contained unexpected tokens.
  47064. </exception>
  47065. <exception cref="T:MailKit.CommandException">
  47066. The command failed.
  47067. </exception>
  47068. </member>
  47069. <member name="M:MailKit.MailFolder.RemoveFlagsAsync(MailKit.UniqueId,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  47070. <summary>
  47071. Asynchronously remove a set of flags from the specified message.
  47072. </summary>
  47073. <remarks>
  47074. Asynchronously removes a set of flags from the specified message.
  47075. </remarks>
  47076. <returns>An asynchronous task context.</returns>
  47077. <param name="uid">The UID of the message.</param>
  47078. <param name="flags">The message flags to remove.</param>
  47079. <param name="keywords">A set of user-defined flags to remove.</param>
  47080. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47081. <param name="cancellationToken">The cancellation token.</param>
  47082. <exception cref="T:System.ArgumentException">
  47083. <para><paramref name="uid"/> is invalid.</para>
  47084. <para>-or-</para>
  47085. <para>No flags were specified.</para>
  47086. </exception>
  47087. <exception cref="T:System.ObjectDisposedException">
  47088. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47089. </exception>
  47090. <exception cref="T:MailKit.FolderNotOpenException">
  47091. The folder is not currently open in read-write mode.
  47092. </exception>
  47093. <exception cref="T:MailKit.ServiceNotConnectedException">
  47094. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47095. </exception>
  47096. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47097. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47098. </exception>
  47099. <exception cref="T:MailKit.FolderNotOpenException">
  47100. The folder is not currently open in read-write mode.
  47101. </exception>
  47102. <exception cref="T:System.OperationCanceledException">
  47103. The operation was canceled via the cancellation token.
  47104. </exception>
  47105. <exception cref="T:System.IO.IOException">
  47106. An I/O error occurred.
  47107. </exception>
  47108. <exception cref="T:MailKit.ProtocolException">
  47109. The server's response contained unexpected tokens.
  47110. </exception>
  47111. <exception cref="T:MailKit.CommandException">
  47112. The command failed.
  47113. </exception>
  47114. </member>
  47115. <member name="M:MailKit.MailFolder.RemoveFlags(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  47116. <summary>
  47117. Remove a set of flags from the specified messages.
  47118. </summary>
  47119. <remarks>
  47120. Removes a set of flags from the specified messages.
  47121. </remarks>
  47122. <param name="uids">The UIDs of the messages.</param>
  47123. <param name="flags">The message flags to remove.</param>
  47124. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47125. <param name="cancellationToken">The cancellation token.</param>
  47126. <exception cref="T:System.ArgumentNullException">
  47127. <paramref name="uids"/> is <c>null</c>.
  47128. </exception>
  47129. <exception cref="T:System.ArgumentException">
  47130. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  47131. <para>-or-</para>
  47132. <para>No flags were specified.</para>
  47133. </exception>
  47134. <exception cref="T:System.ObjectDisposedException">
  47135. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47136. </exception>
  47137. <exception cref="T:MailKit.FolderNotOpenException">
  47138. The folder is not currently open in read-write mode.
  47139. </exception>
  47140. <exception cref="T:MailKit.ServiceNotConnectedException">
  47141. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47142. </exception>
  47143. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47144. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47145. </exception>
  47146. <exception cref="T:MailKit.FolderNotOpenException">
  47147. The folder is not currently open in read-write mode.
  47148. </exception>
  47149. <exception cref="T:System.OperationCanceledException">
  47150. The operation was canceled via the cancellation token.
  47151. </exception>
  47152. <exception cref="T:System.IO.IOException">
  47153. An I/O error occurred.
  47154. </exception>
  47155. <exception cref="T:MailKit.ProtocolException">
  47156. The server's response contained unexpected tokens.
  47157. </exception>
  47158. <exception cref="T:MailKit.CommandException">
  47159. The command failed.
  47160. </exception>
  47161. </member>
  47162. <member name="M:MailKit.MailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  47163. <summary>
  47164. Asynchronously remove a set of flags from the specified messages.
  47165. </summary>
  47166. <remarks>
  47167. Asynchronously removes a set of flags from the specified messages.
  47168. </remarks>
  47169. <returns>An asynchronous task context.</returns>
  47170. <param name="uids">The UIDs of the messages.</param>
  47171. <param name="flags">The message flags to remove.</param>
  47172. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47173. <param name="cancellationToken">The cancellation token.</param>
  47174. <exception cref="T:System.ArgumentNullException">
  47175. <paramref name="uids"/> is <c>null</c>.
  47176. </exception>
  47177. <exception cref="T:System.ArgumentException">
  47178. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  47179. <para>-or-</para>
  47180. <para>No flags were specified.</para>
  47181. </exception>
  47182. <exception cref="T:System.ObjectDisposedException">
  47183. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47184. </exception>
  47185. <exception cref="T:MailKit.FolderNotOpenException">
  47186. The folder is not currently open in read-write mode.
  47187. </exception>
  47188. <exception cref="T:MailKit.ServiceNotConnectedException">
  47189. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47190. </exception>
  47191. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47192. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47193. </exception>
  47194. <exception cref="T:MailKit.FolderNotOpenException">
  47195. The folder is not currently open in read-write mode.
  47196. </exception>
  47197. <exception cref="T:System.OperationCanceledException">
  47198. The operation was canceled via the cancellation token.
  47199. </exception>
  47200. <exception cref="T:System.IO.IOException">
  47201. An I/O error occurred.
  47202. </exception>
  47203. <exception cref="T:MailKit.ProtocolException">
  47204. The server's response contained unexpected tokens.
  47205. </exception>
  47206. <exception cref="T:MailKit.CommandException">
  47207. The command failed.
  47208. </exception>
  47209. </member>
  47210. <member name="M:MailKit.MailFolder.RemoveFlags(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  47211. <summary>
  47212. Remove a set of flags from the specified messages.
  47213. </summary>
  47214. <remarks>
  47215. Removes a set of flags from the specified messages.
  47216. </remarks>
  47217. <param name="uids">The UIDs of the messages.</param>
  47218. <param name="flags">The message flags to remove.</param>
  47219. <param name="keywords">A set of user-defined flags to remove.</param>
  47220. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47221. <param name="cancellationToken">The cancellation token.</param>
  47222. <exception cref="T:System.ArgumentNullException">
  47223. <paramref name="uids"/> is <c>null</c>.
  47224. </exception>
  47225. <exception cref="T:System.ArgumentException">
  47226. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  47227. <para>-or-</para>
  47228. <para>No flags were specified.</para>
  47229. </exception>
  47230. <exception cref="T:System.ObjectDisposedException">
  47231. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47232. </exception>
  47233. <exception cref="T:MailKit.FolderNotOpenException">
  47234. The folder is not currently open in read-write mode.
  47235. </exception>
  47236. <exception cref="T:MailKit.ServiceNotConnectedException">
  47237. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47238. </exception>
  47239. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47240. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47241. </exception>
  47242. <exception cref="T:MailKit.FolderNotOpenException">
  47243. The folder is not currently open in read-write mode.
  47244. </exception>
  47245. <exception cref="T:System.OperationCanceledException">
  47246. The operation was canceled via the cancellation token.
  47247. </exception>
  47248. <exception cref="T:System.IO.IOException">
  47249. An I/O error occurred.
  47250. </exception>
  47251. <exception cref="T:MailKit.ProtocolException">
  47252. The server's response contained unexpected tokens.
  47253. </exception>
  47254. <exception cref="T:MailKit.CommandException">
  47255. The command failed.
  47256. </exception>
  47257. </member>
  47258. <member name="M:MailKit.MailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  47259. <summary>
  47260. Asynchronously remove a set of flags from the specified messages.
  47261. </summary>
  47262. <remarks>
  47263. Asynchronously removes a set of flags from the specified messages.
  47264. </remarks>
  47265. <returns>An asynchronous task context.</returns>
  47266. <param name="uids">The UIDs of the messages.</param>
  47267. <param name="flags">The message flags to remove.</param>
  47268. <param name="keywords">A set of user-defined flags to remove.</param>
  47269. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47270. <param name="cancellationToken">The cancellation token.</param>
  47271. <exception cref="T:System.ArgumentNullException">
  47272. <paramref name="uids"/> is <c>null</c>.
  47273. </exception>
  47274. <exception cref="T:System.ArgumentException">
  47275. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  47276. <para>-or-</para>
  47277. <para>No flags were specified.</para>
  47278. </exception>
  47279. <exception cref="T:System.ObjectDisposedException">
  47280. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47281. </exception>
  47282. <exception cref="T:MailKit.FolderNotOpenException">
  47283. The folder is not currently open in read-write mode.
  47284. </exception>
  47285. <exception cref="T:MailKit.ServiceNotConnectedException">
  47286. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47287. </exception>
  47288. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47289. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47290. </exception>
  47291. <exception cref="T:MailKit.FolderNotOpenException">
  47292. The folder is not currently open in read-write mode.
  47293. </exception>
  47294. <exception cref="T:System.OperationCanceledException">
  47295. The operation was canceled via the cancellation token.
  47296. </exception>
  47297. <exception cref="T:System.IO.IOException">
  47298. An I/O error occurred.
  47299. </exception>
  47300. <exception cref="T:MailKit.ProtocolException">
  47301. The server's response contained unexpected tokens.
  47302. </exception>
  47303. <exception cref="T:MailKit.CommandException">
  47304. The command failed.
  47305. </exception>
  47306. </member>
  47307. <member name="M:MailKit.MailFolder.SetFlags(MailKit.UniqueId,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  47308. <summary>
  47309. Set the flags of the specified message.
  47310. </summary>
  47311. <remarks>
  47312. Sets the flags of the specified message.
  47313. </remarks>
  47314. <param name="uid">The UIDs of the message.</param>
  47315. <param name="flags">The message flags to set.</param>
  47316. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47317. <param name="cancellationToken">The cancellation token.</param>
  47318. <exception cref="T:System.ArgumentException">
  47319. <paramref name="uid"/> is invalid.
  47320. </exception>
  47321. <exception cref="T:System.ObjectDisposedException">
  47322. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47323. </exception>
  47324. <exception cref="T:MailKit.FolderNotOpenException">
  47325. The folder is not currently open in read-write mode.
  47326. </exception>
  47327. <exception cref="T:MailKit.ServiceNotConnectedException">
  47328. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47329. </exception>
  47330. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47331. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47332. </exception>
  47333. <exception cref="T:MailKit.FolderNotOpenException">
  47334. The folder is not currently open in read-write mode.
  47335. </exception>
  47336. <exception cref="T:System.OperationCanceledException">
  47337. The operation was canceled via the cancellation token.
  47338. </exception>
  47339. <exception cref="T:System.IO.IOException">
  47340. An I/O error occurred.
  47341. </exception>
  47342. <exception cref="T:MailKit.ProtocolException">
  47343. The server's response contained unexpected tokens.
  47344. </exception>
  47345. <exception cref="T:MailKit.CommandException">
  47346. The command failed.
  47347. </exception>
  47348. </member>
  47349. <member name="M:MailKit.MailFolder.SetFlagsAsync(MailKit.UniqueId,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  47350. <summary>
  47351. Asynchronously set the flags of the specified message.
  47352. </summary>
  47353. <remarks>
  47354. Asynchronously sets the flags of the specified message.
  47355. </remarks>
  47356. <returns>An asynchronous task context.</returns>
  47357. <param name="uid">The UID of the message.</param>
  47358. <param name="flags">The message flags to set.</param>
  47359. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47360. <param name="cancellationToken">The cancellation token.</param>
  47361. <exception cref="T:System.ArgumentException">
  47362. <paramref name="uid"/> is invalid.
  47363. </exception>
  47364. <exception cref="T:System.ObjectDisposedException">
  47365. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47366. </exception>
  47367. <exception cref="T:MailKit.FolderNotOpenException">
  47368. The folder is not currently open in read-write mode.
  47369. </exception>
  47370. <exception cref="T:MailKit.ServiceNotConnectedException">
  47371. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47372. </exception>
  47373. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47374. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47375. </exception>
  47376. <exception cref="T:MailKit.FolderNotOpenException">
  47377. The folder is not currently open in read-write mode.
  47378. </exception>
  47379. <exception cref="T:System.OperationCanceledException">
  47380. The operation was canceled via the cancellation token.
  47381. </exception>
  47382. <exception cref="T:System.IO.IOException">
  47383. An I/O error occurred.
  47384. </exception>
  47385. <exception cref="T:MailKit.ProtocolException">
  47386. The server's response contained unexpected tokens.
  47387. </exception>
  47388. <exception cref="T:MailKit.CommandException">
  47389. The command failed.
  47390. </exception>
  47391. </member>
  47392. <member name="M:MailKit.MailFolder.SetFlags(MailKit.UniqueId,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  47393. <summary>
  47394. Set the flags of the specified message.
  47395. </summary>
  47396. <remarks>
  47397. Sets the flags of the specified message.
  47398. </remarks>
  47399. <param name="uid">The UIDs of the message.</param>
  47400. <param name="flags">The message flags to set.</param>
  47401. <param name="keywords">A set of user-defined flags to set.</param>
  47402. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47403. <param name="cancellationToken">The cancellation token.</param>
  47404. <exception cref="T:System.ArgumentException">
  47405. <paramref name="uid"/> is invalid.
  47406. </exception>
  47407. <exception cref="T:System.ObjectDisposedException">
  47408. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47409. </exception>
  47410. <exception cref="T:MailKit.ServiceNotConnectedException">
  47411. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47412. </exception>
  47413. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47414. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47415. </exception>
  47416. <exception cref="T:MailKit.FolderNotOpenException">
  47417. The folder is not currently open in read-write mode.
  47418. </exception>
  47419. <exception cref="T:System.OperationCanceledException">
  47420. The operation was canceled via the cancellation token.
  47421. </exception>
  47422. <exception cref="T:System.IO.IOException">
  47423. An I/O error occurred.
  47424. </exception>
  47425. <exception cref="T:MailKit.ProtocolException">
  47426. The server's response contained unexpected tokens.
  47427. </exception>
  47428. <exception cref="T:MailKit.CommandException">
  47429. The command failed.
  47430. </exception>
  47431. </member>
  47432. <member name="M:MailKit.MailFolder.SetFlagsAsync(MailKit.UniqueId,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  47433. <summary>
  47434. Asynchronously set the flags of the specified message.
  47435. </summary>
  47436. <remarks>
  47437. Asynchronously sets the flags of the specified message.
  47438. </remarks>
  47439. <returns>An asynchronous task context.</returns>
  47440. <param name="uid">The UID of the message.</param>
  47441. <param name="flags">The message flags to set.</param>
  47442. <param name="keywords">A set of user-defined flags to set.</param>
  47443. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47444. <param name="cancellationToken">The cancellation token.</param>
  47445. <exception cref="T:System.ArgumentException">
  47446. <paramref name="uid"/> is invalid.
  47447. </exception>
  47448. <exception cref="T:System.ObjectDisposedException">
  47449. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47450. </exception>
  47451. <exception cref="T:MailKit.ServiceNotConnectedException">
  47452. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47453. </exception>
  47454. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47455. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47456. </exception>
  47457. <exception cref="T:MailKit.FolderNotOpenException">
  47458. The folder is not currently open in read-write mode.
  47459. </exception>
  47460. <exception cref="T:System.OperationCanceledException">
  47461. The operation was canceled via the cancellation token.
  47462. </exception>
  47463. <exception cref="T:System.IO.IOException">
  47464. An I/O error occurred.
  47465. </exception>
  47466. <exception cref="T:MailKit.ProtocolException">
  47467. The server's response contained unexpected tokens.
  47468. </exception>
  47469. <exception cref="T:MailKit.CommandException">
  47470. The command failed.
  47471. </exception>
  47472. </member>
  47473. <member name="M:MailKit.MailFolder.SetFlags(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  47474. <summary>
  47475. Set the flags of the specified messages.
  47476. </summary>
  47477. <remarks>
  47478. Sets the flags of the specified messages.
  47479. </remarks>
  47480. <param name="uids">The UIDs of the messages.</param>
  47481. <param name="flags">The message flags to set.</param>
  47482. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47483. <param name="cancellationToken">The cancellation token.</param>
  47484. <exception cref="T:System.ArgumentNullException">
  47485. <paramref name="uids"/> is <c>null</c>.
  47486. </exception>
  47487. <exception cref="T:System.ArgumentException">
  47488. One or more of the <paramref name="uids"/> is invalid.
  47489. </exception>
  47490. <exception cref="T:System.ObjectDisposedException">
  47491. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47492. </exception>
  47493. <exception cref="T:MailKit.ServiceNotConnectedException">
  47494. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47495. </exception>
  47496. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47497. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47498. </exception>
  47499. <exception cref="T:MailKit.FolderNotOpenException">
  47500. The folder is not currently open in read-write mode.
  47501. </exception>
  47502. <exception cref="T:System.OperationCanceledException">
  47503. The operation was canceled via the cancellation token.
  47504. </exception>
  47505. <exception cref="T:System.IO.IOException">
  47506. An I/O error occurred.
  47507. </exception>
  47508. <exception cref="T:MailKit.ProtocolException">
  47509. The server's response contained unexpected tokens.
  47510. </exception>
  47511. <exception cref="T:MailKit.CommandException">
  47512. The command failed.
  47513. </exception>
  47514. </member>
  47515. <member name="M:MailKit.MailFolder.SetFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  47516. <summary>
  47517. Asynchronously set the flags of the specified messages.
  47518. </summary>
  47519. <remarks>
  47520. Asynchronously sets the flags of the specified messages.
  47521. </remarks>
  47522. <returns>An asynchronous task context.</returns>
  47523. <param name="uids">The UIDs of the messages.</param>
  47524. <param name="flags">The message flags to set.</param>
  47525. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47526. <param name="cancellationToken">The cancellation token.</param>
  47527. <exception cref="T:System.ArgumentNullException">
  47528. <paramref name="uids"/> is <c>null</c>.
  47529. </exception>
  47530. <exception cref="T:System.ArgumentException">
  47531. One or more of the <paramref name="uids"/> is invalid.
  47532. </exception>
  47533. <exception cref="T:System.ObjectDisposedException">
  47534. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47535. </exception>
  47536. <exception cref="T:MailKit.ServiceNotConnectedException">
  47537. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47538. </exception>
  47539. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47540. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47541. </exception>
  47542. <exception cref="T:MailKit.FolderNotOpenException">
  47543. The folder is not currently open in read-write mode.
  47544. </exception>
  47545. <exception cref="T:System.OperationCanceledException">
  47546. The operation was canceled via the cancellation token.
  47547. </exception>
  47548. <exception cref="T:System.IO.IOException">
  47549. An I/O error occurred.
  47550. </exception>
  47551. <exception cref="T:MailKit.ProtocolException">
  47552. The server's response contained unexpected tokens.
  47553. </exception>
  47554. <exception cref="T:MailKit.CommandException">
  47555. The command failed.
  47556. </exception>
  47557. </member>
  47558. <member name="M:MailKit.MailFolder.SetFlags(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  47559. <summary>
  47560. Set the flags of the specified messages.
  47561. </summary>
  47562. <remarks>
  47563. Sets the flags of the specified messages.
  47564. </remarks>
  47565. <param name="uids">The UIDs of the messages.</param>
  47566. <param name="flags">The message flags to set.</param>
  47567. <param name="keywords">A set of user-defined flags to set.</param>
  47568. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47569. <param name="cancellationToken">The cancellation token.</param>
  47570. <exception cref="T:System.ArgumentNullException">
  47571. <paramref name="uids"/> is <c>null</c>.
  47572. </exception>
  47573. <exception cref="T:System.ArgumentException">
  47574. One or more of the <paramref name="uids"/> is invalid.
  47575. </exception>
  47576. <exception cref="T:System.ObjectDisposedException">
  47577. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47578. </exception>
  47579. <exception cref="T:MailKit.ServiceNotConnectedException">
  47580. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47581. </exception>
  47582. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47583. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47584. </exception>
  47585. <exception cref="T:MailKit.FolderNotOpenException">
  47586. The folder is not currently open in read-write mode.
  47587. </exception>
  47588. <exception cref="T:System.OperationCanceledException">
  47589. The operation was canceled via the cancellation token.
  47590. </exception>
  47591. <exception cref="T:System.IO.IOException">
  47592. An I/O error occurred.
  47593. </exception>
  47594. <exception cref="T:MailKit.ProtocolException">
  47595. The server's response contained unexpected tokens.
  47596. </exception>
  47597. <exception cref="T:MailKit.CommandException">
  47598. The command failed.
  47599. </exception>
  47600. </member>
  47601. <member name="M:MailKit.MailFolder.SetFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  47602. <summary>
  47603. Asynchronously set the flags of the specified messages.
  47604. </summary>
  47605. <remarks>
  47606. Asynchronously sets the flags of the specified messages.
  47607. </remarks>
  47608. <returns>An asynchronous task context.</returns>
  47609. <param name="uids">The UIDs of the messages.</param>
  47610. <param name="flags">The message flags to set.</param>
  47611. <param name="keywords">A set of user-defined flags to set.</param>
  47612. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47613. <param name="cancellationToken">The cancellation token.</param>
  47614. <exception cref="T:System.ArgumentNullException">
  47615. <paramref name="uids"/> is <c>null</c>.
  47616. </exception>
  47617. <exception cref="T:System.ArgumentException">
  47618. One or more of the <paramref name="uids"/> is invalid.
  47619. </exception>
  47620. <exception cref="T:System.ObjectDisposedException">
  47621. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47622. </exception>
  47623. <exception cref="T:MailKit.ServiceNotConnectedException">
  47624. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47625. </exception>
  47626. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47627. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47628. </exception>
  47629. <exception cref="T:MailKit.FolderNotOpenException">
  47630. The folder is not currently open in read-write mode.
  47631. </exception>
  47632. <exception cref="T:System.OperationCanceledException">
  47633. The operation was canceled via the cancellation token.
  47634. </exception>
  47635. <exception cref="T:System.IO.IOException">
  47636. An I/O error occurred.
  47637. </exception>
  47638. <exception cref="T:MailKit.ProtocolException">
  47639. The server's response contained unexpected tokens.
  47640. </exception>
  47641. <exception cref="T:MailKit.CommandException">
  47642. The command failed.
  47643. </exception>
  47644. </member>
  47645. <member name="M:MailKit.MailFolder.AddFlags(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  47646. <summary>
  47647. Add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  47648. </summary>
  47649. <remarks>
  47650. Adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  47651. </remarks>
  47652. <returns>The unique IDs of the messages that were not updated.</returns>
  47653. <param name="uids">The UIDs of the messages.</param>
  47654. <param name="modseq">The mod-sequence value.</param>
  47655. <param name="flags">The message flags to add.</param>
  47656. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47657. <param name="cancellationToken">The cancellation token.</param>
  47658. <exception cref="T:System.ArgumentNullException">
  47659. <paramref name="uids"/> is <c>null</c>.
  47660. </exception>
  47661. <exception cref="T:System.ArgumentException">
  47662. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  47663. <para>-or-</para>
  47664. <para>No flags were specified.</para>
  47665. </exception>
  47666. <exception cref="T:System.ObjectDisposedException">
  47667. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47668. </exception>
  47669. <exception cref="T:MailKit.ServiceNotConnectedException">
  47670. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47671. </exception>
  47672. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47673. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47674. </exception>
  47675. <exception cref="T:MailKit.FolderNotOpenException">
  47676. The folder is not currently open in read-write mode.
  47677. </exception>
  47678. <exception cref="T:System.NotSupportedException">
  47679. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  47680. </exception>
  47681. <exception cref="T:System.OperationCanceledException">
  47682. The operation was canceled via the cancellation token.
  47683. </exception>
  47684. <exception cref="T:System.IO.IOException">
  47685. An I/O error occurred.
  47686. </exception>
  47687. <exception cref="T:MailKit.ProtocolException">
  47688. The server's response contained unexpected tokens.
  47689. </exception>
  47690. <exception cref="T:MailKit.CommandException">
  47691. The command failed.
  47692. </exception>
  47693. </member>
  47694. <member name="M:MailKit.MailFolder.AddFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  47695. <summary>
  47696. Asynchronously add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  47697. </summary>
  47698. <remarks>
  47699. Asynchronously adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  47700. </remarks>
  47701. <returns>The unique IDs of the messages that were not updated.</returns>
  47702. <param name="uids">The UIDs of the messages.</param>
  47703. <param name="modseq">The mod-sequence value.</param>
  47704. <param name="flags">The message flags to add.</param>
  47705. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47706. <param name="cancellationToken">The cancellation token.</param>
  47707. <exception cref="T:System.ArgumentNullException">
  47708. <paramref name="uids"/> is <c>null</c>.
  47709. </exception>
  47710. <exception cref="T:System.ArgumentException">
  47711. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  47712. <para>-or-</para>
  47713. <para>No flags were specified.</para>
  47714. </exception>
  47715. <exception cref="T:System.ObjectDisposedException">
  47716. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47717. </exception>
  47718. <exception cref="T:MailKit.ServiceNotConnectedException">
  47719. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47720. </exception>
  47721. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47722. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47723. </exception>
  47724. <exception cref="T:MailKit.FolderNotOpenException">
  47725. The folder is not currently open in read-write mode.
  47726. </exception>
  47727. <exception cref="T:System.NotSupportedException">
  47728. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  47729. </exception>
  47730. <exception cref="T:System.OperationCanceledException">
  47731. The operation was canceled via the cancellation token.
  47732. </exception>
  47733. <exception cref="T:System.IO.IOException">
  47734. An I/O error occurred.
  47735. </exception>
  47736. <exception cref="T:MailKit.ProtocolException">
  47737. The server's response contained unexpected tokens.
  47738. </exception>
  47739. <exception cref="T:MailKit.CommandException">
  47740. The command failed.
  47741. </exception>
  47742. </member>
  47743. <member name="M:MailKit.MailFolder.AddFlags(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  47744. <summary>
  47745. Add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  47746. </summary>
  47747. <remarks>
  47748. Adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  47749. </remarks>
  47750. <returns>The unique IDs of the messages that were not updated.</returns>
  47751. <param name="uids">The UIDs of the messages.</param>
  47752. <param name="modseq">The mod-sequence value.</param>
  47753. <param name="flags">The message flags to add.</param>
  47754. <param name="keywords">A set of user-defined flags to add.</param>
  47755. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47756. <param name="cancellationToken">The cancellation token.</param>
  47757. <exception cref="T:System.ArgumentNullException">
  47758. <paramref name="uids"/> is <c>null</c>.
  47759. </exception>
  47760. <exception cref="T:System.ArgumentException">
  47761. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  47762. <para>-or-</para>
  47763. <para>No flags were specified.</para>
  47764. </exception>
  47765. <exception cref="T:System.ObjectDisposedException">
  47766. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47767. </exception>
  47768. <exception cref="T:MailKit.ServiceNotConnectedException">
  47769. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47770. </exception>
  47771. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47772. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47773. </exception>
  47774. <exception cref="T:MailKit.FolderNotOpenException">
  47775. The folder is not currently open in read-write mode.
  47776. </exception>
  47777. <exception cref="T:System.NotSupportedException">
  47778. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  47779. </exception>
  47780. <exception cref="T:System.OperationCanceledException">
  47781. The operation was canceled via the cancellation token.
  47782. </exception>
  47783. <exception cref="T:System.IO.IOException">
  47784. An I/O error occurred.
  47785. </exception>
  47786. <exception cref="T:MailKit.ProtocolException">
  47787. The server's response contained unexpected tokens.
  47788. </exception>
  47789. <exception cref="T:MailKit.CommandException">
  47790. The command failed.
  47791. </exception>
  47792. </member>
  47793. <member name="M:MailKit.MailFolder.AddFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  47794. <summary>
  47795. Asynchronously add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  47796. </summary>
  47797. <remarks>
  47798. Asynchronously adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  47799. </remarks>
  47800. <returns>The unique IDs of the messages that were not updated.</returns>
  47801. <param name="uids">The UIDs of the messages.</param>
  47802. <param name="modseq">The mod-sequence value.</param>
  47803. <param name="flags">The message flags to add.</param>
  47804. <param name="keywords">A set of user-defined flags to add.</param>
  47805. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47806. <param name="cancellationToken">The cancellation token.</param>
  47807. <exception cref="T:System.ArgumentNullException">
  47808. <paramref name="uids"/> is <c>null</c>.
  47809. </exception>
  47810. <exception cref="T:System.ArgumentException">
  47811. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  47812. <para>-or-</para>
  47813. <para>No flags were specified.</para>
  47814. </exception>
  47815. <exception cref="T:System.ObjectDisposedException">
  47816. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47817. </exception>
  47818. <exception cref="T:MailKit.ServiceNotConnectedException">
  47819. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47820. </exception>
  47821. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47822. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47823. </exception>
  47824. <exception cref="T:MailKit.FolderNotOpenException">
  47825. The folder is not currently open in read-write mode.
  47826. </exception>
  47827. <exception cref="T:System.NotSupportedException">
  47828. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  47829. </exception>
  47830. <exception cref="T:System.OperationCanceledException">
  47831. The operation was canceled via the cancellation token.
  47832. </exception>
  47833. <exception cref="T:System.IO.IOException">
  47834. An I/O error occurred.
  47835. </exception>
  47836. <exception cref="T:MailKit.ProtocolException">
  47837. The server's response contained unexpected tokens.
  47838. </exception>
  47839. <exception cref="T:MailKit.CommandException">
  47840. The command failed.
  47841. </exception>
  47842. </member>
  47843. <member name="M:MailKit.MailFolder.RemoveFlags(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  47844. <summary>
  47845. Remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  47846. </summary>
  47847. <remarks>
  47848. Removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  47849. </remarks>
  47850. <returns>The unique IDs of the messages that were not updated.</returns>
  47851. <param name="uids">The UIDs of the messages.</param>
  47852. <param name="modseq">The mod-sequence value.</param>
  47853. <param name="flags">The message flags to remove.</param>
  47854. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47855. <param name="cancellationToken">The cancellation token.</param>
  47856. <exception cref="T:System.ArgumentNullException">
  47857. <paramref name="uids"/> is <c>null</c>.
  47858. </exception>
  47859. <exception cref="T:System.ArgumentException">
  47860. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  47861. <para>-or-</para>
  47862. <para>No flags were specified.</para>
  47863. </exception>
  47864. <exception cref="T:System.ObjectDisposedException">
  47865. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47866. </exception>
  47867. <exception cref="T:MailKit.ServiceNotConnectedException">
  47868. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47869. </exception>
  47870. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47871. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47872. </exception>
  47873. <exception cref="T:MailKit.FolderNotOpenException">
  47874. The folder is not currently open in read-write mode.
  47875. </exception>
  47876. <exception cref="T:System.NotSupportedException">
  47877. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  47878. </exception>
  47879. <exception cref="T:System.OperationCanceledException">
  47880. The operation was canceled via the cancellation token.
  47881. </exception>
  47882. <exception cref="T:System.IO.IOException">
  47883. An I/O error occurred.
  47884. </exception>
  47885. <exception cref="T:MailKit.ProtocolException">
  47886. The server's response contained unexpected tokens.
  47887. </exception>
  47888. <exception cref="T:MailKit.CommandException">
  47889. The command failed.
  47890. </exception>
  47891. </member>
  47892. <member name="M:MailKit.MailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  47893. <summary>
  47894. Asynchronously remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  47895. </summary>
  47896. <remarks>
  47897. Asynchronously removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  47898. </remarks>
  47899. <returns>The unique IDs of the messages that were not updated.</returns>
  47900. <param name="uids">The UIDs of the messages.</param>
  47901. <param name="modseq">The mod-sequence value.</param>
  47902. <param name="flags">The message flags to remove.</param>
  47903. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47904. <param name="cancellationToken">The cancellation token.</param>
  47905. <exception cref="T:System.ArgumentNullException">
  47906. <paramref name="uids"/> is <c>null</c>.
  47907. </exception>
  47908. <exception cref="T:System.ArgumentException">
  47909. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  47910. <para>-or-</para>
  47911. <para>No flags were specified.</para>
  47912. </exception>
  47913. <exception cref="T:System.ObjectDisposedException">
  47914. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47915. </exception>
  47916. <exception cref="T:MailKit.ServiceNotConnectedException">
  47917. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47918. </exception>
  47919. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47920. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47921. </exception>
  47922. <exception cref="T:MailKit.FolderNotOpenException">
  47923. The folder is not currently open in read-write mode.
  47924. </exception>
  47925. <exception cref="T:System.NotSupportedException">
  47926. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  47927. </exception>
  47928. <exception cref="T:System.OperationCanceledException">
  47929. The operation was canceled via the cancellation token.
  47930. </exception>
  47931. <exception cref="T:System.IO.IOException">
  47932. An I/O error occurred.
  47933. </exception>
  47934. <exception cref="T:MailKit.ProtocolException">
  47935. The server's response contained unexpected tokens.
  47936. </exception>
  47937. <exception cref="T:MailKit.CommandException">
  47938. The command failed.
  47939. </exception>
  47940. </member>
  47941. <member name="M:MailKit.MailFolder.RemoveFlags(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  47942. <summary>
  47943. Remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  47944. </summary>
  47945. <remarks>
  47946. Removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  47947. </remarks>
  47948. <returns>The unique IDs of the messages that were not updated.</returns>
  47949. <param name="uids">The UIDs of the messages.</param>
  47950. <param name="modseq">The mod-sequence value.</param>
  47951. <param name="flags">The message flags to remove.</param>
  47952. <param name="keywords">A set of user-defined flags to remove.</param>
  47953. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  47954. <param name="cancellationToken">The cancellation token.</param>
  47955. <exception cref="T:System.ArgumentNullException">
  47956. <paramref name="uids"/> is <c>null</c>.
  47957. </exception>
  47958. <exception cref="T:System.ArgumentException">
  47959. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  47960. <para>-or-</para>
  47961. <para>No flags were specified.</para>
  47962. </exception>
  47963. <exception cref="T:System.ObjectDisposedException">
  47964. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  47965. </exception>
  47966. <exception cref="T:MailKit.ServiceNotConnectedException">
  47967. The <see cref="T:MailKit.IMailStore"/> is not connected.
  47968. </exception>
  47969. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  47970. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  47971. </exception>
  47972. <exception cref="T:MailKit.FolderNotOpenException">
  47973. The folder is not currently open in read-write mode.
  47974. </exception>
  47975. <exception cref="T:System.NotSupportedException">
  47976. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  47977. </exception>
  47978. <exception cref="T:System.OperationCanceledException">
  47979. The operation was canceled via the cancellation token.
  47980. </exception>
  47981. <exception cref="T:System.IO.IOException">
  47982. An I/O error occurred.
  47983. </exception>
  47984. <exception cref="T:MailKit.ProtocolException">
  47985. The server's response contained unexpected tokens.
  47986. </exception>
  47987. <exception cref="T:MailKit.CommandException">
  47988. The command failed.
  47989. </exception>
  47990. </member>
  47991. <member name="M:MailKit.MailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  47992. <summary>
  47993. Asynchronously remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  47994. </summary>
  47995. <remarks>
  47996. Asynchronously removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  47997. </remarks>
  47998. <returns>The unique IDs of the messages that were not updated.</returns>
  47999. <param name="uids">The UIDs of the messages.</param>
  48000. <param name="modseq">The mod-sequence value.</param>
  48001. <param name="flags">The message flags to remove.</param>
  48002. <param name="keywords">A set of user-defined flags to remove.</param>
  48003. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48004. <param name="cancellationToken">The cancellation token.</param>
  48005. <exception cref="T:System.ArgumentNullException">
  48006. <paramref name="uids"/> is <c>null</c>.
  48007. </exception>
  48008. <exception cref="T:System.ArgumentException">
  48009. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  48010. <para>-or-</para>
  48011. <para>No flags were specified.</para>
  48012. </exception>
  48013. <exception cref="T:System.ObjectDisposedException">
  48014. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48015. </exception>
  48016. <exception cref="T:MailKit.ServiceNotConnectedException">
  48017. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48018. </exception>
  48019. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48020. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48021. </exception>
  48022. <exception cref="T:MailKit.FolderNotOpenException">
  48023. The folder is not currently open in read-write mode.
  48024. </exception>
  48025. <exception cref="T:System.NotSupportedException">
  48026. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  48027. </exception>
  48028. <exception cref="T:System.OperationCanceledException">
  48029. The operation was canceled via the cancellation token.
  48030. </exception>
  48031. <exception cref="T:System.IO.IOException">
  48032. An I/O error occurred.
  48033. </exception>
  48034. <exception cref="T:MailKit.ProtocolException">
  48035. The server's response contained unexpected tokens.
  48036. </exception>
  48037. <exception cref="T:MailKit.CommandException">
  48038. The command failed.
  48039. </exception>
  48040. </member>
  48041. <member name="M:MailKit.MailFolder.SetFlags(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  48042. <summary>
  48043. Set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  48044. </summary>
  48045. <remarks>
  48046. Sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  48047. </remarks>
  48048. <returns>The unique IDs of the messages that were not updated.</returns>
  48049. <param name="uids">The UIDs of the messages.</param>
  48050. <param name="modseq">The mod-sequence value.</param>
  48051. <param name="flags">The message flags to set.</param>
  48052. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48053. <param name="cancellationToken">The cancellation token.</param>
  48054. <exception cref="T:System.ArgumentNullException">
  48055. <paramref name="uids"/> is <c>null</c>.
  48056. </exception>
  48057. <exception cref="T:System.ArgumentException">
  48058. One or more of the <paramref name="uids"/> is invalid.
  48059. </exception>
  48060. <exception cref="T:System.ObjectDisposedException">
  48061. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48062. </exception>
  48063. <exception cref="T:MailKit.ServiceNotConnectedException">
  48064. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48065. </exception>
  48066. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48067. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48068. </exception>
  48069. <exception cref="T:MailKit.FolderNotOpenException">
  48070. The folder is not currently open in read-write mode.
  48071. </exception>
  48072. <exception cref="T:System.NotSupportedException">
  48073. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  48074. </exception>
  48075. <exception cref="T:System.OperationCanceledException">
  48076. The operation was canceled via the cancellation token.
  48077. </exception>
  48078. <exception cref="T:System.IO.IOException">
  48079. An I/O error occurred.
  48080. </exception>
  48081. <exception cref="T:MailKit.ProtocolException">
  48082. The server's response contained unexpected tokens.
  48083. </exception>
  48084. <exception cref="T:MailKit.CommandException">
  48085. The command failed.
  48086. </exception>
  48087. </member>
  48088. <member name="M:MailKit.MailFolder.SetFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  48089. <summary>
  48090. Asynchronously set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  48091. </summary>
  48092. <remarks>
  48093. Asynchronously sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  48094. </remarks>
  48095. <returns>The unique IDs of the messages that were not updated.</returns>
  48096. <param name="uids">The UIDs of the messages.</param>
  48097. <param name="modseq">The mod-sequence value.</param>
  48098. <param name="flags">The message flags to set.</param>
  48099. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48100. <param name="cancellationToken">The cancellation token.</param>
  48101. <exception cref="T:System.ArgumentNullException">
  48102. <paramref name="uids"/> is <c>null</c>.
  48103. </exception>
  48104. <exception cref="T:System.ArgumentException">
  48105. One or more of the <paramref name="uids"/> is invalid.
  48106. </exception>
  48107. <exception cref="T:System.ObjectDisposedException">
  48108. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48109. </exception>
  48110. <exception cref="T:MailKit.ServiceNotConnectedException">
  48111. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48112. </exception>
  48113. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48114. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48115. </exception>
  48116. <exception cref="T:MailKit.FolderNotOpenException">
  48117. The folder is not currently open in read-write mode.
  48118. </exception>
  48119. <exception cref="T:System.NotSupportedException">
  48120. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  48121. </exception>
  48122. <exception cref="T:System.OperationCanceledException">
  48123. The operation was canceled via the cancellation token.
  48124. </exception>
  48125. <exception cref="T:System.IO.IOException">
  48126. An I/O error occurred.
  48127. </exception>
  48128. <exception cref="T:MailKit.ProtocolException">
  48129. The server's response contained unexpected tokens.
  48130. </exception>
  48131. <exception cref="T:MailKit.CommandException">
  48132. The command failed.
  48133. </exception>
  48134. </member>
  48135. <member name="M:MailKit.MailFolder.SetFlags(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  48136. <summary>
  48137. Set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  48138. </summary>
  48139. <remarks>
  48140. Sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  48141. </remarks>
  48142. <returns>The unique IDs of the messages that were not updated.</returns>
  48143. <param name="uids">The UIDs of the messages.</param>
  48144. <param name="modseq">The mod-sequence value.</param>
  48145. <param name="flags">The message flags to set.</param>
  48146. <param name="keywords">A set of user-defined flags to set.</param>
  48147. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48148. <param name="cancellationToken">The cancellation token.</param>
  48149. <exception cref="T:System.ArgumentNullException">
  48150. <paramref name="uids"/> is <c>null</c>.
  48151. </exception>
  48152. <exception cref="T:System.ArgumentException">
  48153. One or more of the <paramref name="uids"/> is invalid.
  48154. </exception>
  48155. <exception cref="T:System.ObjectDisposedException">
  48156. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48157. </exception>
  48158. <exception cref="T:MailKit.ServiceNotConnectedException">
  48159. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48160. </exception>
  48161. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48162. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48163. </exception>
  48164. <exception cref="T:MailKit.FolderNotOpenException">
  48165. The folder is not currently open in read-write mode.
  48166. </exception>
  48167. <exception cref="T:System.NotSupportedException">
  48168. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  48169. </exception>
  48170. <exception cref="T:System.OperationCanceledException">
  48171. The operation was canceled via the cancellation token.
  48172. </exception>
  48173. <exception cref="T:System.IO.IOException">
  48174. An I/O error occurred.
  48175. </exception>
  48176. <exception cref="T:MailKit.ProtocolException">
  48177. The server's response contained unexpected tokens.
  48178. </exception>
  48179. <exception cref="T:MailKit.CommandException">
  48180. The command failed.
  48181. </exception>
  48182. </member>
  48183. <member name="M:MailKit.MailFolder.SetFlagsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  48184. <summary>
  48185. Asynchronously set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  48186. </summary>
  48187. <remarks>
  48188. Asynchronously sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  48189. </remarks>
  48190. <returns>The unique IDs of the messages that were not updated.</returns>
  48191. <param name="uids">The UIDs of the messages.</param>
  48192. <param name="modseq">The mod-sequence value.</param>
  48193. <param name="flags">The message flags to set.</param>
  48194. <param name="keywords">A set of user-defined flags to set.</param>
  48195. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48196. <param name="cancellationToken">The cancellation token.</param>
  48197. <exception cref="T:System.ArgumentNullException">
  48198. <paramref name="uids"/> is <c>null</c>.
  48199. </exception>
  48200. <exception cref="T:System.ArgumentException">
  48201. One or more of the <paramref name="uids"/> is invalid.
  48202. </exception>
  48203. <exception cref="T:System.ObjectDisposedException">
  48204. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48205. </exception>
  48206. <exception cref="T:MailKit.ServiceNotConnectedException">
  48207. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48208. </exception>
  48209. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48210. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48211. </exception>
  48212. <exception cref="T:MailKit.FolderNotOpenException">
  48213. The folder is not currently open in read-write mode.
  48214. </exception>
  48215. <exception cref="T:System.NotSupportedException">
  48216. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  48217. </exception>
  48218. <exception cref="T:System.OperationCanceledException">
  48219. The operation was canceled via the cancellation token.
  48220. </exception>
  48221. <exception cref="T:System.IO.IOException">
  48222. An I/O error occurred.
  48223. </exception>
  48224. <exception cref="T:MailKit.ProtocolException">
  48225. The server's response contained unexpected tokens.
  48226. </exception>
  48227. <exception cref="T:MailKit.CommandException">
  48228. The command failed.
  48229. </exception>
  48230. </member>
  48231. <member name="M:MailKit.MailFolder.AddFlags(System.Int32,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  48232. <summary>
  48233. Add a set of flags to the specified message.
  48234. </summary>
  48235. <remarks>
  48236. Adds a set of flags to the specified message.
  48237. </remarks>
  48238. <param name="index">The index of the message.</param>
  48239. <param name="flags">The message flags to add.</param>
  48240. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48241. <param name="cancellationToken">The cancellation token.</param>
  48242. <exception cref="T:System.ArgumentException">
  48243. <para><paramref name="index"/> is invalid.</para>
  48244. <para>-or-</para>
  48245. <para>No flags were specified.</para>
  48246. </exception>
  48247. <exception cref="T:System.ObjectDisposedException">
  48248. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48249. </exception>
  48250. <exception cref="T:MailKit.ServiceNotConnectedException">
  48251. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48252. </exception>
  48253. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48254. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48255. </exception>
  48256. <exception cref="T:MailKit.FolderNotOpenException">
  48257. The folder is not currently open in read-write mode.
  48258. </exception>
  48259. <exception cref="T:System.OperationCanceledException">
  48260. The operation was canceled via the cancellation token.
  48261. </exception>
  48262. <exception cref="T:System.IO.IOException">
  48263. An I/O error occurred.
  48264. </exception>
  48265. <exception cref="T:MailKit.ProtocolException">
  48266. The server's response contained unexpected tokens.
  48267. </exception>
  48268. <exception cref="T:MailKit.CommandException">
  48269. The command failed.
  48270. </exception>
  48271. </member>
  48272. <member name="M:MailKit.MailFolder.AddFlagsAsync(System.Int32,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  48273. <summary>
  48274. Asynchronously add a set of flags to the specified message.
  48275. </summary>
  48276. <remarks>
  48277. Asynchronously adds a set of flags to the specified message.
  48278. </remarks>
  48279. <returns>An asynchronous task context.</returns>
  48280. <param name="index">The index of the messages.</param>
  48281. <param name="flags">The message flags to add.</param>
  48282. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48283. <param name="cancellationToken">The cancellation token.</param>
  48284. <exception cref="T:System.ArgumentException">
  48285. <para><paramref name="index"/> is invalid.</para>
  48286. <para>-or-</para>
  48287. <para>No flags were specified.</para>
  48288. </exception>
  48289. <exception cref="T:System.ObjectDisposedException">
  48290. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48291. </exception>
  48292. <exception cref="T:MailKit.ServiceNotConnectedException">
  48293. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48294. </exception>
  48295. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48296. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48297. </exception>
  48298. <exception cref="T:MailKit.FolderNotOpenException">
  48299. The folder is not currently open in read-write mode.
  48300. </exception>
  48301. <exception cref="T:System.OperationCanceledException">
  48302. The operation was canceled via the cancellation token.
  48303. </exception>
  48304. <exception cref="T:System.IO.IOException">
  48305. An I/O error occurred.
  48306. </exception>
  48307. <exception cref="T:MailKit.ProtocolException">
  48308. The server's response contained unexpected tokens.
  48309. </exception>
  48310. <exception cref="T:MailKit.CommandException">
  48311. The command failed.
  48312. </exception>
  48313. </member>
  48314. <member name="M:MailKit.MailFolder.AddFlags(System.Int32,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  48315. <summary>
  48316. Add a set of flags to the specified message.
  48317. </summary>
  48318. <remarks>
  48319. Adds a set of flags to the specified message.
  48320. </remarks>
  48321. <param name="index">The index of the message.</param>
  48322. <param name="flags">The message flags to add.</param>
  48323. <param name="keywords">A set of user-defined flags to add.</param>
  48324. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48325. <param name="cancellationToken">The cancellation token.</param>
  48326. <exception cref="T:System.ArgumentException">
  48327. <para><paramref name="index"/> is invalid.</para>
  48328. <para>-or-</para>
  48329. <para>No flags were specified.</para>
  48330. </exception>
  48331. <exception cref="T:System.ObjectDisposedException">
  48332. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48333. </exception>
  48334. <exception cref="T:MailKit.ServiceNotConnectedException">
  48335. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48336. </exception>
  48337. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48338. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48339. </exception>
  48340. <exception cref="T:MailKit.FolderNotOpenException">
  48341. The folder is not currently open in read-write mode.
  48342. </exception>
  48343. <exception cref="T:System.OperationCanceledException">
  48344. The operation was canceled via the cancellation token.
  48345. </exception>
  48346. <exception cref="T:System.IO.IOException">
  48347. An I/O error occurred.
  48348. </exception>
  48349. <exception cref="T:MailKit.ProtocolException">
  48350. The server's response contained unexpected tokens.
  48351. </exception>
  48352. <exception cref="T:MailKit.CommandException">
  48353. The command failed.
  48354. </exception>
  48355. </member>
  48356. <member name="M:MailKit.MailFolder.AddFlagsAsync(System.Int32,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  48357. <summary>
  48358. Asynchronously add a set of flags to the specified message.
  48359. </summary>
  48360. <remarks>
  48361. Asynchronously adds a set of flags to the specified message.
  48362. </remarks>
  48363. <returns>An asynchronous task context.</returns>
  48364. <param name="index">The index of the messages.</param>
  48365. <param name="flags">The message flags to add.</param>
  48366. <param name="keywords">A set of user-defined flags to add.</param>
  48367. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48368. <param name="cancellationToken">The cancellation token.</param>
  48369. <exception cref="T:System.ArgumentException">
  48370. <para><paramref name="index"/> is invalid.</para>
  48371. <para>-or-</para>
  48372. <para>No flags were specified.</para>
  48373. </exception>
  48374. <exception cref="T:System.ObjectDisposedException">
  48375. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48376. </exception>
  48377. <exception cref="T:MailKit.ServiceNotConnectedException">
  48378. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48379. </exception>
  48380. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48381. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48382. </exception>
  48383. <exception cref="T:MailKit.FolderNotOpenException">
  48384. The folder is not currently open in read-write mode.
  48385. </exception>
  48386. <exception cref="T:System.OperationCanceledException">
  48387. The operation was canceled via the cancellation token.
  48388. </exception>
  48389. <exception cref="T:System.IO.IOException">
  48390. An I/O error occurred.
  48391. </exception>
  48392. <exception cref="T:MailKit.ProtocolException">
  48393. The server's response contained unexpected tokens.
  48394. </exception>
  48395. <exception cref="T:MailKit.CommandException">
  48396. The command failed.
  48397. </exception>
  48398. </member>
  48399. <member name="M:MailKit.MailFolder.AddFlags(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  48400. <summary>
  48401. Add a set of flags to the specified messages.
  48402. </summary>
  48403. <remarks>
  48404. Adds a set of flags to the specified messages.
  48405. </remarks>
  48406. <param name="indexes">The indexes of the messages.</param>
  48407. <param name="flags">The message flags to add.</param>
  48408. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48409. <param name="cancellationToken">The cancellation token.</param>
  48410. <exception cref="T:System.ArgumentNullException">
  48411. <paramref name="indexes"/> is <c>null</c>.
  48412. </exception>
  48413. <exception cref="T:System.ArgumentException">
  48414. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  48415. <para>-or-</para>
  48416. <para>No flags were specified.</para>
  48417. </exception>
  48418. <exception cref="T:System.ObjectDisposedException">
  48419. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48420. </exception>
  48421. <exception cref="T:MailKit.ServiceNotConnectedException">
  48422. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48423. </exception>
  48424. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48425. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48426. </exception>
  48427. <exception cref="T:MailKit.FolderNotOpenException">
  48428. The folder is not currently open in read-write mode.
  48429. </exception>
  48430. <exception cref="T:System.OperationCanceledException">
  48431. The operation was canceled via the cancellation token.
  48432. </exception>
  48433. <exception cref="T:System.IO.IOException">
  48434. An I/O error occurred.
  48435. </exception>
  48436. <exception cref="T:MailKit.ProtocolException">
  48437. The server's response contained unexpected tokens.
  48438. </exception>
  48439. <exception cref="T:MailKit.CommandException">
  48440. The command failed.
  48441. </exception>
  48442. </member>
  48443. <member name="M:MailKit.MailFolder.AddFlagsAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  48444. <summary>
  48445. Asynchronously add a set of flags to the specified messages.
  48446. </summary>
  48447. <remarks>
  48448. Asynchronously adds a set of flags to the specified messages.
  48449. </remarks>
  48450. <returns>An asynchronous task context.</returns>
  48451. <param name="indexes">The indexes of the messages.</param>
  48452. <param name="flags">The message flags to add.</param>
  48453. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48454. <param name="cancellationToken">The cancellation token.</param>
  48455. <exception cref="T:System.ArgumentNullException">
  48456. <paramref name="indexes"/> is <c>null</c>.
  48457. </exception>
  48458. <exception cref="T:System.ArgumentException">
  48459. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  48460. <para>-or-</para>
  48461. <para>No flags were specified.</para>
  48462. </exception>
  48463. <exception cref="T:System.ObjectDisposedException">
  48464. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48465. </exception>
  48466. <exception cref="T:MailKit.ServiceNotConnectedException">
  48467. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48468. </exception>
  48469. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48470. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48471. </exception>
  48472. <exception cref="T:MailKit.FolderNotOpenException">
  48473. The folder is not currently open in read-write mode.
  48474. </exception>
  48475. <exception cref="T:System.OperationCanceledException">
  48476. The operation was canceled via the cancellation token.
  48477. </exception>
  48478. <exception cref="T:System.IO.IOException">
  48479. An I/O error occurred.
  48480. </exception>
  48481. <exception cref="T:MailKit.ProtocolException">
  48482. The server's response contained unexpected tokens.
  48483. </exception>
  48484. <exception cref="T:MailKit.CommandException">
  48485. The command failed.
  48486. </exception>
  48487. </member>
  48488. <member name="M:MailKit.MailFolder.AddFlags(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  48489. <summary>
  48490. Add a set of flags to the specified messages.
  48491. </summary>
  48492. <remarks>
  48493. Adds a set of flags to the specified messages.
  48494. </remarks>
  48495. <param name="indexes">The indexes of the messages.</param>
  48496. <param name="flags">The message flags to add.</param>
  48497. <param name="keywords">A set of user-defined flags to add.</param>
  48498. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48499. <param name="cancellationToken">The cancellation token.</param>
  48500. <exception cref="T:System.ArgumentNullException">
  48501. <paramref name="indexes"/> is <c>null</c>.
  48502. </exception>
  48503. <exception cref="T:System.ArgumentException">
  48504. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  48505. <para>-or-</para>
  48506. <para>No flags were specified.</para>
  48507. </exception>
  48508. <exception cref="T:System.ObjectDisposedException">
  48509. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48510. </exception>
  48511. <exception cref="T:MailKit.ServiceNotConnectedException">
  48512. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48513. </exception>
  48514. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48515. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48516. </exception>
  48517. <exception cref="T:MailKit.FolderNotOpenException">
  48518. The folder is not currently open in read-write mode.
  48519. </exception>
  48520. <exception cref="T:System.OperationCanceledException">
  48521. The operation was canceled via the cancellation token.
  48522. </exception>
  48523. <exception cref="T:System.IO.IOException">
  48524. An I/O error occurred.
  48525. </exception>
  48526. <exception cref="T:MailKit.ProtocolException">
  48527. The server's response contained unexpected tokens.
  48528. </exception>
  48529. <exception cref="T:MailKit.CommandException">
  48530. The command failed.
  48531. </exception>
  48532. </member>
  48533. <member name="M:MailKit.MailFolder.AddFlagsAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  48534. <summary>
  48535. Asynchronously add a set of flags to the specified messages.
  48536. </summary>
  48537. <remarks>
  48538. Asynchronously adds a set of flags to the specified messages.
  48539. </remarks>
  48540. <returns>An asynchronous task context.</returns>
  48541. <param name="indexes">The indexes of the messages.</param>
  48542. <param name="flags">The message flags to add.</param>
  48543. <param name="keywords">A set of user-defined flags to add.</param>
  48544. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48545. <param name="cancellationToken">The cancellation token.</param>
  48546. <exception cref="T:System.ArgumentNullException">
  48547. <paramref name="indexes"/> is <c>null</c>.
  48548. </exception>
  48549. <exception cref="T:System.ArgumentException">
  48550. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  48551. <para>-or-</para>
  48552. <para>No flags were specified.</para>
  48553. </exception>
  48554. <exception cref="T:System.ObjectDisposedException">
  48555. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48556. </exception>
  48557. <exception cref="T:MailKit.ServiceNotConnectedException">
  48558. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48559. </exception>
  48560. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48561. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48562. </exception>
  48563. <exception cref="T:MailKit.FolderNotOpenException">
  48564. The folder is not currently open in read-write mode.
  48565. </exception>
  48566. <exception cref="T:System.OperationCanceledException">
  48567. The operation was canceled via the cancellation token.
  48568. </exception>
  48569. <exception cref="T:System.IO.IOException">
  48570. An I/O error occurred.
  48571. </exception>
  48572. <exception cref="T:MailKit.ProtocolException">
  48573. The server's response contained unexpected tokens.
  48574. </exception>
  48575. <exception cref="T:MailKit.CommandException">
  48576. The command failed.
  48577. </exception>
  48578. </member>
  48579. <member name="M:MailKit.MailFolder.RemoveFlags(System.Int32,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  48580. <summary>
  48581. Remove a set of flags from the specified message.
  48582. </summary>
  48583. <remarks>
  48584. Removes a set of flags from the specified message.
  48585. </remarks>
  48586. <param name="index">The index of the message.</param>
  48587. <param name="flags">The message flags to remove.</param>
  48588. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48589. <param name="cancellationToken">The cancellation token.</param>
  48590. <exception cref="T:System.ArgumentException">
  48591. <para><paramref name="index"/> is invalid.</para>
  48592. <para>-or-</para>
  48593. <para>No flags were specified.</para>
  48594. </exception>
  48595. <exception cref="T:System.ObjectDisposedException">
  48596. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48597. </exception>
  48598. <exception cref="T:MailKit.ServiceNotConnectedException">
  48599. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48600. </exception>
  48601. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48602. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48603. </exception>
  48604. <exception cref="T:MailKit.FolderNotOpenException">
  48605. The folder is not currently open in read-write mode.
  48606. </exception>
  48607. <exception cref="T:System.OperationCanceledException">
  48608. The operation was canceled via the cancellation token.
  48609. </exception>
  48610. <exception cref="T:System.IO.IOException">
  48611. An I/O error occurred.
  48612. </exception>
  48613. <exception cref="T:MailKit.ProtocolException">
  48614. The server's response contained unexpected tokens.
  48615. </exception>
  48616. <exception cref="T:MailKit.CommandException">
  48617. The command failed.
  48618. </exception>
  48619. </member>
  48620. <member name="M:MailKit.MailFolder.RemoveFlagsAsync(System.Int32,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  48621. <summary>
  48622. Asynchronously remove a set of flags from the specified message.
  48623. </summary>
  48624. <remarks>
  48625. Asynchronously removes a set of flags from the specified message.
  48626. </remarks>
  48627. <returns>An asynchronous task context.</returns>
  48628. <param name="index">The index of the message.</param>
  48629. <param name="flags">The message flags to remove.</param>
  48630. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48631. <param name="cancellationToken">The cancellation token.</param>
  48632. <exception cref="T:System.ArgumentException">
  48633. <para><paramref name="index"/> is invalid.</para>
  48634. <para>-or-</para>
  48635. <para>No flags were specified.</para>
  48636. </exception>
  48637. <exception cref="T:System.ObjectDisposedException">
  48638. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48639. </exception>
  48640. <exception cref="T:MailKit.ServiceNotConnectedException">
  48641. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48642. </exception>
  48643. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48644. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48645. </exception>
  48646. <exception cref="T:MailKit.FolderNotOpenException">
  48647. The folder is not currently open in read-write mode.
  48648. </exception>
  48649. <exception cref="T:System.OperationCanceledException">
  48650. The operation was canceled via the cancellation token.
  48651. </exception>
  48652. <exception cref="T:System.IO.IOException">
  48653. An I/O error occurred.
  48654. </exception>
  48655. <exception cref="T:MailKit.ProtocolException">
  48656. The server's response contained unexpected tokens.
  48657. </exception>
  48658. <exception cref="T:MailKit.CommandException">
  48659. The command failed.
  48660. </exception>
  48661. </member>
  48662. <member name="M:MailKit.MailFolder.RemoveFlags(System.Int32,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  48663. <summary>
  48664. Remove a set of flags from the specified message.
  48665. </summary>
  48666. <remarks>
  48667. Removes a set of flags from the specified message.
  48668. </remarks>
  48669. <param name="index">The index of the message.</param>
  48670. <param name="flags">The message flags to remove.</param>
  48671. <param name="keywords">A set of user-defined flags to remove.</param>
  48672. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48673. <param name="cancellationToken">The cancellation token.</param>
  48674. <exception cref="T:System.ArgumentException">
  48675. <para><paramref name="index"/> is invalid.</para>
  48676. <para>-or-</para>
  48677. <para>No flags were specified.</para>
  48678. </exception>
  48679. <exception cref="T:System.ObjectDisposedException">
  48680. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48681. </exception>
  48682. <exception cref="T:MailKit.ServiceNotConnectedException">
  48683. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48684. </exception>
  48685. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48686. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48687. </exception>
  48688. <exception cref="T:MailKit.FolderNotOpenException">
  48689. The folder is not currently open in read-write mode.
  48690. </exception>
  48691. <exception cref="T:System.OperationCanceledException">
  48692. The operation was canceled via the cancellation token.
  48693. </exception>
  48694. <exception cref="T:System.IO.IOException">
  48695. An I/O error occurred.
  48696. </exception>
  48697. <exception cref="T:MailKit.ProtocolException">
  48698. The server's response contained unexpected tokens.
  48699. </exception>
  48700. <exception cref="T:MailKit.CommandException">
  48701. The command failed.
  48702. </exception>
  48703. </member>
  48704. <member name="M:MailKit.MailFolder.RemoveFlagsAsync(System.Int32,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  48705. <summary>
  48706. Asynchronously remove a set of flags from the specified message.
  48707. </summary>
  48708. <remarks>
  48709. Asynchronously removes a set of flags from the specified message.
  48710. </remarks>
  48711. <returns>An asynchronous task context.</returns>
  48712. <param name="index">The index of the message.</param>
  48713. <param name="flags">The message flags to remove.</param>
  48714. <param name="keywords">A set of user-defined flags to remove.</param>
  48715. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48716. <param name="cancellationToken">The cancellation token.</param>
  48717. <exception cref="T:System.ArgumentException">
  48718. <para><paramref name="index"/> is invalid.</para>
  48719. <para>-or-</para>
  48720. <para>No flags were specified.</para>
  48721. </exception>
  48722. <exception cref="T:System.ObjectDisposedException">
  48723. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48724. </exception>
  48725. <exception cref="T:MailKit.ServiceNotConnectedException">
  48726. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48727. </exception>
  48728. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48729. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48730. </exception>
  48731. <exception cref="T:MailKit.FolderNotOpenException">
  48732. The folder is not currently open in read-write mode.
  48733. </exception>
  48734. <exception cref="T:System.OperationCanceledException">
  48735. The operation was canceled via the cancellation token.
  48736. </exception>
  48737. <exception cref="T:System.IO.IOException">
  48738. An I/O error occurred.
  48739. </exception>
  48740. <exception cref="T:MailKit.ProtocolException">
  48741. The server's response contained unexpected tokens.
  48742. </exception>
  48743. <exception cref="T:MailKit.CommandException">
  48744. The command failed.
  48745. </exception>
  48746. </member>
  48747. <member name="M:MailKit.MailFolder.RemoveFlags(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  48748. <summary>
  48749. Remove a set of flags from the specified messages.
  48750. </summary>
  48751. <remarks>
  48752. Removes a set of flags from the specified messages.
  48753. </remarks>
  48754. <param name="indexes">The indexes of the messages.</param>
  48755. <param name="flags">The message flags to remove.</param>
  48756. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48757. <param name="cancellationToken">The cancellation token.</param>
  48758. <exception cref="T:System.ArgumentNullException">
  48759. <paramref name="indexes"/> is <c>null</c>.
  48760. </exception>
  48761. <exception cref="T:System.ArgumentException">
  48762. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  48763. <para>-or-</para>
  48764. <para>No flags were specified.</para>
  48765. </exception>
  48766. <exception cref="T:System.ObjectDisposedException">
  48767. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48768. </exception>
  48769. <exception cref="T:MailKit.ServiceNotConnectedException">
  48770. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48771. </exception>
  48772. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48773. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48774. </exception>
  48775. <exception cref="T:MailKit.FolderNotOpenException">
  48776. The folder is not currently open in read-write mode.
  48777. </exception>
  48778. <exception cref="T:System.OperationCanceledException">
  48779. The operation was canceled via the cancellation token.
  48780. </exception>
  48781. <exception cref="T:System.IO.IOException">
  48782. An I/O error occurred.
  48783. </exception>
  48784. <exception cref="T:MailKit.ProtocolException">
  48785. The server's response contained unexpected tokens.
  48786. </exception>
  48787. <exception cref="T:MailKit.CommandException">
  48788. The command failed.
  48789. </exception>
  48790. </member>
  48791. <member name="M:MailKit.MailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  48792. <summary>
  48793. Asynchronously remove a set of flags from the specified messages.
  48794. </summary>
  48795. <remarks>
  48796. Asynchronously removes a set of flags from the specified messages.
  48797. </remarks>
  48798. <returns>An asynchronous task context.</returns>
  48799. <param name="indexes">The indexes of the messages.</param>
  48800. <param name="flags">The message flags to remove.</param>
  48801. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48802. <param name="cancellationToken">The cancellation token.</param>
  48803. <exception cref="T:System.ArgumentNullException">
  48804. <paramref name="indexes"/> is <c>null</c>.
  48805. </exception>
  48806. <exception cref="T:System.ArgumentException">
  48807. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  48808. <para>-or-</para>
  48809. <para>No flags were specified.</para>
  48810. </exception>
  48811. <exception cref="T:System.ObjectDisposedException">
  48812. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48813. </exception>
  48814. <exception cref="T:MailKit.ServiceNotConnectedException">
  48815. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48816. </exception>
  48817. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48818. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48819. </exception>
  48820. <exception cref="T:MailKit.FolderNotOpenException">
  48821. The folder is not currently open in read-write mode.
  48822. </exception>
  48823. <exception cref="T:System.OperationCanceledException">
  48824. The operation was canceled via the cancellation token.
  48825. </exception>
  48826. <exception cref="T:System.IO.IOException">
  48827. An I/O error occurred.
  48828. </exception>
  48829. <exception cref="T:MailKit.ProtocolException">
  48830. The server's response contained unexpected tokens.
  48831. </exception>
  48832. <exception cref="T:MailKit.CommandException">
  48833. The command failed.
  48834. </exception>
  48835. </member>
  48836. <member name="M:MailKit.MailFolder.RemoveFlags(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  48837. <summary>
  48838. Remove a set of flags from the specified messages.
  48839. </summary>
  48840. <remarks>
  48841. Removes a set of flags from the specified messages.
  48842. </remarks>
  48843. <param name="indexes">The indexes of the messages.</param>
  48844. <param name="flags">The message flags to remove.</param>
  48845. <param name="keywords">A set of user-defined flags to remove.</param>
  48846. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48847. <param name="cancellationToken">The cancellation token.</param>
  48848. <exception cref="T:System.ArgumentNullException">
  48849. <paramref name="indexes"/> is <c>null</c>.
  48850. </exception>
  48851. <exception cref="T:System.ArgumentException">
  48852. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  48853. <para>-or-</para>
  48854. <para>No flags were specified.</para>
  48855. </exception>
  48856. <exception cref="T:System.ObjectDisposedException">
  48857. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48858. </exception>
  48859. <exception cref="T:MailKit.ServiceNotConnectedException">
  48860. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48861. </exception>
  48862. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48863. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48864. </exception>
  48865. <exception cref="T:MailKit.FolderNotOpenException">
  48866. The folder is not currently open in read-write mode.
  48867. </exception>
  48868. <exception cref="T:System.OperationCanceledException">
  48869. The operation was canceled via the cancellation token.
  48870. </exception>
  48871. <exception cref="T:System.IO.IOException">
  48872. An I/O error occurred.
  48873. </exception>
  48874. <exception cref="T:MailKit.ProtocolException">
  48875. The server's response contained unexpected tokens.
  48876. </exception>
  48877. <exception cref="T:MailKit.CommandException">
  48878. The command failed.
  48879. </exception>
  48880. </member>
  48881. <member name="M:MailKit.MailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  48882. <summary>
  48883. Asynchronously remove a set of flags from the specified messages.
  48884. </summary>
  48885. <remarks>
  48886. Asynchronously removes a set of flags from the specified messages.
  48887. </remarks>
  48888. <returns>An asynchronous task context.</returns>
  48889. <param name="indexes">The indexes of the messages.</param>
  48890. <param name="flags">The message flags to remove.</param>
  48891. <param name="keywords">A set of user-defined flags to remove.</param>
  48892. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48893. <param name="cancellationToken">The cancellation token.</param>
  48894. <exception cref="T:System.ArgumentNullException">
  48895. <paramref name="indexes"/> is <c>null</c>.
  48896. </exception>
  48897. <exception cref="T:System.ArgumentException">
  48898. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  48899. <para>-or-</para>
  48900. <para>No flags were specified.</para>
  48901. </exception>
  48902. <exception cref="T:System.ObjectDisposedException">
  48903. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48904. </exception>
  48905. <exception cref="T:MailKit.ServiceNotConnectedException">
  48906. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48907. </exception>
  48908. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48909. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48910. </exception>
  48911. <exception cref="T:MailKit.FolderNotOpenException">
  48912. The folder is not currently open in read-write mode.
  48913. </exception>
  48914. <exception cref="T:System.OperationCanceledException">
  48915. The operation was canceled via the cancellation token.
  48916. </exception>
  48917. <exception cref="T:System.IO.IOException">
  48918. An I/O error occurred.
  48919. </exception>
  48920. <exception cref="T:MailKit.ProtocolException">
  48921. The server's response contained unexpected tokens.
  48922. </exception>
  48923. <exception cref="T:MailKit.CommandException">
  48924. The command failed.
  48925. </exception>
  48926. </member>
  48927. <member name="M:MailKit.MailFolder.SetFlags(System.Int32,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  48928. <summary>
  48929. Set the flags of the specified message.
  48930. </summary>
  48931. <remarks>
  48932. Sets the flags of the specified message.
  48933. </remarks>
  48934. <param name="index">The index of the message.</param>
  48935. <param name="flags">The message flags to set.</param>
  48936. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48937. <param name="cancellationToken">The cancellation token.</param>
  48938. <exception cref="T:System.ArgumentException">
  48939. <para><paramref name="index"/> is invalid.</para>
  48940. </exception>
  48941. <exception cref="T:System.ObjectDisposedException">
  48942. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48943. </exception>
  48944. <exception cref="T:MailKit.ServiceNotConnectedException">
  48945. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48946. </exception>
  48947. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48948. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48949. </exception>
  48950. <exception cref="T:MailKit.FolderNotOpenException">
  48951. The folder is not currently open in read-write mode.
  48952. </exception>
  48953. <exception cref="T:System.OperationCanceledException">
  48954. The operation was canceled via the cancellation token.
  48955. </exception>
  48956. <exception cref="T:System.IO.IOException">
  48957. An I/O error occurred.
  48958. </exception>
  48959. <exception cref="T:MailKit.ProtocolException">
  48960. The server's response contained unexpected tokens.
  48961. </exception>
  48962. <exception cref="T:MailKit.CommandException">
  48963. The command failed.
  48964. </exception>
  48965. </member>
  48966. <member name="M:MailKit.MailFolder.SetFlagsAsync(System.Int32,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  48967. <summary>
  48968. Asynchronously set the flags of the specified message.
  48969. </summary>
  48970. <remarks>
  48971. Asynchronously sets the flags of the specified message.
  48972. </remarks>
  48973. <returns>An asynchronous task context.</returns>
  48974. <param name="index">The index of the message.</param>
  48975. <param name="flags">The message flags to set.</param>
  48976. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  48977. <param name="cancellationToken">The cancellation token.</param>
  48978. <exception cref="T:System.ArgumentException">
  48979. <para><paramref name="index"/> is invalid.</para>
  48980. </exception>
  48981. <exception cref="T:System.ObjectDisposedException">
  48982. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  48983. </exception>
  48984. <exception cref="T:MailKit.ServiceNotConnectedException">
  48985. The <see cref="T:MailKit.IMailStore"/> is not connected.
  48986. </exception>
  48987. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  48988. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  48989. </exception>
  48990. <exception cref="T:MailKit.FolderNotOpenException">
  48991. The folder is not currently open in read-write mode.
  48992. </exception>
  48993. <exception cref="T:System.OperationCanceledException">
  48994. The operation was canceled via the cancellation token.
  48995. </exception>
  48996. <exception cref="T:System.IO.IOException">
  48997. An I/O error occurred.
  48998. </exception>
  48999. <exception cref="T:MailKit.ProtocolException">
  49000. The server's response contained unexpected tokens.
  49001. </exception>
  49002. <exception cref="T:MailKit.CommandException">
  49003. The command failed.
  49004. </exception>
  49005. </member>
  49006. <member name="M:MailKit.MailFolder.SetFlags(System.Int32,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  49007. <summary>
  49008. Set the flags of the specified message.
  49009. </summary>
  49010. <remarks>
  49011. Sets the flags of the specified message.
  49012. </remarks>
  49013. <param name="index">The index of the message.</param>
  49014. <param name="flags">The message flags to set.</param>
  49015. <param name="keywords">A set of user-defined flags to set.</param>
  49016. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49017. <param name="cancellationToken">The cancellation token.</param>
  49018. <exception cref="T:System.ArgumentException">
  49019. <para><paramref name="index"/> is invalid.</para>
  49020. </exception>
  49021. <exception cref="T:System.ObjectDisposedException">
  49022. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49023. </exception>
  49024. <exception cref="T:MailKit.ServiceNotConnectedException">
  49025. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49026. </exception>
  49027. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49028. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49029. </exception>
  49030. <exception cref="T:MailKit.FolderNotOpenException">
  49031. The folder is not currently open in read-write mode.
  49032. </exception>
  49033. <exception cref="T:System.OperationCanceledException">
  49034. The operation was canceled via the cancellation token.
  49035. </exception>
  49036. <exception cref="T:System.IO.IOException">
  49037. An I/O error occurred.
  49038. </exception>
  49039. <exception cref="T:MailKit.ProtocolException">
  49040. The server's response contained unexpected tokens.
  49041. </exception>
  49042. <exception cref="T:MailKit.CommandException">
  49043. The command failed.
  49044. </exception>
  49045. </member>
  49046. <member name="M:MailKit.MailFolder.SetFlagsAsync(System.Int32,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  49047. <summary>
  49048. Asynchronously set the flags of the specified message.
  49049. </summary>
  49050. <remarks>
  49051. Asynchronously sets the flags of the specified message.
  49052. </remarks>
  49053. <returns>An asynchronous task context.</returns>
  49054. <param name="index">The index of the message.</param>
  49055. <param name="flags">The message flags to set.</param>
  49056. <param name="keywords">A set of user-defined flags to set.</param>
  49057. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49058. <param name="cancellationToken">The cancellation token.</param>
  49059. <exception cref="T:System.ArgumentException">
  49060. <para><paramref name="index"/> is invalid.</para>
  49061. </exception>
  49062. <exception cref="T:System.ObjectDisposedException">
  49063. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49064. </exception>
  49065. <exception cref="T:MailKit.ServiceNotConnectedException">
  49066. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49067. </exception>
  49068. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49069. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49070. </exception>
  49071. <exception cref="T:MailKit.FolderNotOpenException">
  49072. The folder is not currently open in read-write mode.
  49073. </exception>
  49074. <exception cref="T:System.OperationCanceledException">
  49075. The operation was canceled via the cancellation token.
  49076. </exception>
  49077. <exception cref="T:System.IO.IOException">
  49078. An I/O error occurred.
  49079. </exception>
  49080. <exception cref="T:MailKit.ProtocolException">
  49081. The server's response contained unexpected tokens.
  49082. </exception>
  49083. <exception cref="T:MailKit.CommandException">
  49084. The command failed.
  49085. </exception>
  49086. </member>
  49087. <member name="M:MailKit.MailFolder.SetFlags(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  49088. <summary>
  49089. Set the flags of the specified messages.
  49090. </summary>
  49091. <remarks>
  49092. Sets the flags of the specified messages.
  49093. </remarks>
  49094. <param name="indexes">The indexes of the messages.</param>
  49095. <param name="flags">The message flags to set.</param>
  49096. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49097. <param name="cancellationToken">The cancellation token.</param>
  49098. <exception cref="T:System.ArgumentNullException">
  49099. <paramref name="indexes"/> is <c>null</c>.
  49100. </exception>
  49101. <exception cref="T:System.ArgumentException">
  49102. One or more of the <paramref name="indexes"/> is invalid.
  49103. </exception>
  49104. <exception cref="T:System.ObjectDisposedException">
  49105. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49106. </exception>
  49107. <exception cref="T:MailKit.ServiceNotConnectedException">
  49108. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49109. </exception>
  49110. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49111. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49112. </exception>
  49113. <exception cref="T:MailKit.FolderNotOpenException">
  49114. The folder is not currently open in read-write mode.
  49115. </exception>
  49116. <exception cref="T:System.OperationCanceledException">
  49117. The operation was canceled via the cancellation token.
  49118. </exception>
  49119. <exception cref="T:System.IO.IOException">
  49120. An I/O error occurred.
  49121. </exception>
  49122. <exception cref="T:MailKit.ProtocolException">
  49123. The server's response contained unexpected tokens.
  49124. </exception>
  49125. <exception cref="T:MailKit.CommandException">
  49126. The command failed.
  49127. </exception>
  49128. </member>
  49129. <member name="M:MailKit.MailFolder.SetFlagsAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  49130. <summary>
  49131. Asynchronously set the flags of the specified messages.
  49132. </summary>
  49133. <remarks>
  49134. Asynchronously sets the flags of the specified messages.
  49135. </remarks>
  49136. <returns>An asynchronous task context.</returns>
  49137. <param name="indexes">The indexes of the messages.</param>
  49138. <param name="flags">The message flags to set.</param>
  49139. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49140. <param name="cancellationToken">The cancellation token.</param>
  49141. <exception cref="T:System.ArgumentNullException">
  49142. <paramref name="indexes"/> is <c>null</c>.
  49143. </exception>
  49144. <exception cref="T:System.ArgumentException">
  49145. One or more of the <paramref name="indexes"/> is invalid.
  49146. </exception>
  49147. <exception cref="T:System.ObjectDisposedException">
  49148. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49149. </exception>
  49150. <exception cref="T:MailKit.ServiceNotConnectedException">
  49151. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49152. </exception>
  49153. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49154. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49155. </exception>
  49156. <exception cref="T:MailKit.FolderNotOpenException">
  49157. The folder is not currently open in read-write mode.
  49158. </exception>
  49159. <exception cref="T:System.OperationCanceledException">
  49160. The operation was canceled via the cancellation token.
  49161. </exception>
  49162. <exception cref="T:System.IO.IOException">
  49163. An I/O error occurred.
  49164. </exception>
  49165. <exception cref="T:MailKit.ProtocolException">
  49166. The server's response contained unexpected tokens.
  49167. </exception>
  49168. <exception cref="T:MailKit.CommandException">
  49169. The command failed.
  49170. </exception>
  49171. </member>
  49172. <member name="M:MailKit.MailFolder.SetFlags(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  49173. <summary>
  49174. Set the flags of the specified messages.
  49175. </summary>
  49176. <remarks>
  49177. Sets the flags of the specified messages.
  49178. </remarks>
  49179. <param name="indexes">The indexes of the messages.</param>
  49180. <param name="flags">The message flags to set.</param>
  49181. <param name="keywords">A set of user-defined flags to set.</param>
  49182. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49183. <param name="cancellationToken">The cancellation token.</param>
  49184. <exception cref="T:System.ArgumentNullException">
  49185. <paramref name="indexes"/> is <c>null</c>.
  49186. </exception>
  49187. <exception cref="T:System.ArgumentException">
  49188. One or more of the <paramref name="indexes"/> is invalid.
  49189. </exception>
  49190. <exception cref="T:System.ObjectDisposedException">
  49191. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49192. </exception>
  49193. <exception cref="T:MailKit.ServiceNotConnectedException">
  49194. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49195. </exception>
  49196. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49197. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49198. </exception>
  49199. <exception cref="T:MailKit.FolderNotOpenException">
  49200. The folder is not currently open in read-write mode.
  49201. </exception>
  49202. <exception cref="T:System.OperationCanceledException">
  49203. The operation was canceled via the cancellation token.
  49204. </exception>
  49205. <exception cref="T:System.IO.IOException">
  49206. An I/O error occurred.
  49207. </exception>
  49208. <exception cref="T:MailKit.ProtocolException">
  49209. The server's response contained unexpected tokens.
  49210. </exception>
  49211. <exception cref="T:MailKit.CommandException">
  49212. The command failed.
  49213. </exception>
  49214. </member>
  49215. <member name="M:MailKit.MailFolder.SetFlagsAsync(System.Collections.Generic.IList{System.Int32},MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  49216. <summary>
  49217. Asynchronously set the flags of the specified messages.
  49218. </summary>
  49219. <remarks>
  49220. Asynchronously sets the flags of the specified messages.
  49221. </remarks>
  49222. <returns>An asynchronous task context.</returns>
  49223. <param name="indexes">The indexes of the messages.</param>
  49224. <param name="flags">The message flags to set.</param>
  49225. <param name="keywords">A set of user-defined flags to set.</param>
  49226. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49227. <param name="cancellationToken">The cancellation token.</param>
  49228. <exception cref="T:System.ArgumentNullException">
  49229. <paramref name="indexes"/> is <c>null</c>.
  49230. </exception>
  49231. <exception cref="T:System.ArgumentException">
  49232. One or more of the <paramref name="indexes"/> is invalid.
  49233. </exception>
  49234. <exception cref="T:System.ObjectDisposedException">
  49235. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49236. </exception>
  49237. <exception cref="T:MailKit.ServiceNotConnectedException">
  49238. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49239. </exception>
  49240. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49241. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49242. </exception>
  49243. <exception cref="T:MailKit.FolderNotOpenException">
  49244. The folder is not currently open in read-write mode.
  49245. </exception>
  49246. <exception cref="T:System.OperationCanceledException">
  49247. The operation was canceled via the cancellation token.
  49248. </exception>
  49249. <exception cref="T:System.IO.IOException">
  49250. An I/O error occurred.
  49251. </exception>
  49252. <exception cref="T:MailKit.ProtocolException">
  49253. The server's response contained unexpected tokens.
  49254. </exception>
  49255. <exception cref="T:MailKit.CommandException">
  49256. The command failed.
  49257. </exception>
  49258. </member>
  49259. <member name="M:MailKit.MailFolder.AddFlags(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  49260. <summary>
  49261. Add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  49262. </summary>
  49263. <remarks>
  49264. Adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  49265. </remarks>
  49266. <returns>The indexes of the messages that were not updated.</returns>
  49267. <param name="indexes">The indexes of the messages.</param>
  49268. <param name="modseq">The mod-sequence value.</param>
  49269. <param name="flags">The message flags to add.</param>
  49270. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49271. <param name="cancellationToken">The cancellation token.</param>
  49272. <exception cref="T:System.ArgumentNullException">
  49273. <paramref name="indexes"/> is <c>null</c>.
  49274. </exception>
  49275. <exception cref="T:System.ArgumentException">
  49276. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  49277. <para>-or-</para>
  49278. <para>No flags were specified.</para>
  49279. </exception>
  49280. <exception cref="T:System.ObjectDisposedException">
  49281. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49282. </exception>
  49283. <exception cref="T:MailKit.ServiceNotConnectedException">
  49284. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49285. </exception>
  49286. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49287. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49288. </exception>
  49289. <exception cref="T:MailKit.FolderNotOpenException">
  49290. The folder is not currently open in read-write mode.
  49291. </exception>
  49292. <exception cref="T:System.NotSupportedException">
  49293. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  49294. </exception>
  49295. <exception cref="T:System.OperationCanceledException">
  49296. The operation was canceled via the cancellation token.
  49297. </exception>
  49298. <exception cref="T:System.IO.IOException">
  49299. An I/O error occurred.
  49300. </exception>
  49301. <exception cref="T:MailKit.ProtocolException">
  49302. The server's response contained unexpected tokens.
  49303. </exception>
  49304. <exception cref="T:MailKit.CommandException">
  49305. The command failed.
  49306. </exception>
  49307. </member>
  49308. <member name="M:MailKit.MailFolder.AddFlagsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  49309. <summary>
  49310. Asynchronously add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  49311. </summary>
  49312. <remarks>
  49313. Asynchronously adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  49314. </remarks>
  49315. <returns>The indexes of the messages that were not updated.</returns>
  49316. <param name="indexes">The indexes of the messages.</param>
  49317. <param name="modseq">The mod-sequence value.</param>
  49318. <param name="flags">The message flags to add.</param>
  49319. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49320. <param name="cancellationToken">The cancellation token.</param>
  49321. <exception cref="T:System.ArgumentNullException">
  49322. <paramref name="indexes"/> is <c>null</c>.
  49323. </exception>
  49324. <exception cref="T:System.ArgumentException">
  49325. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  49326. <para>-or-</para>
  49327. <para>No flags were specified.</para>
  49328. </exception>
  49329. <exception cref="T:System.ObjectDisposedException">
  49330. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49331. </exception>
  49332. <exception cref="T:MailKit.ServiceNotConnectedException">
  49333. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49334. </exception>
  49335. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49336. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49337. </exception>
  49338. <exception cref="T:MailKit.FolderNotOpenException">
  49339. The folder is not currently open in read-write mode.
  49340. </exception>
  49341. <exception cref="T:System.NotSupportedException">
  49342. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  49343. </exception>
  49344. <exception cref="T:System.OperationCanceledException">
  49345. The operation was canceled via the cancellation token.
  49346. </exception>
  49347. <exception cref="T:System.IO.IOException">
  49348. An I/O error occurred.
  49349. </exception>
  49350. <exception cref="T:MailKit.ProtocolException">
  49351. The server's response contained unexpected tokens.
  49352. </exception>
  49353. <exception cref="T:MailKit.CommandException">
  49354. The command failed.
  49355. </exception>
  49356. </member>
  49357. <member name="M:MailKit.MailFolder.AddFlags(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  49358. <summary>
  49359. Add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  49360. </summary>
  49361. <remarks>
  49362. Adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  49363. </remarks>
  49364. <returns>The indexes of the messages that were not updated.</returns>
  49365. <param name="indexes">The indexes of the messages.</param>
  49366. <param name="modseq">The mod-sequence value.</param>
  49367. <param name="flags">The message flags to add.</param>
  49368. <param name="keywords">A set of user-defined flags to add.</param>
  49369. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49370. <param name="cancellationToken">The cancellation token.</param>
  49371. <exception cref="T:System.ArgumentNullException">
  49372. <paramref name="indexes"/> is <c>null</c>.
  49373. </exception>
  49374. <exception cref="T:System.ArgumentException">
  49375. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  49376. <para>-or-</para>
  49377. <para>No flags were specified.</para>
  49378. </exception>
  49379. <exception cref="T:System.ObjectDisposedException">
  49380. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49381. </exception>
  49382. <exception cref="T:MailKit.ServiceNotConnectedException">
  49383. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49384. </exception>
  49385. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49386. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49387. </exception>
  49388. <exception cref="T:MailKit.FolderNotOpenException">
  49389. The folder is not currently open in read-write mode.
  49390. </exception>
  49391. <exception cref="T:System.NotSupportedException">
  49392. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  49393. </exception>
  49394. <exception cref="T:System.OperationCanceledException">
  49395. The operation was canceled via the cancellation token.
  49396. </exception>
  49397. <exception cref="T:System.IO.IOException">
  49398. An I/O error occurred.
  49399. </exception>
  49400. <exception cref="T:MailKit.ProtocolException">
  49401. The server's response contained unexpected tokens.
  49402. </exception>
  49403. <exception cref="T:MailKit.CommandException">
  49404. The command failed.
  49405. </exception>
  49406. </member>
  49407. <member name="M:MailKit.MailFolder.AddFlagsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  49408. <summary>
  49409. Asynchronously add a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  49410. </summary>
  49411. <remarks>
  49412. Asynchronously adds a set of flags to the specified messages only if their mod-sequence value is less than the specified value.
  49413. </remarks>
  49414. <returns>The indexes of the messages that were not updated.</returns>
  49415. <param name="indexes">The indexes of the messages.</param>
  49416. <param name="modseq">The mod-sequence value.</param>
  49417. <param name="flags">The message flags to add.</param>
  49418. <param name="keywords">A set of user-defined flags to add.</param>
  49419. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49420. <param name="cancellationToken">The cancellation token.</param>
  49421. <exception cref="T:System.ArgumentNullException">
  49422. <paramref name="indexes"/> is <c>null</c>.
  49423. </exception>
  49424. <exception cref="T:System.ArgumentException">
  49425. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  49426. <para>-or-</para>
  49427. <para>No flags were specified.</para>
  49428. </exception>
  49429. <exception cref="T:System.ObjectDisposedException">
  49430. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49431. </exception>
  49432. <exception cref="T:MailKit.ServiceNotConnectedException">
  49433. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49434. </exception>
  49435. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49436. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49437. </exception>
  49438. <exception cref="T:MailKit.FolderNotOpenException">
  49439. The folder is not currently open in read-write mode.
  49440. </exception>
  49441. <exception cref="T:System.NotSupportedException">
  49442. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  49443. </exception>
  49444. <exception cref="T:System.OperationCanceledException">
  49445. The operation was canceled via the cancellation token.
  49446. </exception>
  49447. <exception cref="T:System.IO.IOException">
  49448. An I/O error occurred.
  49449. </exception>
  49450. <exception cref="T:MailKit.ProtocolException">
  49451. The server's response contained unexpected tokens.
  49452. </exception>
  49453. <exception cref="T:MailKit.CommandException">
  49454. The command failed.
  49455. </exception>
  49456. </member>
  49457. <member name="M:MailKit.MailFolder.RemoveFlags(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  49458. <summary>
  49459. Remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  49460. </summary>
  49461. <remarks>
  49462. Removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  49463. </remarks>
  49464. <returns>The indexes of the messages that were not updated.</returns>
  49465. <param name="indexes">The indexes of the messages.</param>
  49466. <param name="modseq">The mod-sequence value.</param>
  49467. <param name="flags">The message flags to remove.</param>
  49468. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49469. <param name="cancellationToken">The cancellation token.</param>
  49470. <exception cref="T:System.ArgumentNullException">
  49471. <paramref name="indexes"/> is <c>null</c>.
  49472. </exception>
  49473. <exception cref="T:System.ArgumentException">
  49474. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  49475. <para>-or-</para>
  49476. <para>No flags were specified.</para>
  49477. </exception>
  49478. <exception cref="T:System.ObjectDisposedException">
  49479. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49480. </exception>
  49481. <exception cref="T:MailKit.ServiceNotConnectedException">
  49482. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49483. </exception>
  49484. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49485. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49486. </exception>
  49487. <exception cref="T:MailKit.FolderNotOpenException">
  49488. The folder is not currently open in read-write mode.
  49489. </exception>
  49490. <exception cref="T:System.NotSupportedException">
  49491. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  49492. </exception>
  49493. <exception cref="T:System.OperationCanceledException">
  49494. The operation was canceled via the cancellation token.
  49495. </exception>
  49496. <exception cref="T:System.IO.IOException">
  49497. An I/O error occurred.
  49498. </exception>
  49499. <exception cref="T:MailKit.ProtocolException">
  49500. The server's response contained unexpected tokens.
  49501. </exception>
  49502. <exception cref="T:MailKit.CommandException">
  49503. The command failed.
  49504. </exception>
  49505. </member>
  49506. <member name="M:MailKit.MailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  49507. <summary>
  49508. Asynchronously remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  49509. </summary>
  49510. <remarks>
  49511. Asynchronously removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  49512. </remarks>
  49513. <returns>The indexes of the messages that were not updated.</returns>
  49514. <param name="indexes">The indexes of the messages.</param>
  49515. <param name="modseq">The mod-sequence value.</param>
  49516. <param name="flags">The message flags to remove.</param>
  49517. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49518. <param name="cancellationToken">The cancellation token.</param>
  49519. <exception cref="T:System.ArgumentNullException">
  49520. <paramref name="indexes"/> is <c>null</c>.
  49521. </exception>
  49522. <exception cref="T:System.ArgumentException">
  49523. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  49524. <para>-or-</para>
  49525. <para>No flags were specified.</para>
  49526. </exception>
  49527. <exception cref="T:System.ObjectDisposedException">
  49528. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49529. </exception>
  49530. <exception cref="T:MailKit.ServiceNotConnectedException">
  49531. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49532. </exception>
  49533. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49534. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49535. </exception>
  49536. <exception cref="T:MailKit.FolderNotOpenException">
  49537. The folder is not currently open in read-write mode.
  49538. </exception>
  49539. <exception cref="T:System.NotSupportedException">
  49540. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  49541. </exception>
  49542. <exception cref="T:System.OperationCanceledException">
  49543. The operation was canceled via the cancellation token.
  49544. </exception>
  49545. <exception cref="T:System.IO.IOException">
  49546. An I/O error occurred.
  49547. </exception>
  49548. <exception cref="T:MailKit.ProtocolException">
  49549. The server's response contained unexpected tokens.
  49550. </exception>
  49551. <exception cref="T:MailKit.CommandException">
  49552. The command failed.
  49553. </exception>
  49554. </member>
  49555. <member name="M:MailKit.MailFolder.RemoveFlags(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  49556. <summary>
  49557. Remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  49558. </summary>
  49559. <remarks>
  49560. Removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  49561. </remarks>
  49562. <returns>The indexes of the messages that were not updated.</returns>
  49563. <param name="indexes">The indexes of the messages.</param>
  49564. <param name="modseq">The mod-sequence value.</param>
  49565. <param name="flags">The message flags to remove.</param>
  49566. <param name="keywords">A set of user-defined flags to remove.</param>
  49567. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49568. <param name="cancellationToken">The cancellation token.</param>
  49569. <exception cref="T:System.ArgumentNullException">
  49570. <paramref name="indexes"/> is <c>null</c>.
  49571. </exception>
  49572. <exception cref="T:System.ArgumentException">
  49573. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  49574. <para>-or-</para>
  49575. <para>No flags were specified.</para>
  49576. </exception>
  49577. <exception cref="T:System.ObjectDisposedException">
  49578. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49579. </exception>
  49580. <exception cref="T:MailKit.ServiceNotConnectedException">
  49581. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49582. </exception>
  49583. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49584. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49585. </exception>
  49586. <exception cref="T:MailKit.FolderNotOpenException">
  49587. The folder is not currently open in read-write mode.
  49588. </exception>
  49589. <exception cref="T:System.NotSupportedException">
  49590. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  49591. </exception>
  49592. <exception cref="T:System.OperationCanceledException">
  49593. The operation was canceled via the cancellation token.
  49594. </exception>
  49595. <exception cref="T:System.IO.IOException">
  49596. An I/O error occurred.
  49597. </exception>
  49598. <exception cref="T:MailKit.ProtocolException">
  49599. The server's response contained unexpected tokens.
  49600. </exception>
  49601. <exception cref="T:MailKit.CommandException">
  49602. The command failed.
  49603. </exception>
  49604. </member>
  49605. <member name="M:MailKit.MailFolder.RemoveFlagsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  49606. <summary>
  49607. Asynchronously remove a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  49608. </summary>
  49609. <remarks>
  49610. Asynchronously removes a set of flags from the specified messages only if their mod-sequence value is less than the specified value.
  49611. </remarks>
  49612. <returns>The indexes of the messages that were not updated.</returns>
  49613. <param name="indexes">The indexes of the messages.</param>
  49614. <param name="modseq">The mod-sequence value.</param>
  49615. <param name="flags">The message flags to remove.</param>
  49616. <param name="keywords">A set of user-defined flags to remove.</param>
  49617. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49618. <param name="cancellationToken">The cancellation token.</param>
  49619. <exception cref="T:System.ArgumentNullException">
  49620. <paramref name="indexes"/> is <c>null</c>.
  49621. </exception>
  49622. <exception cref="T:System.ArgumentException">
  49623. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  49624. <para>-or-</para>
  49625. <para>No flags were specified.</para>
  49626. </exception>
  49627. <exception cref="T:System.ObjectDisposedException">
  49628. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49629. </exception>
  49630. <exception cref="T:MailKit.ServiceNotConnectedException">
  49631. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49632. </exception>
  49633. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49634. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49635. </exception>
  49636. <exception cref="T:MailKit.FolderNotOpenException">
  49637. The folder is not currently open in read-write mode.
  49638. </exception>
  49639. <exception cref="T:System.NotSupportedException">
  49640. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  49641. </exception>
  49642. <exception cref="T:System.OperationCanceledException">
  49643. The operation was canceled via the cancellation token.
  49644. </exception>
  49645. <exception cref="T:System.IO.IOException">
  49646. An I/O error occurred.
  49647. </exception>
  49648. <exception cref="T:MailKit.ProtocolException">
  49649. The server's response contained unexpected tokens.
  49650. </exception>
  49651. <exception cref="T:MailKit.CommandException">
  49652. The command failed.
  49653. </exception>
  49654. </member>
  49655. <member name="M:MailKit.MailFolder.SetFlags(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  49656. <summary>
  49657. Set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  49658. </summary>
  49659. <remarks>
  49660. Sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  49661. </remarks>
  49662. <returns>The indexes of the messages that were not updated.</returns>
  49663. <param name="indexes">The indexes of the messages.</param>
  49664. <param name="modseq">The mod-sequence value.</param>
  49665. <param name="flags">The message flags to set.</param>
  49666. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49667. <param name="cancellationToken">The cancellation token.</param>
  49668. <exception cref="T:System.ArgumentNullException">
  49669. <paramref name="indexes"/> is <c>null</c>.
  49670. </exception>
  49671. <exception cref="T:System.ArgumentException">
  49672. One or more of the <paramref name="indexes"/> is invalid.
  49673. </exception>
  49674. <exception cref="T:System.ObjectDisposedException">
  49675. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49676. </exception>
  49677. <exception cref="T:MailKit.ServiceNotConnectedException">
  49678. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49679. </exception>
  49680. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49681. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49682. </exception>
  49683. <exception cref="T:MailKit.FolderNotOpenException">
  49684. The folder is not currently open in read-write mode.
  49685. </exception>
  49686. <exception cref="T:System.NotSupportedException">
  49687. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  49688. </exception>
  49689. <exception cref="T:System.OperationCanceledException">
  49690. The operation was canceled via the cancellation token.
  49691. </exception>
  49692. <exception cref="T:System.IO.IOException">
  49693. An I/O error occurred.
  49694. </exception>
  49695. <exception cref="T:MailKit.ProtocolException">
  49696. The server's response contained unexpected tokens.
  49697. </exception>
  49698. <exception cref="T:MailKit.CommandException">
  49699. The command failed.
  49700. </exception>
  49701. </member>
  49702. <member name="M:MailKit.MailFolder.SetFlagsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Boolean,System.Threading.CancellationToken)">
  49703. <summary>
  49704. Asynchronously set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  49705. </summary>
  49706. <remarks>
  49707. Asynchronously sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  49708. </remarks>
  49709. <returns>The indexes of the messages that were not updated.</returns>
  49710. <param name="indexes">The indexes of the messages.</param>
  49711. <param name="modseq">The mod-sequence value.</param>
  49712. <param name="flags">The message flags to set.</param>
  49713. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49714. <param name="cancellationToken">The cancellation token.</param>
  49715. <exception cref="T:System.ArgumentNullException">
  49716. <paramref name="indexes"/> is <c>null</c>.
  49717. </exception>
  49718. <exception cref="T:System.ArgumentException">
  49719. One or more of the <paramref name="indexes"/> is invalid.
  49720. </exception>
  49721. <exception cref="T:System.ObjectDisposedException">
  49722. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49723. </exception>
  49724. <exception cref="T:MailKit.ServiceNotConnectedException">
  49725. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49726. </exception>
  49727. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49728. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49729. </exception>
  49730. <exception cref="T:MailKit.FolderNotOpenException">
  49731. The folder is not currently open in read-write mode.
  49732. </exception>
  49733. <exception cref="T:System.NotSupportedException">
  49734. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  49735. </exception>
  49736. <exception cref="T:System.OperationCanceledException">
  49737. The operation was canceled via the cancellation token.
  49738. </exception>
  49739. <exception cref="T:System.IO.IOException">
  49740. An I/O error occurred.
  49741. </exception>
  49742. <exception cref="T:MailKit.ProtocolException">
  49743. The server's response contained unexpected tokens.
  49744. </exception>
  49745. <exception cref="T:MailKit.CommandException">
  49746. The command failed.
  49747. </exception>
  49748. </member>
  49749. <member name="M:MailKit.MailFolder.SetFlags(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  49750. <summary>
  49751. Set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  49752. </summary>
  49753. <remarks>
  49754. Sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  49755. </remarks>
  49756. <returns>The indexes of the messages that were not updated.</returns>
  49757. <param name="indexes">The indexes of the messages.</param>
  49758. <param name="modseq">The mod-sequence value.</param>
  49759. <param name="flags">The message flags to set.</param>
  49760. <param name="keywords">A set of user-defined flags to set.</param>
  49761. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49762. <param name="cancellationToken">The cancellation token.</param>
  49763. <exception cref="T:System.ArgumentNullException">
  49764. <paramref name="indexes"/> is <c>null</c>.
  49765. </exception>
  49766. <exception cref="T:System.ArgumentException">
  49767. One or more of the <paramref name="indexes"/> is invalid.
  49768. </exception>
  49769. <exception cref="T:System.ObjectDisposedException">
  49770. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49771. </exception>
  49772. <exception cref="T:MailKit.ServiceNotConnectedException">
  49773. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49774. </exception>
  49775. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49776. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49777. </exception>
  49778. <exception cref="T:MailKit.FolderNotOpenException">
  49779. The folder is not currently open in read-write mode.
  49780. </exception>
  49781. <exception cref="T:System.NotSupportedException">
  49782. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  49783. </exception>
  49784. <exception cref="T:System.OperationCanceledException">
  49785. The operation was canceled via the cancellation token.
  49786. </exception>
  49787. <exception cref="T:System.IO.IOException">
  49788. An I/O error occurred.
  49789. </exception>
  49790. <exception cref="T:MailKit.ProtocolException">
  49791. The server's response contained unexpected tokens.
  49792. </exception>
  49793. <exception cref="T:MailKit.CommandException">
  49794. The command failed.
  49795. </exception>
  49796. </member>
  49797. <member name="M:MailKit.MailFolder.SetFlagsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.Boolean,System.Threading.CancellationToken)">
  49798. <summary>
  49799. Asynchronously set the flags of the specified messages only if their mod-sequence value is less than the specified value.
  49800. </summary>
  49801. <remarks>
  49802. Asynchronously sets the flags of the specified messages only if their mod-sequence value is less than the specified value.
  49803. </remarks>
  49804. <returns>The indexes of the messages that were not updated.</returns>
  49805. <param name="indexes">The indexes of the messages.</param>
  49806. <param name="modseq">The mod-sequence value.</param>
  49807. <param name="flags">The message flags to set.</param>
  49808. <param name="keywords">A set of user-defined flags to set.</param>
  49809. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> events will be emitted.</param>
  49810. <param name="cancellationToken">The cancellation token.</param>
  49811. <exception cref="T:System.ArgumentNullException">
  49812. <paramref name="indexes"/> is <c>null</c>.
  49813. </exception>
  49814. <exception cref="T:System.ArgumentException">
  49815. One or more of the <paramref name="indexes"/> is invalid.
  49816. </exception>
  49817. <exception cref="T:System.ObjectDisposedException">
  49818. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49819. </exception>
  49820. <exception cref="T:MailKit.ServiceNotConnectedException">
  49821. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49822. </exception>
  49823. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49824. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49825. </exception>
  49826. <exception cref="T:MailKit.FolderNotOpenException">
  49827. The folder is not currently open in read-write mode.
  49828. </exception>
  49829. <exception cref="T:System.NotSupportedException">
  49830. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  49831. </exception>
  49832. <exception cref="T:System.OperationCanceledException">
  49833. The operation was canceled via the cancellation token.
  49834. </exception>
  49835. <exception cref="T:System.IO.IOException">
  49836. An I/O error occurred.
  49837. </exception>
  49838. <exception cref="T:MailKit.ProtocolException">
  49839. The server's response contained unexpected tokens.
  49840. </exception>
  49841. <exception cref="T:MailKit.CommandException">
  49842. The command failed.
  49843. </exception>
  49844. </member>
  49845. <member name="M:MailKit.MailFolder.AddLabels(MailKit.UniqueId,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  49846. <summary>
  49847. Add a set of labels to the specified message.
  49848. </summary>
  49849. <remarks>
  49850. Adds a set of labels to the specified message.
  49851. </remarks>
  49852. <param name="uid">The UID of the message.</param>
  49853. <param name="labels">The labels to add.</param>
  49854. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  49855. <param name="cancellationToken">The cancellation token.</param>
  49856. <exception cref="T:System.ArgumentNullException">
  49857. <paramref name="labels"/> is <c>null</c>.
  49858. </exception>
  49859. <exception cref="T:System.ArgumentException">
  49860. <para><paramref name="uid"/> is invalid.</para>
  49861. <para>-or-</para>
  49862. <para>No labels were specified.</para>
  49863. </exception>
  49864. <exception cref="T:System.ObjectDisposedException">
  49865. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49866. </exception>
  49867. <exception cref="T:MailKit.ServiceNotConnectedException">
  49868. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49869. </exception>
  49870. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49871. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49872. </exception>
  49873. <exception cref="T:MailKit.FolderNotOpenException">
  49874. The folder is not currently open in read-write mode.
  49875. </exception>
  49876. <exception cref="T:System.OperationCanceledException">
  49877. The operation was canceled via the cancellation token.
  49878. </exception>
  49879. <exception cref="T:System.IO.IOException">
  49880. An I/O error occurred.
  49881. </exception>
  49882. <exception cref="T:MailKit.ProtocolException">
  49883. The server's response contained unexpected tokens.
  49884. </exception>
  49885. <exception cref="T:MailKit.CommandException">
  49886. The command failed.
  49887. </exception>
  49888. </member>
  49889. <member name="M:MailKit.MailFolder.AddLabelsAsync(MailKit.UniqueId,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  49890. <summary>
  49891. Asynchronously add a set of labels to the specified message.
  49892. </summary>
  49893. <remarks>
  49894. Asynchronously adds a set of labels to the specified message.
  49895. </remarks>
  49896. <returns>An asynchronous task context.</returns>
  49897. <param name="uid">The UID of the message.</param>
  49898. <param name="labels">The labels to add.</param>
  49899. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  49900. <param name="cancellationToken">The cancellation token.</param>
  49901. <exception cref="T:System.ArgumentNullException">
  49902. <paramref name="labels"/> is <c>null</c>.
  49903. </exception>
  49904. <exception cref="T:System.ArgumentException">
  49905. <para><paramref name="uid"/> is invalid.</para>
  49906. <para>-or-</para>
  49907. <para>No labels were specified.</para>
  49908. </exception>
  49909. <exception cref="T:System.ObjectDisposedException">
  49910. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49911. </exception>
  49912. <exception cref="T:MailKit.ServiceNotConnectedException">
  49913. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49914. </exception>
  49915. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49916. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49917. </exception>
  49918. <exception cref="T:MailKit.FolderNotOpenException">
  49919. The folder is not currently open in read-write mode.
  49920. </exception>
  49921. <exception cref="T:System.OperationCanceledException">
  49922. The operation was canceled via the cancellation token.
  49923. </exception>
  49924. <exception cref="T:System.IO.IOException">
  49925. An I/O error occurred.
  49926. </exception>
  49927. <exception cref="T:MailKit.ProtocolException">
  49928. The server's response contained unexpected tokens.
  49929. </exception>
  49930. <exception cref="T:MailKit.CommandException">
  49931. The command failed.
  49932. </exception>
  49933. </member>
  49934. <member name="M:MailKit.MailFolder.AddLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  49935. <summary>
  49936. Add a set of labels to the specified messages.
  49937. </summary>
  49938. <remarks>
  49939. Adds a set of labels to the specified messages.
  49940. </remarks>
  49941. <param name="uids">The UIDs of the messages.</param>
  49942. <param name="labels">The labels to add.</param>
  49943. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  49944. <param name="cancellationToken">The cancellation token.</param>
  49945. <exception cref="T:System.ArgumentNullException">
  49946. <para><paramref name="uids"/> is <c>null</c>.</para>
  49947. <para>-or-</para>
  49948. <para><paramref name="labels"/> is <c>null</c>.</para>
  49949. </exception>
  49950. <exception cref="T:System.ArgumentException">
  49951. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  49952. <para>-or-</para>
  49953. <para>No labels were specified.</para>
  49954. </exception>
  49955. <exception cref="T:System.ObjectDisposedException">
  49956. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  49957. </exception>
  49958. <exception cref="T:MailKit.ServiceNotConnectedException">
  49959. The <see cref="T:MailKit.IMailStore"/> is not connected.
  49960. </exception>
  49961. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  49962. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  49963. </exception>
  49964. <exception cref="T:MailKit.FolderNotOpenException">
  49965. The folder is not currently open in read-write mode.
  49966. </exception>
  49967. <exception cref="T:System.OperationCanceledException">
  49968. The operation was canceled via the cancellation token.
  49969. </exception>
  49970. <exception cref="T:System.IO.IOException">
  49971. An I/O error occurred.
  49972. </exception>
  49973. <exception cref="T:MailKit.ProtocolException">
  49974. The server's response contained unexpected tokens.
  49975. </exception>
  49976. <exception cref="T:MailKit.CommandException">
  49977. The command failed.
  49978. </exception>
  49979. </member>
  49980. <member name="M:MailKit.MailFolder.AddLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  49981. <summary>
  49982. Asynchronously add a set of labels to the specified messages.
  49983. </summary>
  49984. <remarks>
  49985. Asynchronously adds a set of labels to the specified messages.
  49986. </remarks>
  49987. <returns>An asynchronous task context.</returns>
  49988. <param name="uids">The UIDs of the messages.</param>
  49989. <param name="labels">The labels to add.</param>
  49990. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  49991. <param name="cancellationToken">The cancellation token.</param>
  49992. <exception cref="T:System.ArgumentNullException">
  49993. <para><paramref name="uids"/> is <c>null</c>.</para>
  49994. <para>-or-</para>
  49995. <para><paramref name="labels"/> is <c>null</c>.</para>
  49996. </exception>
  49997. <exception cref="T:System.ArgumentException">
  49998. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  49999. <para>-or-</para>
  50000. <para>No labels were specified.</para>
  50001. </exception>
  50002. <exception cref="T:System.ObjectDisposedException">
  50003. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50004. </exception>
  50005. <exception cref="T:MailKit.ServiceNotConnectedException">
  50006. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50007. </exception>
  50008. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50009. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50010. </exception>
  50011. <exception cref="T:MailKit.FolderNotOpenException">
  50012. The folder is not currently open in read-write mode.
  50013. </exception>
  50014. <exception cref="T:System.OperationCanceledException">
  50015. The operation was canceled via the cancellation token.
  50016. </exception>
  50017. <exception cref="T:System.IO.IOException">
  50018. An I/O error occurred.
  50019. </exception>
  50020. <exception cref="T:MailKit.ProtocolException">
  50021. The server's response contained unexpected tokens.
  50022. </exception>
  50023. <exception cref="T:MailKit.CommandException">
  50024. The command failed.
  50025. </exception>
  50026. </member>
  50027. <member name="M:MailKit.MailFolder.RemoveLabels(MailKit.UniqueId,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50028. <summary>
  50029. Remove a set of labels from the specified message.
  50030. </summary>
  50031. <remarks>
  50032. Removes a set of labels from the specified message.
  50033. </remarks>
  50034. <param name="uid">The UIDs of the message.</param>
  50035. <param name="labels">The labels to remove.</param>
  50036. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50037. <param name="cancellationToken">The cancellation token.</param>
  50038. <exception cref="T:System.ArgumentNullException">
  50039. <paramref name="labels"/> is <c>null</c>.
  50040. </exception>
  50041. <exception cref="T:System.ArgumentException">
  50042. <para><paramref name="uid"/> is invalid.</para>
  50043. <para>-or-</para>
  50044. <para>No labels were specified.</para>
  50045. </exception>
  50046. <exception cref="T:System.ObjectDisposedException">
  50047. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50048. </exception>
  50049. <exception cref="T:MailKit.ServiceNotConnectedException">
  50050. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50051. </exception>
  50052. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50053. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50054. </exception>
  50055. <exception cref="T:MailKit.FolderNotOpenException">
  50056. The folder is not currently open in read-write mode.
  50057. </exception>
  50058. <exception cref="T:System.OperationCanceledException">
  50059. The operation was canceled via the cancellation token.
  50060. </exception>
  50061. <exception cref="T:System.IO.IOException">
  50062. An I/O error occurred.
  50063. </exception>
  50064. <exception cref="T:MailKit.ProtocolException">
  50065. The server's response contained unexpected tokens.
  50066. </exception>
  50067. <exception cref="T:MailKit.CommandException">
  50068. The command failed.
  50069. </exception>
  50070. </member>
  50071. <member name="M:MailKit.MailFolder.RemoveLabelsAsync(MailKit.UniqueId,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50072. <summary>
  50073. Asynchronously remove a set of labels from the specified message.
  50074. </summary>
  50075. <remarks>
  50076. Asynchronously removes a set of labels from the specified message.
  50077. </remarks>
  50078. <returns>An asynchronous task context.</returns>
  50079. <param name="uid">The UID of the message.</param>
  50080. <param name="labels">The labels to remove.</param>
  50081. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50082. <param name="cancellationToken">The cancellation token.</param>
  50083. <exception cref="T:System.ArgumentNullException">
  50084. <paramref name="labels"/> is <c>null</c>.
  50085. </exception>
  50086. <exception cref="T:System.ArgumentException">
  50087. <para><paramref name="uid"/> is invalid.</para>
  50088. <para>-or-</para>
  50089. <para>No labels were specified.</para>
  50090. </exception>
  50091. <exception cref="T:System.ObjectDisposedException">
  50092. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50093. </exception>
  50094. <exception cref="T:MailKit.ServiceNotConnectedException">
  50095. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50096. </exception>
  50097. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50098. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50099. </exception>
  50100. <exception cref="T:MailKit.FolderNotOpenException">
  50101. The folder is not currently open in read-write mode.
  50102. </exception>
  50103. <exception cref="T:System.OperationCanceledException">
  50104. The operation was canceled via the cancellation token.
  50105. </exception>
  50106. <exception cref="T:System.IO.IOException">
  50107. An I/O error occurred.
  50108. </exception>
  50109. <exception cref="T:MailKit.ProtocolException">
  50110. The server's response contained unexpected tokens.
  50111. </exception>
  50112. <exception cref="T:MailKit.CommandException">
  50113. The command failed.
  50114. </exception>
  50115. </member>
  50116. <member name="M:MailKit.MailFolder.RemoveLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50117. <summary>
  50118. Remove a set of labels from the specified messages.
  50119. </summary>
  50120. <remarks>
  50121. Removes a set of labels from the specified messages.
  50122. </remarks>
  50123. <param name="uids">The UIDs of the messages.</param>
  50124. <param name="labels">The labels to remove.</param>
  50125. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50126. <param name="cancellationToken">The cancellation token.</param>
  50127. <exception cref="T:System.ArgumentNullException">
  50128. <para><paramref name="uids"/> is <c>null</c>.</para>
  50129. <para>-or-</para>
  50130. <para><paramref name="labels"/> is <c>null</c>.</para>
  50131. </exception>
  50132. <exception cref="T:System.ArgumentException">
  50133. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  50134. <para>-or-</para>
  50135. <para>No labels were specified.</para>
  50136. </exception>
  50137. <exception cref="T:System.ObjectDisposedException">
  50138. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50139. </exception>
  50140. <exception cref="T:MailKit.ServiceNotConnectedException">
  50141. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50142. </exception>
  50143. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50144. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50145. </exception>
  50146. <exception cref="T:MailKit.FolderNotOpenException">
  50147. The folder is not currently open in read-write mode.
  50148. </exception>
  50149. <exception cref="T:System.OperationCanceledException">
  50150. The operation was canceled via the cancellation token.
  50151. </exception>
  50152. <exception cref="T:System.IO.IOException">
  50153. An I/O error occurred.
  50154. </exception>
  50155. <exception cref="T:MailKit.ProtocolException">
  50156. The server's response contained unexpected tokens.
  50157. </exception>
  50158. <exception cref="T:MailKit.CommandException">
  50159. The command failed.
  50160. </exception>
  50161. </member>
  50162. <member name="M:MailKit.MailFolder.RemoveLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50163. <summary>
  50164. Asynchronously remove a set of labels from the specified messages.
  50165. </summary>
  50166. <remarks>
  50167. Asynchronously removes a set of labels from the specified messages.
  50168. </remarks>
  50169. <returns>An asynchronous task context.</returns>
  50170. <param name="uids">The UIDs of the messages.</param>
  50171. <param name="labels">The labels to remove.</param>
  50172. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50173. <param name="cancellationToken">The cancellation token.</param>
  50174. <exception cref="T:System.ArgumentNullException">
  50175. <para><paramref name="uids"/> is <c>null</c>.</para>
  50176. <para>-or-</para>
  50177. <para><paramref name="labels"/> is <c>null</c>.</para>
  50178. </exception>
  50179. <exception cref="T:System.ArgumentException">
  50180. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  50181. <para>-or-</para>
  50182. <para>No labels were specified.</para>
  50183. </exception>
  50184. <exception cref="T:System.ObjectDisposedException">
  50185. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50186. </exception>
  50187. <exception cref="T:MailKit.ServiceNotConnectedException">
  50188. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50189. </exception>
  50190. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50191. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50192. </exception>
  50193. <exception cref="T:MailKit.FolderNotOpenException">
  50194. The folder is not currently open in read-write mode.
  50195. </exception>
  50196. <exception cref="T:System.OperationCanceledException">
  50197. The operation was canceled via the cancellation token.
  50198. </exception>
  50199. <exception cref="T:System.IO.IOException">
  50200. An I/O error occurred.
  50201. </exception>
  50202. <exception cref="T:MailKit.ProtocolException">
  50203. The server's response contained unexpected tokens.
  50204. </exception>
  50205. <exception cref="T:MailKit.CommandException">
  50206. The command failed.
  50207. </exception>
  50208. </member>
  50209. <member name="M:MailKit.MailFolder.SetLabels(MailKit.UniqueId,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50210. <summary>
  50211. Set the labels of the specified message.
  50212. </summary>
  50213. <remarks>
  50214. Sets the labels of the specified message.
  50215. </remarks>
  50216. <param name="uid">The UIDs of the message.</param>
  50217. <param name="labels">The labels to set.</param>
  50218. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50219. <param name="cancellationToken">The cancellation token.</param>
  50220. <exception cref="T:System.ArgumentNullException">
  50221. <paramref name="labels"/> is <c>null</c>.
  50222. </exception>
  50223. <exception cref="T:System.ArgumentException">
  50224. <paramref name="uid"/> is invalid.
  50225. </exception>
  50226. <exception cref="T:System.ObjectDisposedException">
  50227. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50228. </exception>
  50229. <exception cref="T:MailKit.ServiceNotConnectedException">
  50230. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50231. </exception>
  50232. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50233. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50234. </exception>
  50235. <exception cref="T:MailKit.FolderNotOpenException">
  50236. The folder is not currently open in read-write mode.
  50237. </exception>
  50238. <exception cref="T:System.OperationCanceledException">
  50239. The operation was canceled via the cancellation token.
  50240. </exception>
  50241. <exception cref="T:System.IO.IOException">
  50242. An I/O error occurred.
  50243. </exception>
  50244. <exception cref="T:MailKit.ProtocolException">
  50245. The server's response contained unexpected tokens.
  50246. </exception>
  50247. <exception cref="T:MailKit.CommandException">
  50248. The command failed.
  50249. </exception>
  50250. </member>
  50251. <member name="M:MailKit.MailFolder.SetLabelsAsync(MailKit.UniqueId,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50252. <summary>
  50253. Asynchronously set the labels of the specified message.
  50254. </summary>
  50255. <remarks>
  50256. Asynchronously sets the labels of the specified message.
  50257. </remarks>
  50258. <returns>An asynchronous task context.</returns>
  50259. <param name="uid">The UID of the message.</param>
  50260. <param name="labels">The labels to set.</param>
  50261. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50262. <param name="cancellationToken">The cancellation token.</param>
  50263. <exception cref="T:System.ArgumentNullException">
  50264. <paramref name="labels"/> is <c>null</c>.
  50265. </exception>
  50266. <exception cref="T:System.ArgumentException">
  50267. <paramref name="uid"/> is invalid.
  50268. </exception>
  50269. <exception cref="T:System.ObjectDisposedException">
  50270. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50271. </exception>
  50272. <exception cref="T:MailKit.ServiceNotConnectedException">
  50273. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50274. </exception>
  50275. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50276. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50277. </exception>
  50278. <exception cref="T:MailKit.FolderNotOpenException">
  50279. The folder is not currently open in read-write mode.
  50280. </exception>
  50281. <exception cref="T:System.OperationCanceledException">
  50282. The operation was canceled via the cancellation token.
  50283. </exception>
  50284. <exception cref="T:System.IO.IOException">
  50285. An I/O error occurred.
  50286. </exception>
  50287. <exception cref="T:MailKit.ProtocolException">
  50288. The server's response contained unexpected tokens.
  50289. </exception>
  50290. <exception cref="T:MailKit.CommandException">
  50291. The command failed.
  50292. </exception>
  50293. </member>
  50294. <member name="M:MailKit.MailFolder.SetLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50295. <summary>
  50296. Set the labels of the specified messages.
  50297. </summary>
  50298. <remarks>
  50299. Sets the labels of the specified messages.
  50300. </remarks>
  50301. <param name="uids">The UIDs of the messages.</param>
  50302. <param name="labels">The labels to set.</param>
  50303. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50304. <param name="cancellationToken">The cancellation token.</param>
  50305. <exception cref="T:System.ArgumentNullException">
  50306. <para><paramref name="uids"/> is <c>null</c>.</para>
  50307. <para>-or-</para>
  50308. <para><paramref name="labels"/> is <c>null</c>.</para>
  50309. </exception>
  50310. <exception cref="T:System.ArgumentException">
  50311. One or more of the <paramref name="uids"/> is invalid.
  50312. </exception>
  50313. <exception cref="T:System.ObjectDisposedException">
  50314. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50315. </exception>
  50316. <exception cref="T:MailKit.ServiceNotConnectedException">
  50317. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50318. </exception>
  50319. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50320. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50321. </exception>
  50322. <exception cref="T:MailKit.FolderNotOpenException">
  50323. The folder is not currently open in read-write mode.
  50324. </exception>
  50325. <exception cref="T:System.OperationCanceledException">
  50326. The operation was canceled via the cancellation token.
  50327. </exception>
  50328. <exception cref="T:System.IO.IOException">
  50329. An I/O error occurred.
  50330. </exception>
  50331. <exception cref="T:MailKit.ProtocolException">
  50332. The server's response contained unexpected tokens.
  50333. </exception>
  50334. <exception cref="T:MailKit.CommandException">
  50335. The command failed.
  50336. </exception>
  50337. </member>
  50338. <member name="M:MailKit.MailFolder.SetLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50339. <summary>
  50340. Asynchronously set the labels of the specified messages.
  50341. </summary>
  50342. <remarks>
  50343. Asynchronously sets the labels of the specified messages.
  50344. </remarks>
  50345. <returns>An asynchronous task context.</returns>
  50346. <param name="uids">The UIDs of the messages.</param>
  50347. <param name="labels">The labels to set.</param>
  50348. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50349. <param name="cancellationToken">The cancellation token.</param>
  50350. <exception cref="T:System.ArgumentNullException">
  50351. <para><paramref name="uids"/> is <c>null</c>.</para>
  50352. <para>-or-</para>
  50353. <para><paramref name="labels"/> is <c>null</c>.</para>
  50354. </exception>
  50355. <exception cref="T:System.ArgumentException">
  50356. One or more of the <paramref name="uids"/> is invalid.
  50357. </exception>
  50358. <exception cref="T:System.ObjectDisposedException">
  50359. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50360. </exception>
  50361. <exception cref="T:MailKit.ServiceNotConnectedException">
  50362. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50363. </exception>
  50364. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50365. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50366. </exception>
  50367. <exception cref="T:MailKit.FolderNotOpenException">
  50368. The folder is not currently open in read-write mode.
  50369. </exception>
  50370. <exception cref="T:System.OperationCanceledException">
  50371. The operation was canceled via the cancellation token.
  50372. </exception>
  50373. <exception cref="T:System.IO.IOException">
  50374. An I/O error occurred.
  50375. </exception>
  50376. <exception cref="T:MailKit.ProtocolException">
  50377. The server's response contained unexpected tokens.
  50378. </exception>
  50379. <exception cref="T:MailKit.CommandException">
  50380. The command failed.
  50381. </exception>
  50382. </member>
  50383. <member name="M:MailKit.MailFolder.AddLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50384. <summary>
  50385. Add a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  50386. </summary>
  50387. <remarks>
  50388. Adds a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  50389. </remarks>
  50390. <returns>The unique IDs of the messages that were not updated.</returns>
  50391. <param name="uids">The UIDs of the messages.</param>
  50392. <param name="modseq">The mod-sequence value.</param>
  50393. <param name="labels">The labels to add.</param>
  50394. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50395. <param name="cancellationToken">The cancellation token.</param>
  50396. <exception cref="T:System.ArgumentNullException">
  50397. <para><paramref name="uids"/> is <c>null</c>.</para>
  50398. <para>-or-</para>
  50399. <para><paramref name="labels"/> is <c>null</c>.</para>
  50400. </exception>
  50401. <exception cref="T:System.ArgumentException">
  50402. One or more of the <paramref name="uids"/> is invalid.
  50403. <para>-or-</para>
  50404. <para>No labels were specified.</para>
  50405. </exception>
  50406. <exception cref="T:System.ObjectDisposedException">
  50407. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50408. </exception>
  50409. <exception cref="T:MailKit.ServiceNotConnectedException">
  50410. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50411. </exception>
  50412. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50413. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50414. </exception>
  50415. <exception cref="T:MailKit.FolderNotOpenException">
  50416. The folder is not currently open in read-write mode.
  50417. </exception>
  50418. <exception cref="T:System.NotSupportedException">
  50419. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  50420. </exception>
  50421. <exception cref="T:System.OperationCanceledException">
  50422. The operation was canceled via the cancellation token.
  50423. </exception>
  50424. <exception cref="T:System.IO.IOException">
  50425. An I/O error occurred.
  50426. </exception>
  50427. <exception cref="T:MailKit.ProtocolException">
  50428. The server's response contained unexpected tokens.
  50429. </exception>
  50430. <exception cref="T:MailKit.CommandException">
  50431. The command failed.
  50432. </exception>
  50433. </member>
  50434. <member name="M:MailKit.MailFolder.AddLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50435. <summary>
  50436. Asynchronously add a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  50437. </summary>
  50438. <remarks>
  50439. Asynchronously adds a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  50440. </remarks>
  50441. <returns>The unique IDs of the messages that were not updated.</returns>
  50442. <param name="uids">The UIDs of the messages.</param>
  50443. <param name="modseq">The mod-sequence value.</param>
  50444. <param name="labels">The labels to add.</param>
  50445. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50446. <param name="cancellationToken">The cancellation token.</param>
  50447. <exception cref="T:System.ArgumentNullException">
  50448. <para><paramref name="uids"/> is <c>null</c>.</para>
  50449. <para>-or-</para>
  50450. <para><paramref name="labels"/> is <c>null</c>.</para>
  50451. </exception>
  50452. <exception cref="T:System.ArgumentException">
  50453. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  50454. <para>-or-</para>
  50455. <para>No labels were specified.</para>
  50456. </exception>
  50457. <exception cref="T:System.ObjectDisposedException">
  50458. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50459. </exception>
  50460. <exception cref="T:MailKit.ServiceNotConnectedException">
  50461. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50462. </exception>
  50463. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50464. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50465. </exception>
  50466. <exception cref="T:MailKit.FolderNotOpenException">
  50467. The folder is not currently open in read-write mode.
  50468. </exception>
  50469. <exception cref="T:System.NotSupportedException">
  50470. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  50471. </exception>
  50472. <exception cref="T:System.OperationCanceledException">
  50473. The operation was canceled via the cancellation token.
  50474. </exception>
  50475. <exception cref="T:System.IO.IOException">
  50476. An I/O error occurred.
  50477. </exception>
  50478. <exception cref="T:MailKit.ProtocolException">
  50479. The server's response contained unexpected tokens.
  50480. </exception>
  50481. <exception cref="T:MailKit.CommandException">
  50482. The command failed.
  50483. </exception>
  50484. </member>
  50485. <member name="M:MailKit.MailFolder.RemoveLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50486. <summary>
  50487. Remove a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  50488. </summary>
  50489. <remarks>
  50490. Removes a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  50491. </remarks>
  50492. <returns>The unique IDs of the messages that were not updated.</returns>
  50493. <param name="uids">The UIDs of the messages.</param>
  50494. <param name="modseq">The mod-sequence value.</param>
  50495. <param name="labels">The labels to remove.</param>
  50496. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50497. <param name="cancellationToken">The cancellation token.</param>
  50498. <exception cref="T:System.ArgumentNullException">
  50499. <para><paramref name="uids"/> is <c>null</c>.</para>
  50500. <para>-or-</para>
  50501. <para><paramref name="labels"/> is <c>null</c>.</para>
  50502. </exception>
  50503. <exception cref="T:System.ArgumentException">
  50504. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  50505. <para>-or-</para>
  50506. <para>No labels were specified.</para>
  50507. </exception>
  50508. <exception cref="T:System.ObjectDisposedException">
  50509. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50510. </exception>
  50511. <exception cref="T:MailKit.ServiceNotConnectedException">
  50512. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50513. </exception>
  50514. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50515. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50516. </exception>
  50517. <exception cref="T:MailKit.FolderNotOpenException">
  50518. The folder is not currently open in read-write mode.
  50519. </exception>
  50520. <exception cref="T:System.NotSupportedException">
  50521. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  50522. </exception>
  50523. <exception cref="T:System.OperationCanceledException">
  50524. The operation was canceled via the cancellation token.
  50525. </exception>
  50526. <exception cref="T:System.IO.IOException">
  50527. An I/O error occurred.
  50528. </exception>
  50529. <exception cref="T:MailKit.ProtocolException">
  50530. The server's response contained unexpected tokens.
  50531. </exception>
  50532. <exception cref="T:MailKit.CommandException">
  50533. The command failed.
  50534. </exception>
  50535. </member>
  50536. <member name="M:MailKit.MailFolder.RemoveLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50537. <summary>
  50538. Asynchronously remove a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  50539. </summary>
  50540. <remarks>
  50541. Asynchronously removes a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  50542. </remarks>
  50543. <returns>The unique IDs of the messages that were not updated.</returns>
  50544. <param name="uids">The UIDs of the messages.</param>
  50545. <param name="modseq">The mod-sequence value.</param>
  50546. <param name="labels">The labels to remove.</param>
  50547. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50548. <param name="cancellationToken">The cancellation token.</param>
  50549. <exception cref="T:System.ArgumentNullException">
  50550. <para><paramref name="uids"/> is <c>null</c>.</para>
  50551. <para>-or-</para>
  50552. <para><paramref name="labels"/> is <c>null</c>.</para>
  50553. </exception>
  50554. <exception cref="T:System.ArgumentException">
  50555. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  50556. <para>-or-</para>
  50557. <para>No labels were specified.</para>
  50558. </exception>
  50559. <exception cref="T:System.ObjectDisposedException">
  50560. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50561. </exception>
  50562. <exception cref="T:MailKit.ServiceNotConnectedException">
  50563. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50564. </exception>
  50565. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50566. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50567. </exception>
  50568. <exception cref="T:MailKit.FolderNotOpenException">
  50569. The folder is not currently open in read-write mode.
  50570. </exception>
  50571. <exception cref="T:System.NotSupportedException">
  50572. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  50573. </exception>
  50574. <exception cref="T:System.OperationCanceledException">
  50575. The operation was canceled via the cancellation token.
  50576. </exception>
  50577. <exception cref="T:System.IO.IOException">
  50578. An I/O error occurred.
  50579. </exception>
  50580. <exception cref="T:MailKit.ProtocolException">
  50581. The server's response contained unexpected tokens.
  50582. </exception>
  50583. <exception cref="T:MailKit.CommandException">
  50584. The command failed.
  50585. </exception>
  50586. </member>
  50587. <member name="M:MailKit.MailFolder.SetLabels(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50588. <summary>
  50589. Set the labels of the specified messages only if their mod-sequence value is less than the specified value.
  50590. </summary>
  50591. <remarks>
  50592. Sets the labels of the specified messages only if their mod-sequence value is less than the specified value.
  50593. </remarks>
  50594. <returns>The unique IDs of the messages that were not updated.</returns>
  50595. <param name="uids">The UIDs of the messages.</param>
  50596. <param name="modseq">The mod-sequence value.</param>
  50597. <param name="labels">The labels to set.</param>
  50598. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50599. <param name="cancellationToken">The cancellation token.</param>
  50600. <exception cref="T:System.ArgumentNullException">
  50601. <para><paramref name="uids"/> is <c>null</c>.</para>
  50602. <para>-or-</para>
  50603. <para><paramref name="labels"/> is <c>null</c>.</para>
  50604. </exception>
  50605. <exception cref="T:System.ArgumentException">
  50606. One or more of the <paramref name="uids"/> is invalid.
  50607. </exception>
  50608. <exception cref="T:System.ObjectDisposedException">
  50609. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50610. </exception>
  50611. <exception cref="T:MailKit.ServiceNotConnectedException">
  50612. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50613. </exception>
  50614. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50615. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50616. </exception>
  50617. <exception cref="T:MailKit.FolderNotOpenException">
  50618. The folder is not currently open in read-write mode.
  50619. </exception>
  50620. <exception cref="T:System.NotSupportedException">
  50621. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  50622. </exception>
  50623. <exception cref="T:System.OperationCanceledException">
  50624. The operation was canceled via the cancellation token.
  50625. </exception>
  50626. <exception cref="T:System.IO.IOException">
  50627. An I/O error occurred.
  50628. </exception>
  50629. <exception cref="T:MailKit.ProtocolException">
  50630. The server's response contained unexpected tokens.
  50631. </exception>
  50632. <exception cref="T:MailKit.CommandException">
  50633. The command failed.
  50634. </exception>
  50635. </member>
  50636. <member name="M:MailKit.MailFolder.SetLabelsAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50637. <summary>
  50638. Asynchronously set the labels of the specified messages only if their mod-sequence value is less than the specified value.
  50639. </summary>
  50640. <remarks>
  50641. Asynchronously sets the labels of the specified messages only if their mod-sequence value is less than the specified value.
  50642. </remarks>
  50643. <returns>The unique IDs of the messages that were not updated.</returns>
  50644. <param name="uids">The UIDs of the messages.</param>
  50645. <param name="modseq">The mod-sequence value.</param>
  50646. <param name="labels">The labels to set.</param>
  50647. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50648. <param name="cancellationToken">The cancellation token.</param>
  50649. <exception cref="T:System.ArgumentNullException">
  50650. <para><paramref name="uids"/> is <c>null</c>.</para>
  50651. <para>-or-</para>
  50652. <para><paramref name="labels"/> is <c>null</c>.</para>
  50653. </exception>
  50654. <exception cref="T:System.ArgumentException">
  50655. One or more of the <paramref name="uids"/> is invalid.
  50656. </exception>
  50657. <exception cref="T:System.ObjectDisposedException">
  50658. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50659. </exception>
  50660. <exception cref="T:MailKit.ServiceNotConnectedException">
  50661. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50662. </exception>
  50663. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50664. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50665. </exception>
  50666. <exception cref="T:MailKit.FolderNotOpenException">
  50667. The folder is not currently open in read-write mode.
  50668. </exception>
  50669. <exception cref="T:System.NotSupportedException">
  50670. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  50671. </exception>
  50672. <exception cref="T:System.OperationCanceledException">
  50673. The operation was canceled via the cancellation token.
  50674. </exception>
  50675. <exception cref="T:System.IO.IOException">
  50676. An I/O error occurred.
  50677. </exception>
  50678. <exception cref="T:MailKit.ProtocolException">
  50679. The server's response contained unexpected tokens.
  50680. </exception>
  50681. <exception cref="T:MailKit.CommandException">
  50682. The command failed.
  50683. </exception>
  50684. </member>
  50685. <member name="M:MailKit.MailFolder.AddLabels(System.Int32,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50686. <summary>
  50687. Add a set of labels to the specified message.
  50688. </summary>
  50689. <remarks>
  50690. Adds a set of labels to the specified message.
  50691. </remarks>
  50692. <param name="index">The index of the message.</param>
  50693. <param name="labels">The labels to add.</param>
  50694. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50695. <param name="cancellationToken">The cancellation token.</param>
  50696. <exception cref="T:System.ArgumentNullException">
  50697. <paramref name="labels"/> is <c>null</c>.
  50698. </exception>
  50699. <exception cref="T:System.ArgumentException">
  50700. <para><paramref name="index"/> is invalid.</para>
  50701. <para>-or-</para>
  50702. <para>No labels were specified.</para>
  50703. </exception>
  50704. <exception cref="T:System.ObjectDisposedException">
  50705. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50706. </exception>
  50707. <exception cref="T:MailKit.ServiceNotConnectedException">
  50708. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50709. </exception>
  50710. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50711. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50712. </exception>
  50713. <exception cref="T:MailKit.FolderNotOpenException">
  50714. The folder is not currently open in read-write mode.
  50715. </exception>
  50716. <exception cref="T:System.OperationCanceledException">
  50717. The operation was canceled via the cancellation token.
  50718. </exception>
  50719. <exception cref="T:System.IO.IOException">
  50720. An I/O error occurred.
  50721. </exception>
  50722. <exception cref="T:MailKit.ProtocolException">
  50723. The server's response contained unexpected tokens.
  50724. </exception>
  50725. <exception cref="T:MailKit.CommandException">
  50726. The command failed.
  50727. </exception>
  50728. </member>
  50729. <member name="M:MailKit.MailFolder.AddLabelsAsync(System.Int32,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50730. <summary>
  50731. Asynchronously add a set of labels to the specified message.
  50732. </summary>
  50733. <remarks>
  50734. Asynchronously adds a set of labels to the specified message.
  50735. </remarks>
  50736. <returns>An asynchronous task context.</returns>
  50737. <param name="index">The index of the messages.</param>
  50738. <param name="labels">The labels to add.</param>
  50739. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50740. <param name="cancellationToken">The cancellation token.</param>
  50741. <exception cref="T:System.ArgumentNullException">
  50742. <paramref name="labels"/> is <c>null</c>.
  50743. </exception>
  50744. <exception cref="T:System.ArgumentException">
  50745. <para><paramref name="index"/> is invalid.</para>
  50746. <para>-or-</para>
  50747. <para>No labels were specified.</para>
  50748. </exception>
  50749. <exception cref="T:System.ObjectDisposedException">
  50750. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50751. </exception>
  50752. <exception cref="T:MailKit.ServiceNotConnectedException">
  50753. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50754. </exception>
  50755. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50756. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50757. </exception>
  50758. <exception cref="T:MailKit.FolderNotOpenException">
  50759. The folder is not currently open in read-write mode.
  50760. </exception>
  50761. <exception cref="T:System.OperationCanceledException">
  50762. The operation was canceled via the cancellation token.
  50763. </exception>
  50764. <exception cref="T:System.IO.IOException">
  50765. An I/O error occurred.
  50766. </exception>
  50767. <exception cref="T:MailKit.ProtocolException">
  50768. The server's response contained unexpected tokens.
  50769. </exception>
  50770. <exception cref="T:MailKit.CommandException">
  50771. The command failed.
  50772. </exception>
  50773. </member>
  50774. <member name="M:MailKit.MailFolder.AddLabels(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50775. <summary>
  50776. Add a set of labels to the specified messages.
  50777. </summary>
  50778. <remarks>
  50779. Adds a set of labels to the specified messages.
  50780. </remarks>
  50781. <param name="indexes">The indexes of the messages.</param>
  50782. <param name="labels">The labels to add.</param>
  50783. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50784. <param name="cancellationToken">The cancellation token.</param>
  50785. <exception cref="T:System.ArgumentNullException">
  50786. <para><paramref name="indexes"/> is <c>null</c>.</para>
  50787. <para>-or-</para>
  50788. <para><paramref name="labels"/> is <c>null</c>.</para>
  50789. </exception>
  50790. <exception cref="T:System.ArgumentException">
  50791. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  50792. <para>-or-</para>
  50793. <para>No labels were specified.</para>
  50794. </exception>
  50795. <exception cref="T:System.ObjectDisposedException">
  50796. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50797. </exception>
  50798. <exception cref="T:MailKit.ServiceNotConnectedException">
  50799. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50800. </exception>
  50801. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50802. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50803. </exception>
  50804. <exception cref="T:MailKit.FolderNotOpenException">
  50805. The folder is not currently open in read-write mode.
  50806. </exception>
  50807. <exception cref="T:System.OperationCanceledException">
  50808. The operation was canceled via the cancellation token.
  50809. </exception>
  50810. <exception cref="T:System.IO.IOException">
  50811. An I/O error occurred.
  50812. </exception>
  50813. <exception cref="T:MailKit.ProtocolException">
  50814. The server's response contained unexpected tokens.
  50815. </exception>
  50816. <exception cref="T:MailKit.CommandException">
  50817. The command failed.
  50818. </exception>
  50819. </member>
  50820. <member name="M:MailKit.MailFolder.AddLabelsAsync(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50821. <summary>
  50822. Asynchronously add a set of labels to the specified messages.
  50823. </summary>
  50824. <remarks>
  50825. Asynchronously adds a set of labels to the specified messages.
  50826. </remarks>
  50827. <returns>An asynchronous task context.</returns>
  50828. <param name="indexes">The indexes of the messages.</param>
  50829. <param name="labels">The labels to add.</param>
  50830. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50831. <param name="cancellationToken">The cancellation token.</param>
  50832. <exception cref="T:System.ArgumentNullException">
  50833. <para><paramref name="indexes"/> is <c>null</c>.</para>
  50834. <para>-or-</para>
  50835. <para><paramref name="labels"/> is <c>null</c>.</para>
  50836. </exception>
  50837. <exception cref="T:System.ArgumentException">
  50838. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  50839. <para>-or-</para>
  50840. <para>No labels were specified.</para>
  50841. </exception>
  50842. <exception cref="T:System.ObjectDisposedException">
  50843. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50844. </exception>
  50845. <exception cref="T:MailKit.ServiceNotConnectedException">
  50846. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50847. </exception>
  50848. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50849. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50850. </exception>
  50851. <exception cref="T:MailKit.FolderNotOpenException">
  50852. The folder is not currently open in read-write mode.
  50853. </exception>
  50854. <exception cref="T:System.OperationCanceledException">
  50855. The operation was canceled via the cancellation token.
  50856. </exception>
  50857. <exception cref="T:System.IO.IOException">
  50858. An I/O error occurred.
  50859. </exception>
  50860. <exception cref="T:MailKit.ProtocolException">
  50861. The server's response contained unexpected tokens.
  50862. </exception>
  50863. <exception cref="T:MailKit.CommandException">
  50864. The command failed.
  50865. </exception>
  50866. </member>
  50867. <member name="M:MailKit.MailFolder.RemoveLabels(System.Int32,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50868. <summary>
  50869. Remove a set of labels from the specified message.
  50870. </summary>
  50871. <remarks>
  50872. Removes a set of labels from the specified message.
  50873. </remarks>
  50874. <param name="index">The index of the message.</param>
  50875. <param name="labels">The labels to remove.</param>
  50876. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50877. <param name="cancellationToken">The cancellation token.</param>
  50878. <exception cref="T:System.ArgumentNullException">
  50879. <paramref name="labels"/> is <c>null</c>.
  50880. </exception>
  50881. <exception cref="T:System.ArgumentException">
  50882. <para><paramref name="index"/> is invalid.</para>
  50883. <para>-or-</para>
  50884. <para>No labels were specified.</para>
  50885. </exception>
  50886. <exception cref="T:System.ObjectDisposedException">
  50887. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50888. </exception>
  50889. <exception cref="T:MailKit.ServiceNotConnectedException">
  50890. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50891. </exception>
  50892. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50893. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50894. </exception>
  50895. <exception cref="T:MailKit.FolderNotOpenException">
  50896. The folder is not currently open in read-write mode.
  50897. </exception>
  50898. <exception cref="T:System.OperationCanceledException">
  50899. The operation was canceled via the cancellation token.
  50900. </exception>
  50901. <exception cref="T:System.IO.IOException">
  50902. An I/O error occurred.
  50903. </exception>
  50904. <exception cref="T:MailKit.ProtocolException">
  50905. The server's response contained unexpected tokens.
  50906. </exception>
  50907. <exception cref="T:MailKit.CommandException">
  50908. The command failed.
  50909. </exception>
  50910. </member>
  50911. <member name="M:MailKit.MailFolder.RemoveLabelsAsync(System.Int32,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50912. <summary>
  50913. Asynchronously remove a set of labels from the specified message.
  50914. </summary>
  50915. <remarks>
  50916. Asynchronously removes a set of labels from the specified message.
  50917. </remarks>
  50918. <returns>An asynchronous task context.</returns>
  50919. <param name="index">The index of the message.</param>
  50920. <param name="labels">The labels to remove.</param>
  50921. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50922. <param name="cancellationToken">The cancellation token.</param>
  50923. <exception cref="T:System.ArgumentNullException">
  50924. <paramref name="labels"/> is <c>null</c>.
  50925. </exception>
  50926. <exception cref="T:System.ArgumentException">
  50927. <para><paramref name="index"/> is invalid.</para>
  50928. <para>-or-</para>
  50929. <para>No labels were specified.</para>
  50930. </exception>
  50931. <exception cref="T:System.ObjectDisposedException">
  50932. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50933. </exception>
  50934. <exception cref="T:MailKit.ServiceNotConnectedException">
  50935. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50936. </exception>
  50937. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50938. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50939. </exception>
  50940. <exception cref="T:MailKit.FolderNotOpenException">
  50941. The folder is not currently open in read-write mode.
  50942. </exception>
  50943. <exception cref="T:System.OperationCanceledException">
  50944. The operation was canceled via the cancellation token.
  50945. </exception>
  50946. <exception cref="T:System.IO.IOException">
  50947. An I/O error occurred.
  50948. </exception>
  50949. <exception cref="T:MailKit.ProtocolException">
  50950. The server's response contained unexpected tokens.
  50951. </exception>
  50952. <exception cref="T:MailKit.CommandException">
  50953. The command failed.
  50954. </exception>
  50955. </member>
  50956. <member name="M:MailKit.MailFolder.RemoveLabels(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  50957. <summary>
  50958. Remove a set of labels from the specified messages.
  50959. </summary>
  50960. <remarks>
  50961. Removes a set of labels from the specified messages.
  50962. </remarks>
  50963. <param name="indexes">The indexes of the messages.</param>
  50964. <param name="labels">The labels to remove.</param>
  50965. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  50966. <param name="cancellationToken">The cancellation token.</param>
  50967. <exception cref="T:System.ArgumentNullException">
  50968. <para><paramref name="indexes"/> is <c>null</c>.</para>
  50969. <para>-or-</para>
  50970. <para><paramref name="labels"/> is <c>null</c>.</para>
  50971. </exception>
  50972. <exception cref="T:System.ArgumentException">
  50973. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  50974. <para>-or-</para>
  50975. <para>No labels were specified.</para>
  50976. </exception>
  50977. <exception cref="T:System.ObjectDisposedException">
  50978. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  50979. </exception>
  50980. <exception cref="T:MailKit.ServiceNotConnectedException">
  50981. The <see cref="T:MailKit.IMailStore"/> is not connected.
  50982. </exception>
  50983. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  50984. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  50985. </exception>
  50986. <exception cref="T:MailKit.FolderNotOpenException">
  50987. The folder is not currently open in read-write mode.
  50988. </exception>
  50989. <exception cref="T:System.OperationCanceledException">
  50990. The operation was canceled via the cancellation token.
  50991. </exception>
  50992. <exception cref="T:System.IO.IOException">
  50993. An I/O error occurred.
  50994. </exception>
  50995. <exception cref="T:MailKit.ProtocolException">
  50996. The server's response contained unexpected tokens.
  50997. </exception>
  50998. <exception cref="T:MailKit.CommandException">
  50999. The command failed.
  51000. </exception>
  51001. </member>
  51002. <member name="M:MailKit.MailFolder.RemoveLabelsAsync(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  51003. <summary>
  51004. Asynchronously remove a set of labels from the specified messages.
  51005. </summary>
  51006. <remarks>
  51007. Asynchronously removes a set of labels from the specified messages.
  51008. </remarks>
  51009. <returns>An asynchronous task context.</returns>
  51010. <param name="indexes">The indexes of the messages.</param>
  51011. <param name="labels">The labels to remove.</param>
  51012. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  51013. <param name="cancellationToken">The cancellation token.</param>
  51014. <exception cref="T:System.ArgumentNullException">
  51015. <para><paramref name="indexes"/> is <c>null</c>.</para>
  51016. <para>-or-</para>
  51017. <para><paramref name="labels"/> is <c>null</c>.</para>
  51018. </exception>
  51019. <exception cref="T:System.ArgumentException">
  51020. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  51021. <para>-or-</para>
  51022. <para>No labels were specified.</para>
  51023. </exception>
  51024. <exception cref="T:System.ObjectDisposedException">
  51025. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51026. </exception>
  51027. <exception cref="T:MailKit.ServiceNotConnectedException">
  51028. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51029. </exception>
  51030. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51031. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51032. </exception>
  51033. <exception cref="T:MailKit.FolderNotOpenException">
  51034. The folder is not currently open in read-write mode.
  51035. </exception>
  51036. <exception cref="T:System.OperationCanceledException">
  51037. The operation was canceled via the cancellation token.
  51038. </exception>
  51039. <exception cref="T:System.IO.IOException">
  51040. An I/O error occurred.
  51041. </exception>
  51042. <exception cref="T:MailKit.ProtocolException">
  51043. The server's response contained unexpected tokens.
  51044. </exception>
  51045. <exception cref="T:MailKit.CommandException">
  51046. The command failed.
  51047. </exception>
  51048. </member>
  51049. <member name="M:MailKit.MailFolder.SetLabels(System.Int32,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  51050. <summary>
  51051. Set the labels of the specified message.
  51052. </summary>
  51053. <remarks>
  51054. Sets the labels of the specified message.
  51055. </remarks>
  51056. <param name="index">The index of the message.</param>
  51057. <param name="labels">The labels to set.</param>
  51058. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  51059. <param name="cancellationToken">The cancellation token.</param>
  51060. <exception cref="T:System.ArgumentNullException">
  51061. <paramref name="labels"/> is <c>null</c>.
  51062. </exception>
  51063. <exception cref="T:System.ArgumentException">
  51064. <para><paramref name="index"/> is invalid.</para>
  51065. </exception>
  51066. <exception cref="T:System.ObjectDisposedException">
  51067. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51068. </exception>
  51069. <exception cref="T:MailKit.ServiceNotConnectedException">
  51070. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51071. </exception>
  51072. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51073. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51074. </exception>
  51075. <exception cref="T:MailKit.FolderNotOpenException">
  51076. The folder is not currently open in read-write mode.
  51077. </exception>
  51078. <exception cref="T:System.OperationCanceledException">
  51079. The operation was canceled via the cancellation token.
  51080. </exception>
  51081. <exception cref="T:System.IO.IOException">
  51082. An I/O error occurred.
  51083. </exception>
  51084. <exception cref="T:MailKit.ProtocolException">
  51085. The server's response contained unexpected tokens.
  51086. </exception>
  51087. <exception cref="T:MailKit.CommandException">
  51088. The command failed.
  51089. </exception>
  51090. </member>
  51091. <member name="M:MailKit.MailFolder.SetLabelsAsync(System.Int32,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  51092. <summary>
  51093. Asynchronously set the labels of the specified message.
  51094. </summary>
  51095. <remarks>
  51096. Asynchronously sets the labels of the specified message.
  51097. </remarks>
  51098. <returns>An asynchronous task context.</returns>
  51099. <param name="index">The index of the message.</param>
  51100. <param name="labels">The labels to set.</param>
  51101. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  51102. <param name="cancellationToken">The cancellation token.</param>
  51103. <exception cref="T:System.ArgumentNullException">
  51104. <paramref name="labels"/> is <c>null</c>.
  51105. </exception>
  51106. <exception cref="T:System.ArgumentException">
  51107. <para><paramref name="index"/> is invalid.</para>
  51108. </exception>
  51109. <exception cref="T:System.ObjectDisposedException">
  51110. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51111. </exception>
  51112. <exception cref="T:MailKit.ServiceNotConnectedException">
  51113. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51114. </exception>
  51115. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51116. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51117. </exception>
  51118. <exception cref="T:MailKit.FolderNotOpenException">
  51119. The folder is not currently open in read-write mode.
  51120. </exception>
  51121. <exception cref="T:System.OperationCanceledException">
  51122. The operation was canceled via the cancellation token.
  51123. </exception>
  51124. <exception cref="T:System.IO.IOException">
  51125. An I/O error occurred.
  51126. </exception>
  51127. <exception cref="T:MailKit.ProtocolException">
  51128. The server's response contained unexpected tokens.
  51129. </exception>
  51130. <exception cref="T:MailKit.CommandException">
  51131. The command failed.
  51132. </exception>
  51133. </member>
  51134. <member name="M:MailKit.MailFolder.SetLabels(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  51135. <summary>
  51136. Set the labels of the specified messages.
  51137. </summary>
  51138. <remarks>
  51139. Sets the labels of the specified messages.
  51140. </remarks>
  51141. <param name="indexes">The indexes of the messages.</param>
  51142. <param name="labels">The labels to set.</param>
  51143. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  51144. <param name="cancellationToken">The cancellation token.</param>
  51145. <exception cref="T:System.ArgumentNullException">
  51146. <para><paramref name="indexes"/> is <c>null</c>.</para>
  51147. <para>-or-</para>
  51148. <para><paramref name="labels"/> is <c>null</c>.</para>
  51149. </exception>
  51150. <exception cref="T:System.ArgumentException">
  51151. One or more of the <paramref name="indexes"/> is invalid.
  51152. </exception>
  51153. <exception cref="T:System.ObjectDisposedException">
  51154. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51155. </exception>
  51156. <exception cref="T:MailKit.ServiceNotConnectedException">
  51157. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51158. </exception>
  51159. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51160. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51161. </exception>
  51162. <exception cref="T:MailKit.FolderNotOpenException">
  51163. The folder is not currently open in read-write mode.
  51164. </exception>
  51165. <exception cref="T:System.OperationCanceledException">
  51166. The operation was canceled via the cancellation token.
  51167. </exception>
  51168. <exception cref="T:System.IO.IOException">
  51169. An I/O error occurred.
  51170. </exception>
  51171. <exception cref="T:MailKit.ProtocolException">
  51172. The server's response contained unexpected tokens.
  51173. </exception>
  51174. <exception cref="T:MailKit.CommandException">
  51175. The command failed.
  51176. </exception>
  51177. </member>
  51178. <member name="M:MailKit.MailFolder.SetLabelsAsync(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  51179. <summary>
  51180. Asynchronously set the labels of the specified messages.
  51181. </summary>
  51182. <remarks>
  51183. Asynchronously sets the labels of the specified messages.
  51184. </remarks>
  51185. <returns>An asynchronous task context.</returns>
  51186. <param name="indexes">The indexes of the messages.</param>
  51187. <param name="labels">The labels to set.</param>
  51188. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  51189. <param name="cancellationToken">The cancellation token.</param>
  51190. <exception cref="T:System.ArgumentNullException">
  51191. <para><paramref name="indexes"/> is <c>null</c>.</para>
  51192. <para>-or-</para>
  51193. <para><paramref name="labels"/> is <c>null</c>.</para>
  51194. </exception>
  51195. <exception cref="T:System.ArgumentException">
  51196. One or more of the <paramref name="indexes"/> is invalid.
  51197. </exception>
  51198. <exception cref="T:System.ObjectDisposedException">
  51199. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51200. </exception>
  51201. <exception cref="T:MailKit.ServiceNotConnectedException">
  51202. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51203. </exception>
  51204. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51205. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51206. </exception>
  51207. <exception cref="T:MailKit.FolderNotOpenException">
  51208. The folder is not currently open in read-write mode.
  51209. </exception>
  51210. <exception cref="T:System.OperationCanceledException">
  51211. The operation was canceled via the cancellation token.
  51212. </exception>
  51213. <exception cref="T:System.IO.IOException">
  51214. An I/O error occurred.
  51215. </exception>
  51216. <exception cref="T:MailKit.ProtocolException">
  51217. The server's response contained unexpected tokens.
  51218. </exception>
  51219. <exception cref="T:MailKit.CommandException">
  51220. The command failed.
  51221. </exception>
  51222. </member>
  51223. <member name="M:MailKit.MailFolder.AddLabels(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  51224. <summary>
  51225. Add a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  51226. </summary>
  51227. <remarks>
  51228. Adds a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  51229. </remarks>
  51230. <returns>The indexes of the messages that were not updated.</returns>
  51231. <param name="indexes">The indexes of the messages.</param>
  51232. <param name="modseq">The mod-sequence value.</param>
  51233. <param name="labels">The labels to add.</param>
  51234. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  51235. <param name="cancellationToken">The cancellation token.</param>
  51236. <exception cref="T:System.ArgumentNullException">
  51237. <para><paramref name="indexes"/> is <c>null</c>.</para>
  51238. <para>-or-</para>
  51239. <para><paramref name="labels"/> is <c>null</c>.</para>
  51240. </exception>
  51241. <exception cref="T:System.ArgumentException">
  51242. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  51243. <para>-or-</para>
  51244. <para>No labels were specified.</para>
  51245. </exception>
  51246. <exception cref="T:System.ObjectDisposedException">
  51247. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51248. </exception>
  51249. <exception cref="T:MailKit.ServiceNotConnectedException">
  51250. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51251. </exception>
  51252. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51253. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51254. </exception>
  51255. <exception cref="T:MailKit.FolderNotOpenException">
  51256. The folder is not currently open in read-write mode.
  51257. </exception>
  51258. <exception cref="T:System.NotSupportedException">
  51259. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  51260. </exception>
  51261. <exception cref="T:System.OperationCanceledException">
  51262. The operation was canceled via the cancellation token.
  51263. </exception>
  51264. <exception cref="T:System.IO.IOException">
  51265. An I/O error occurred.
  51266. </exception>
  51267. <exception cref="T:MailKit.ProtocolException">
  51268. The server's response contained unexpected tokens.
  51269. </exception>
  51270. <exception cref="T:MailKit.CommandException">
  51271. The command failed.
  51272. </exception>
  51273. </member>
  51274. <member name="M:MailKit.MailFolder.AddLabelsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  51275. <summary>
  51276. Asynchronously add a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  51277. </summary>
  51278. <remarks>
  51279. Asynchronously adds a set of labels to the specified messages only if their mod-sequence value is less than the specified value.
  51280. </remarks>
  51281. <returns>The indexes of the messages that were not updated.</returns>
  51282. <param name="indexes">The indexes of the messages.</param>
  51283. <param name="modseq">The mod-sequence value.</param>
  51284. <param name="labels">The labels to add.</param>
  51285. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  51286. <param name="cancellationToken">The cancellation token.</param>
  51287. <exception cref="T:System.ArgumentNullException">
  51288. <para><paramref name="indexes"/> is <c>null</c>.</para>
  51289. <para>-or-</para>
  51290. <para><paramref name="labels"/> is <c>null</c>.</para>
  51291. </exception>
  51292. <exception cref="T:System.ArgumentException">
  51293. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  51294. <para>-or-</para>
  51295. <para>No labels were specified.</para>
  51296. </exception>
  51297. <exception cref="T:System.ObjectDisposedException">
  51298. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51299. </exception>
  51300. <exception cref="T:MailKit.ServiceNotConnectedException">
  51301. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51302. </exception>
  51303. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51304. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51305. </exception>
  51306. <exception cref="T:MailKit.FolderNotOpenException">
  51307. The folder is not currently open in read-write mode.
  51308. </exception>
  51309. <exception cref="T:System.NotSupportedException">
  51310. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  51311. </exception>
  51312. <exception cref="T:System.OperationCanceledException">
  51313. The operation was canceled via the cancellation token.
  51314. </exception>
  51315. <exception cref="T:System.IO.IOException">
  51316. An I/O error occurred.
  51317. </exception>
  51318. <exception cref="T:MailKit.ProtocolException">
  51319. The server's response contained unexpected tokens.
  51320. </exception>
  51321. <exception cref="T:MailKit.CommandException">
  51322. The command failed.
  51323. </exception>
  51324. </member>
  51325. <member name="M:MailKit.MailFolder.RemoveLabels(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  51326. <summary>
  51327. Remove a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  51328. </summary>
  51329. <remarks>
  51330. Removes a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  51331. </remarks>
  51332. <returns>The indexes of the messages that were not updated.</returns>
  51333. <param name="indexes">The indexes of the messages.</param>
  51334. <param name="modseq">The mod-sequence value.</param>
  51335. <param name="labels">The labels to remove.</param>
  51336. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  51337. <param name="cancellationToken">The cancellation token.</param>
  51338. <exception cref="T:System.ArgumentNullException">
  51339. <para><paramref name="indexes"/> is <c>null</c>.</para>
  51340. <para>-or-</para>
  51341. <para><paramref name="labels"/> is <c>null</c>.</para>
  51342. </exception>
  51343. <exception cref="T:System.ArgumentException">
  51344. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  51345. <para>-or-</para>
  51346. <para>No labels were specified.</para>
  51347. </exception>
  51348. <exception cref="T:System.ObjectDisposedException">
  51349. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51350. </exception>
  51351. <exception cref="T:MailKit.ServiceNotConnectedException">
  51352. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51353. </exception>
  51354. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51355. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51356. </exception>
  51357. <exception cref="T:MailKit.FolderNotOpenException">
  51358. The folder is not currently open in read-write mode.
  51359. </exception>
  51360. <exception cref="T:System.NotSupportedException">
  51361. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  51362. </exception>
  51363. <exception cref="T:System.OperationCanceledException">
  51364. The operation was canceled via the cancellation token.
  51365. </exception>
  51366. <exception cref="T:System.IO.IOException">
  51367. An I/O error occurred.
  51368. </exception>
  51369. <exception cref="T:MailKit.ProtocolException">
  51370. The server's response contained unexpected tokens.
  51371. </exception>
  51372. <exception cref="T:MailKit.CommandException">
  51373. The command failed.
  51374. </exception>
  51375. </member>
  51376. <member name="M:MailKit.MailFolder.RemoveLabelsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  51377. <summary>
  51378. Asynchronously remove a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  51379. </summary>
  51380. <remarks>
  51381. Asynchronously removes a set of labels from the specified messages only if their mod-sequence value is less than the specified value.
  51382. </remarks>
  51383. <returns>The indexes of the messages that were not updated.</returns>
  51384. <param name="indexes">The indexes of the messages.</param>
  51385. <param name="modseq">The mod-sequence value.</param>
  51386. <param name="labels">The labels to remove.</param>
  51387. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  51388. <param name="cancellationToken">The cancellation token.</param>
  51389. <exception cref="T:System.ArgumentNullException">
  51390. <para><paramref name="indexes"/> is <c>null</c>.</para>
  51391. <para>-or-</para>
  51392. <para><paramref name="labels"/> is <c>null</c>.</para>
  51393. </exception>
  51394. <exception cref="T:System.ArgumentException">
  51395. <para>One or more of the <paramref name="indexes"/> is invalid.</para>
  51396. <para>-or-</para>
  51397. <para>No labels were specified.</para>
  51398. </exception>
  51399. <exception cref="T:System.ObjectDisposedException">
  51400. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51401. </exception>
  51402. <exception cref="T:MailKit.ServiceNotConnectedException">
  51403. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51404. </exception>
  51405. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51406. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51407. </exception>
  51408. <exception cref="T:MailKit.FolderNotOpenException">
  51409. The folder is not currently open in read-write mode.
  51410. </exception>
  51411. <exception cref="T:System.NotSupportedException">
  51412. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  51413. </exception>
  51414. <exception cref="T:System.OperationCanceledException">
  51415. The operation was canceled via the cancellation token.
  51416. </exception>
  51417. <exception cref="T:System.IO.IOException">
  51418. An I/O error occurred.
  51419. </exception>
  51420. <exception cref="T:MailKit.ProtocolException">
  51421. The server's response contained unexpected tokens.
  51422. </exception>
  51423. <exception cref="T:MailKit.CommandException">
  51424. The command failed.
  51425. </exception>
  51426. </member>
  51427. <member name="M:MailKit.MailFolder.SetLabels(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  51428. <summary>
  51429. Set the labels of the specified messages only if their mod-sequence value is less than the specified value.
  51430. </summary>
  51431. <remarks>
  51432. Sets the labels of the specified messages only if their mod-sequence value is less than the specified value.
  51433. </remarks>
  51434. <returns>The indexes of the messages that were not updated.</returns>
  51435. <param name="indexes">The indexes of the messages.</param>
  51436. <param name="modseq">The mod-sequence value.</param>
  51437. <param name="labels">The labels to set.</param>
  51438. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  51439. <param name="cancellationToken">The cancellation token.</param>
  51440. <exception cref="T:System.ArgumentNullException">
  51441. <para><paramref name="indexes"/> is <c>null</c>.</para>
  51442. <para>-or-</para>
  51443. <para><paramref name="labels"/> is <c>null</c>.</para>
  51444. </exception>
  51445. <exception cref="T:System.ArgumentException">
  51446. One or more of the <paramref name="indexes"/> is invalid.
  51447. </exception>
  51448. <exception cref="T:System.ObjectDisposedException">
  51449. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51450. </exception>
  51451. <exception cref="T:MailKit.ServiceNotConnectedException">
  51452. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51453. </exception>
  51454. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51455. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51456. </exception>
  51457. <exception cref="T:MailKit.FolderNotOpenException">
  51458. The folder is not currently open in read-write mode.
  51459. </exception>
  51460. <exception cref="T:System.NotSupportedException">
  51461. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  51462. </exception>
  51463. <exception cref="T:System.OperationCanceledException">
  51464. The operation was canceled via the cancellation token.
  51465. </exception>
  51466. <exception cref="T:System.IO.IOException">
  51467. An I/O error occurred.
  51468. </exception>
  51469. <exception cref="T:MailKit.ProtocolException">
  51470. The server's response contained unexpected tokens.
  51471. </exception>
  51472. <exception cref="T:MailKit.CommandException">
  51473. The command failed.
  51474. </exception>
  51475. </member>
  51476. <member name="M:MailKit.MailFolder.SetLabelsAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{System.String},System.Boolean,System.Threading.CancellationToken)">
  51477. <summary>
  51478. Asynchronously set the labels of the specified messages only if their mod-sequence value is less than the specified value.
  51479. </summary>
  51480. <remarks>
  51481. Asynchronously sets the labels of the specified messages only if their mod-sequence value is less than the specified value.
  51482. </remarks>
  51483. <returns>The indexes of the messages that were not updated.</returns>
  51484. <param name="indexes">The indexes of the messages.</param>
  51485. <param name="modseq">The mod-sequence value.</param>
  51486. <param name="labels">The labels to set.</param>
  51487. <param name="silent">If set to <c>true</c>, no <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> events will be emitted.</param>
  51488. <param name="cancellationToken">The cancellation token.</param>
  51489. <exception cref="T:System.ArgumentNullException">
  51490. <para><paramref name="indexes"/> is <c>null</c>.</para>
  51491. <para>-or-</para>
  51492. <para><paramref name="labels"/> is <c>null</c>.</para>
  51493. </exception>
  51494. <exception cref="T:System.ArgumentException">
  51495. One or more of the <paramref name="indexes"/> is invalid.
  51496. </exception>
  51497. <exception cref="T:System.ObjectDisposedException">
  51498. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51499. </exception>
  51500. <exception cref="T:MailKit.ServiceNotConnectedException">
  51501. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51502. </exception>
  51503. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51504. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51505. </exception>
  51506. <exception cref="T:MailKit.FolderNotOpenException">
  51507. The folder is not currently open in read-write mode.
  51508. </exception>
  51509. <exception cref="T:System.NotSupportedException">
  51510. The <see cref="T:MailKit.MailFolder"/> does not support mod-sequences.
  51511. </exception>
  51512. <exception cref="T:System.OperationCanceledException">
  51513. The operation was canceled via the cancellation token.
  51514. </exception>
  51515. <exception cref="T:System.IO.IOException">
  51516. An I/O error occurred.
  51517. </exception>
  51518. <exception cref="T:MailKit.ProtocolException">
  51519. The server's response contained unexpected tokens.
  51520. </exception>
  51521. <exception cref="T:MailKit.CommandException">
  51522. The command failed.
  51523. </exception>
  51524. </member>
  51525. <member name="M:MailKit.MailFolder.Store(MailKit.UniqueId,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  51526. <summary>
  51527. Store the annotations for the specified message.
  51528. </summary>
  51529. <remarks>
  51530. Stores the annotations for the specified message.
  51531. </remarks>
  51532. <param name="uid">The UID of the message.</param>
  51533. <param name="annotations">The annotations to store.</param>
  51534. <param name="cancellationToken">The cancellation token.</param>
  51535. <exception cref="T:System.ArgumentNullException">
  51536. <paramref name="annotations"/> is <c>null</c>.
  51537. </exception>
  51538. <exception cref="T:System.ArgumentException">
  51539. <paramref name="uid"/> is invalid.
  51540. </exception>
  51541. <exception cref="T:System.ObjectDisposedException">
  51542. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51543. </exception>
  51544. <exception cref="T:MailKit.ServiceNotConnectedException">
  51545. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51546. </exception>
  51547. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51548. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51549. </exception>
  51550. <exception cref="T:MailKit.FolderNotOpenException">
  51551. The <see cref="T:MailKit.IMailFolder"/> is not currently open in read-write mode.
  51552. </exception>
  51553. <exception cref="T:System.InvalidOperationException">
  51554. Cannot store annotations without any properties defined.
  51555. </exception>
  51556. <exception cref="T:System.NotSupportedException">
  51557. The <see cref="T:MailKit.IMailFolder"/> does not support annotations.
  51558. </exception>
  51559. <exception cref="T:System.OperationCanceledException">
  51560. The operation was canceled via the cancellation token.
  51561. </exception>
  51562. <exception cref="T:System.IO.IOException">
  51563. An I/O error occurred.
  51564. </exception>
  51565. <exception cref="T:MailKit.ProtocolException">
  51566. The server's response contained unexpected tokens.
  51567. </exception>
  51568. <exception cref="T:MailKit.CommandException">
  51569. The command failed.
  51570. </exception>
  51571. </member>
  51572. <member name="M:MailKit.MailFolder.StoreAsync(MailKit.UniqueId,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  51573. <summary>
  51574. Asynchronously store the annotations for the specified message.
  51575. </summary>
  51576. <remarks>
  51577. Asynchronously stores the annotations for the specified message.
  51578. </remarks>
  51579. <returns>An asynchronous task context.</returns>
  51580. <param name="uid">The UID of the message.</param>
  51581. <param name="annotations">The annotations to store.</param>
  51582. <param name="cancellationToken">The cancellation token.</param>
  51583. <exception cref="T:System.ArgumentNullException">
  51584. <paramref name="annotations"/> is <c>null</c>.
  51585. </exception>
  51586. <exception cref="T:System.ArgumentException">
  51587. <paramref name="uid"/> is invalid.
  51588. </exception>
  51589. <exception cref="T:System.ObjectDisposedException">
  51590. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51591. </exception>
  51592. <exception cref="T:MailKit.ServiceNotConnectedException">
  51593. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51594. </exception>
  51595. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51596. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51597. </exception>
  51598. <exception cref="T:MailKit.FolderNotOpenException">
  51599. The <see cref="T:MailKit.IMailFolder"/> is not currently open in read-write mode.
  51600. </exception>
  51601. <exception cref="T:System.InvalidOperationException">
  51602. Cannot store annotations without any properties defined.
  51603. </exception>
  51604. <exception cref="T:System.NotSupportedException">
  51605. The <see cref="T:MailKit.IMailFolder"/> does not support annotations.
  51606. </exception>
  51607. <exception cref="T:System.OperationCanceledException">
  51608. The operation was canceled via the cancellation token.
  51609. </exception>
  51610. <exception cref="T:System.IO.IOException">
  51611. An I/O error occurred.
  51612. </exception>
  51613. <exception cref="T:MailKit.ProtocolException">
  51614. The server's response contained unexpected tokens.
  51615. </exception>
  51616. <exception cref="T:MailKit.CommandException">
  51617. The command failed.
  51618. </exception>
  51619. </member>
  51620. <member name="M:MailKit.MailFolder.Store(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  51621. <summary>
  51622. Store the annotations for the specified messages.
  51623. </summary>
  51624. <remarks>
  51625. Stores the annotations for the specified messages.
  51626. </remarks>
  51627. <param name="uids">The UIDs of the messages.</param>
  51628. <param name="annotations">The annotations to store.</param>
  51629. <param name="cancellationToken">The cancellation token.</param>
  51630. <exception cref="T:System.ArgumentNullException">
  51631. <para><paramref name="uids"/> is <c>null</c>.</para>
  51632. <para>-or-</para>
  51633. <para><paramref name="annotations"/> is <c>null</c>.</para>
  51634. </exception>
  51635. <exception cref="T:System.ArgumentException">
  51636. One or more of the <paramref name="uids"/> is invalid.
  51637. </exception>
  51638. <exception cref="T:System.ObjectDisposedException">
  51639. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51640. </exception>
  51641. <exception cref="T:MailKit.ServiceNotConnectedException">
  51642. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51643. </exception>
  51644. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51645. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51646. </exception>
  51647. <exception cref="T:MailKit.FolderNotOpenException">
  51648. The <see cref="T:MailKit.IMailFolder"/> is not currently open in read-write mode.
  51649. </exception>
  51650. <exception cref="T:System.InvalidOperationException">
  51651. Cannot store annotations without any properties defined.
  51652. </exception>
  51653. <exception cref="T:System.NotSupportedException">
  51654. The <see cref="T:MailKit.IMailFolder"/> does not support annotations.
  51655. </exception>
  51656. <exception cref="T:System.OperationCanceledException">
  51657. The operation was canceled via the cancellation token.
  51658. </exception>
  51659. <exception cref="T:System.IO.IOException">
  51660. An I/O error occurred.
  51661. </exception>
  51662. <exception cref="T:MailKit.ProtocolException">
  51663. The server's response contained unexpected tokens.
  51664. </exception>
  51665. <exception cref="T:MailKit.CommandException">
  51666. The command failed.
  51667. </exception>
  51668. </member>
  51669. <member name="M:MailKit.MailFolder.StoreAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  51670. <summary>
  51671. Asynchronously store the annotations for the specified messages.
  51672. </summary>
  51673. <remarks>
  51674. Asynchronously stores the annotations for the specified messages.
  51675. </remarks>
  51676. <returns>An asynchronous task context.</returns>
  51677. <param name="uids">The UIDs of the messages.</param>
  51678. <param name="annotations">The annotations to store.</param>
  51679. <param name="cancellationToken">The cancellation token.</param>
  51680. <exception cref="T:System.ArgumentNullException">
  51681. <para><paramref name="uids"/> is <c>null</c>.</para>
  51682. <para>-or-</para>
  51683. <para><paramref name="annotations"/> is <c>null</c>.</para>
  51684. </exception>
  51685. <exception cref="T:System.ArgumentException">
  51686. One or more of the <paramref name="uids"/> is invalid.
  51687. </exception>
  51688. <exception cref="T:System.ObjectDisposedException">
  51689. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51690. </exception>
  51691. <exception cref="T:MailKit.ServiceNotConnectedException">
  51692. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51693. </exception>
  51694. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51695. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51696. </exception>
  51697. <exception cref="T:MailKit.FolderNotOpenException">
  51698. The <see cref="T:MailKit.IMailFolder"/> is not currently open in read-write mode.
  51699. </exception>
  51700. <exception cref="T:System.InvalidOperationException">
  51701. Cannot store annotations without any properties defined.
  51702. </exception>
  51703. <exception cref="T:System.NotSupportedException">
  51704. The <see cref="T:MailKit.IMailFolder"/> does not support annotations.
  51705. </exception>
  51706. <exception cref="T:System.OperationCanceledException">
  51707. The operation was canceled via the cancellation token.
  51708. </exception>
  51709. <exception cref="T:System.IO.IOException">
  51710. An I/O error occurred.
  51711. </exception>
  51712. <exception cref="T:MailKit.ProtocolException">
  51713. The server's response contained unexpected tokens.
  51714. </exception>
  51715. <exception cref="T:MailKit.CommandException">
  51716. The command failed.
  51717. </exception>
  51718. </member>
  51719. <member name="M:MailKit.MailFolder.Store(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  51720. <summary>
  51721. Store the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  51722. </summary>
  51723. <remarks>
  51724. Stores the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  51725. </remarks>
  51726. <returns>The unique IDs of the messages that were not updated.</returns>
  51727. <param name="uids">The UIDs of the messages.</param>
  51728. <param name="modseq">The mod-sequence value.</param>
  51729. <param name="annotations">The annotations to store.</param>
  51730. <param name="cancellationToken">The cancellation token.</param>
  51731. <exception cref="T:System.ArgumentNullException">
  51732. <para><paramref name="uids"/> is <c>null</c>.</para>
  51733. <para>-or-</para>
  51734. <para><paramref name="annotations"/> is <c>null</c>.</para>
  51735. </exception>
  51736. <exception cref="T:System.ArgumentException">
  51737. One or more of the <paramref name="uids"/> is invalid.
  51738. </exception>
  51739. <exception cref="T:System.ObjectDisposedException">
  51740. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51741. </exception>
  51742. <exception cref="T:MailKit.ServiceNotConnectedException">
  51743. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51744. </exception>
  51745. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51746. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51747. </exception>
  51748. <exception cref="T:MailKit.FolderNotOpenException">
  51749. The <see cref="T:MailKit.IMailFolder"/> is not currently open in read-write mode.
  51750. </exception>
  51751. <exception cref="T:System.InvalidOperationException">
  51752. Cannot store annotations without any properties defined.
  51753. </exception>
  51754. <exception cref="T:System.NotSupportedException">
  51755. <para>The <see cref="T:MailKit.IMailFolder"/> does not support annotations.</para>
  51756. <para>-or-</para>
  51757. <para>The <see cref="T:MailKit.IMailFolder"/> does not support mod-sequences.</para>
  51758. </exception>
  51759. <exception cref="T:System.OperationCanceledException">
  51760. The operation was canceled via the cancellation token.
  51761. </exception>
  51762. <exception cref="T:System.IO.IOException">
  51763. An I/O error occurred.
  51764. </exception>
  51765. <exception cref="T:MailKit.ProtocolException">
  51766. The server's response contained unexpected tokens.
  51767. </exception>
  51768. <exception cref="T:MailKit.CommandException">
  51769. The command failed.
  51770. </exception>
  51771. </member>
  51772. <member name="M:MailKit.MailFolder.StoreAsync(System.Collections.Generic.IList{MailKit.UniqueId},System.UInt64,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  51773. <summary>
  51774. Asynchronously store the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  51775. </summary>
  51776. <remarks>
  51777. Asynchronously stores the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  51778. </remarks>
  51779. <returns>The unique IDs of the messages that were not updated.</returns>
  51780. <param name="uids">The UIDs of the messages.</param>
  51781. <param name="modseq">The mod-sequence value.</param>
  51782. <param name="annotations">The annotations to store.</param>
  51783. <param name="cancellationToken">The cancellation token.</param>
  51784. <exception cref="T:System.ArgumentNullException">
  51785. <para><paramref name="uids"/> is <c>null</c>.</para>
  51786. <para>-or-</para>
  51787. <para><paramref name="annotations"/> is <c>null</c>.</para>
  51788. </exception>
  51789. <exception cref="T:System.ArgumentException">
  51790. One or more of the <paramref name="uids"/> is invalid.
  51791. </exception>
  51792. <exception cref="T:System.ObjectDisposedException">
  51793. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51794. </exception>
  51795. <exception cref="T:MailKit.ServiceNotConnectedException">
  51796. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51797. </exception>
  51798. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51799. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51800. </exception>
  51801. <exception cref="T:MailKit.FolderNotOpenException">
  51802. The <see cref="T:MailKit.IMailFolder"/> is not currently open in read-write mode.
  51803. </exception>
  51804. <exception cref="T:System.InvalidOperationException">
  51805. Cannot store annotations without any properties defined.
  51806. </exception>
  51807. <exception cref="T:System.NotSupportedException">
  51808. <para>The <see cref="T:MailKit.IMailFolder"/> does not support annotations.</para>
  51809. <para>-or-</para>
  51810. <para>The <see cref="T:MailKit.IMailFolder"/> does not support mod-sequences.</para>
  51811. </exception>
  51812. <exception cref="T:System.OperationCanceledException">
  51813. The operation was canceled via the cancellation token.
  51814. </exception>
  51815. <exception cref="T:System.IO.IOException">
  51816. An I/O error occurred.
  51817. </exception>
  51818. <exception cref="T:MailKit.ProtocolException">
  51819. The server's response contained unexpected tokens.
  51820. </exception>
  51821. <exception cref="T:MailKit.CommandException">
  51822. The command failed.
  51823. </exception>
  51824. </member>
  51825. <member name="M:MailKit.MailFolder.Store(System.Int32,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  51826. <summary>
  51827. Store the annotations for the specified message.
  51828. </summary>
  51829. <remarks>
  51830. Stores the annotations for the specified message.
  51831. </remarks>
  51832. <param name="index">The index of the message.</param>
  51833. <param name="annotations">The annotations to store.</param>
  51834. <param name="cancellationToken">The cancellation token.</param>
  51835. <exception cref="T:System.ArgumentNullException">
  51836. <paramref name="annotations"/> is <c>null</c>.
  51837. </exception>
  51838. <exception cref="T:System.ArgumentException">
  51839. <paramref name="index"/> is invalid.
  51840. </exception>
  51841. <exception cref="T:System.ObjectDisposedException">
  51842. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51843. </exception>
  51844. <exception cref="T:MailKit.ServiceNotConnectedException">
  51845. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51846. </exception>
  51847. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51848. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51849. </exception>
  51850. <exception cref="T:MailKit.FolderNotOpenException">
  51851. The <see cref="T:MailKit.IMailFolder"/> is not currently open in read-write mode.
  51852. </exception>
  51853. <exception cref="T:System.InvalidOperationException">
  51854. Cannot store annotations without any properties defined.
  51855. </exception>
  51856. <exception cref="T:System.NotSupportedException">
  51857. The <see cref="T:MailKit.IMailFolder"/> does not support annotations.
  51858. </exception>
  51859. <exception cref="T:System.OperationCanceledException">
  51860. The operation was canceled via the cancellation token.
  51861. </exception>
  51862. <exception cref="T:System.IO.IOException">
  51863. An I/O error occurred.
  51864. </exception>
  51865. <exception cref="T:MailKit.ProtocolException">
  51866. The server's response contained unexpected tokens.
  51867. </exception>
  51868. <exception cref="T:MailKit.CommandException">
  51869. The command failed.
  51870. </exception>
  51871. </member>
  51872. <member name="M:MailKit.MailFolder.StoreAsync(System.Int32,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  51873. <summary>
  51874. Asynchronously store the annotations for the specified message.
  51875. </summary>
  51876. <remarks>
  51877. Asynchronously stores the annotations for the specified message.
  51878. </remarks>
  51879. <returns>An asynchronous task context.</returns>
  51880. <param name="index">The indexes of the message.</param>
  51881. <param name="annotations">The annotations to store.</param>
  51882. <param name="cancellationToken">The cancellation token.</param>
  51883. <exception cref="T:System.ArgumentNullException">
  51884. <paramref name="annotations"/> is <c>null</c>.
  51885. </exception>
  51886. <exception cref="T:System.ArgumentException">
  51887. <paramref name="index"/> is invalid.
  51888. </exception>
  51889. <exception cref="T:System.ObjectDisposedException">
  51890. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51891. </exception>
  51892. <exception cref="T:MailKit.ServiceNotConnectedException">
  51893. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51894. </exception>
  51895. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51896. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51897. </exception>
  51898. <exception cref="T:MailKit.FolderNotOpenException">
  51899. The <see cref="T:MailKit.IMailFolder"/> is not currently open in read-write mode.
  51900. </exception>
  51901. <exception cref="T:System.InvalidOperationException">
  51902. Cannot store annotations without any properties defined.
  51903. </exception>
  51904. <exception cref="T:System.NotSupportedException">
  51905. The <see cref="T:MailKit.IMailFolder"/> does not support annotations.
  51906. </exception>
  51907. <exception cref="T:System.OperationCanceledException">
  51908. The operation was canceled via the cancellation token.
  51909. </exception>
  51910. <exception cref="T:System.IO.IOException">
  51911. An I/O error occurred.
  51912. </exception>
  51913. <exception cref="T:MailKit.ProtocolException">
  51914. The server's response contained unexpected tokens.
  51915. </exception>
  51916. <exception cref="T:MailKit.CommandException">
  51917. The command failed.
  51918. </exception>
  51919. </member>
  51920. <member name="M:MailKit.MailFolder.Store(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  51921. <summary>
  51922. Store the annotations for the specified messages.
  51923. </summary>
  51924. <remarks>
  51925. Stores the annotations for the specified messages.
  51926. </remarks>
  51927. <param name="indexes">The indexes of the messages.</param>
  51928. <param name="annotations">The annotations to store.</param>
  51929. <param name="cancellationToken">The cancellation token.</param>
  51930. <exception cref="T:System.ArgumentNullException">
  51931. <para><paramref name="indexes"/> is <c>null</c>.</para>
  51932. <para>-or-</para>
  51933. <para><paramref name="annotations"/> is <c>null</c>.</para>
  51934. </exception>
  51935. <exception cref="T:System.ArgumentException">
  51936. One or more of the <paramref name="indexes"/> is invalid.
  51937. </exception>
  51938. <exception cref="T:System.ObjectDisposedException">
  51939. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51940. </exception>
  51941. <exception cref="T:MailKit.ServiceNotConnectedException">
  51942. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51943. </exception>
  51944. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51945. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51946. </exception>
  51947. <exception cref="T:MailKit.FolderNotOpenException">
  51948. The <see cref="T:MailKit.IMailFolder"/> is not currently open in read-write mode.
  51949. </exception>
  51950. <exception cref="T:System.InvalidOperationException">
  51951. Cannot store annotations without any properties defined.
  51952. </exception>
  51953. <exception cref="T:System.NotSupportedException">
  51954. The <see cref="T:MailKit.IMailFolder"/> does not support annotations.
  51955. </exception>
  51956. <exception cref="T:System.OperationCanceledException">
  51957. The operation was canceled via the cancellation token.
  51958. </exception>
  51959. <exception cref="T:System.IO.IOException">
  51960. An I/O error occurred.
  51961. </exception>
  51962. <exception cref="T:MailKit.ProtocolException">
  51963. The server's response contained unexpected tokens.
  51964. </exception>
  51965. <exception cref="T:MailKit.CommandException">
  51966. The command failed.
  51967. </exception>
  51968. </member>
  51969. <member name="M:MailKit.MailFolder.StoreAsync(System.Collections.Generic.IList{System.Int32},System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  51970. <summary>
  51971. Asynchronously store the annotations for the specified messages.
  51972. </summary>
  51973. <remarks>
  51974. Asynchronously stores the annotations for the specified messages.
  51975. </remarks>
  51976. <returns>An asynchronous task context.</returns>
  51977. <param name="indexes">The indexes of the messages.</param>
  51978. <param name="annotations">The annotations to store.</param>
  51979. <param name="cancellationToken">The cancellation token.</param>
  51980. <exception cref="T:System.ArgumentNullException">
  51981. <para><paramref name="indexes"/> is <c>null</c>.</para>
  51982. <para>-or-</para>
  51983. <para><paramref name="annotations"/> is <c>null</c>.</para>
  51984. </exception>
  51985. <exception cref="T:System.ArgumentException">
  51986. One or more of the <paramref name="indexes"/> is invalid.
  51987. </exception>
  51988. <exception cref="T:System.ObjectDisposedException">
  51989. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  51990. </exception>
  51991. <exception cref="T:MailKit.ServiceNotConnectedException">
  51992. The <see cref="T:MailKit.IMailStore"/> is not connected.
  51993. </exception>
  51994. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  51995. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  51996. </exception>
  51997. <exception cref="T:MailKit.FolderNotOpenException">
  51998. The <see cref="T:MailKit.IMailFolder"/> is not currently open in read-write mode.
  51999. </exception>
  52000. <exception cref="T:System.InvalidOperationException">
  52001. Cannot store annotations without any properties defined.
  52002. </exception>
  52003. <exception cref="T:System.NotSupportedException">
  52004. The <see cref="T:MailKit.IMailFolder"/> does not support annotations.
  52005. </exception>
  52006. <exception cref="T:System.OperationCanceledException">
  52007. The operation was canceled via the cancellation token.
  52008. </exception>
  52009. <exception cref="T:System.IO.IOException">
  52010. An I/O error occurred.
  52011. </exception>
  52012. <exception cref="T:MailKit.ProtocolException">
  52013. The server's response contained unexpected tokens.
  52014. </exception>
  52015. <exception cref="T:MailKit.CommandException">
  52016. The command failed.
  52017. </exception>
  52018. </member>
  52019. <member name="M:MailKit.MailFolder.Store(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  52020. <summary>
  52021. Store the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  52022. </summary>
  52023. <remarks>
  52024. Stores the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  52025. </remarks>
  52026. <returns>The indexes of the messages that were not updated.</returns>
  52027. <param name="indexes">The indexes of the messages.</param>
  52028. <param name="modseq">The mod-sequence value.</param>
  52029. <param name="annotations">The annotations to store.</param>
  52030. <param name="cancellationToken">The cancellation token.</param>
  52031. <exception cref="T:System.ArgumentNullException">
  52032. <para><paramref name="indexes"/> is <c>null</c>.</para>
  52033. <para>-or-</para>
  52034. <para><paramref name="annotations"/> is <c>null</c>.</para>
  52035. </exception>
  52036. <exception cref="T:System.ArgumentException">
  52037. One or more of the <paramref name="indexes"/> is invalid.
  52038. </exception>
  52039. <exception cref="T:System.ObjectDisposedException">
  52040. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52041. </exception>
  52042. <exception cref="T:MailKit.ServiceNotConnectedException">
  52043. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52044. </exception>
  52045. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52046. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52047. </exception>
  52048. <exception cref="T:MailKit.FolderNotOpenException">
  52049. The <see cref="T:MailKit.IMailFolder"/> is not currently open in read-write mode.
  52050. </exception>
  52051. <exception cref="T:System.InvalidOperationException">
  52052. Cannot store annotations without any properties defined.
  52053. </exception>
  52054. <exception cref="T:System.NotSupportedException">
  52055. <para>The <see cref="T:MailKit.IMailFolder"/> does not support annotations.</para>
  52056. <para>-or-</para>
  52057. <para>The <see cref="T:MailKit.IMailFolder"/> does not support mod-sequences.</para>
  52058. </exception>
  52059. <exception cref="T:System.OperationCanceledException">
  52060. The operation was canceled via the cancellation token.
  52061. </exception>
  52062. <exception cref="T:System.IO.IOException">
  52063. An I/O error occurred.
  52064. </exception>
  52065. <exception cref="T:MailKit.ProtocolException">
  52066. The server's response contained unexpected tokens.
  52067. </exception>
  52068. <exception cref="T:MailKit.CommandException">
  52069. The command failed.
  52070. </exception>
  52071. </member>
  52072. <member name="M:MailKit.MailFolder.StoreAsync(System.Collections.Generic.IList{System.Int32},System.UInt64,System.Collections.Generic.IList{MailKit.Annotation},System.Threading.CancellationToken)">
  52073. <summary>
  52074. Asynchronously store the annotations for the specified messages only if their mod-sequence value is less than the specified value.
  52075. </summary>
  52076. <remarks>
  52077. Asynchronously stores the annotations for the specified messages only if their mod-sequence value is less than the specified value.s
  52078. </remarks>
  52079. <returns>The indexes of the messages that were not updated.</returns>
  52080. <param name="indexes">The indexes of the messages.</param>
  52081. <param name="modseq">The mod-sequence value.</param>
  52082. <param name="annotations">The annotations to store.</param>
  52083. <param name="cancellationToken">The cancellation token.</param>
  52084. <exception cref="T:System.ArgumentNullException">
  52085. <para><paramref name="indexes"/> is <c>null</c>.</para>
  52086. <para>-or-</para>
  52087. <para><paramref name="annotations"/> is <c>null</c>.</para>
  52088. </exception>
  52089. <exception cref="T:System.ArgumentException">
  52090. One or more of the <paramref name="indexes"/> is invalid.
  52091. </exception>
  52092. <exception cref="T:System.ObjectDisposedException">
  52093. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52094. </exception>
  52095. <exception cref="T:MailKit.ServiceNotConnectedException">
  52096. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52097. </exception>
  52098. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52099. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52100. </exception>
  52101. <exception cref="T:MailKit.FolderNotOpenException">
  52102. The <see cref="T:MailKit.IMailFolder"/> is not currently open in read-write mode.
  52103. </exception>
  52104. <exception cref="T:System.InvalidOperationException">
  52105. Cannot store annotations without any properties defined.
  52106. </exception>
  52107. <exception cref="T:System.NotSupportedException">
  52108. <para>The <see cref="T:MailKit.IMailFolder"/> does not support annotations.</para>
  52109. <para>-or-</para>
  52110. <para>The <see cref="T:MailKit.IMailFolder"/> does not support mod-sequences.</para>
  52111. </exception>
  52112. <exception cref="T:System.OperationCanceledException">
  52113. The operation was canceled via the cancellation token.
  52114. </exception>
  52115. <exception cref="T:System.IO.IOException">
  52116. An I/O error occurred.
  52117. </exception>
  52118. <exception cref="T:MailKit.ProtocolException">
  52119. The server's response contained unexpected tokens.
  52120. </exception>
  52121. <exception cref="T:MailKit.CommandException">
  52122. The command failed.
  52123. </exception>
  52124. </member>
  52125. <member name="M:MailKit.MailFolder.Search(MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  52126. <summary>
  52127. Search the folder for messages matching the specified query.
  52128. </summary>
  52129. <remarks>
  52130. The returned array of unique identifiers can be used with methods such as
  52131. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  52132. </remarks>
  52133. <returns>An array of matching UIDs.</returns>
  52134. <param name="query">The search query.</param>
  52135. <param name="cancellationToken">The cancellation token.</param>
  52136. <exception cref="T:System.ArgumentNullException">
  52137. <paramref name="query"/> is <c>null</c>.
  52138. </exception>
  52139. <exception cref="T:System.NotSupportedException">
  52140. One or more search terms in the <paramref name="query"/> are not supported by the mail store.
  52141. </exception>
  52142. <exception cref="T:System.ObjectDisposedException">
  52143. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52144. </exception>
  52145. <exception cref="T:MailKit.ServiceNotConnectedException">
  52146. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52147. </exception>
  52148. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52149. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52150. </exception>
  52151. <exception cref="T:MailKit.FolderNotOpenException">
  52152. The folder is not currently open.
  52153. </exception>
  52154. <exception cref="T:System.OperationCanceledException">
  52155. The operation was canceled via the cancellation token.
  52156. </exception>
  52157. <exception cref="T:System.IO.IOException">
  52158. An I/O error occurred.
  52159. </exception>
  52160. <exception cref="T:MailKit.ProtocolException">
  52161. The server's response contained unexpected tokens.
  52162. </exception>
  52163. <exception cref="T:MailKit.CommandException">
  52164. The command failed.
  52165. </exception>
  52166. </member>
  52167. <member name="M:MailKit.MailFolder.SearchAsync(MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  52168. <summary>
  52169. Asynchronously search the folder for messages matching the specified query.
  52170. </summary>
  52171. <remarks>
  52172. The returned array of unique identifiers can be used with methods such as
  52173. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  52174. </remarks>
  52175. <returns>An array of matching UIDs.</returns>
  52176. <param name="query">The search query.</param>
  52177. <param name="cancellationToken">The cancellation token.</param>
  52178. <exception cref="T:System.ArgumentNullException">
  52179. <paramref name="query"/> is <c>null</c>.
  52180. </exception>
  52181. <exception cref="T:System.NotSupportedException">
  52182. One or more search terms in the <paramref name="query"/> are not supported by the mail store.
  52183. </exception>
  52184. <exception cref="T:System.ObjectDisposedException">
  52185. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52186. </exception>
  52187. <exception cref="T:MailKit.ServiceNotConnectedException">
  52188. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52189. </exception>
  52190. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52191. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52192. </exception>
  52193. <exception cref="T:MailKit.FolderNotOpenException">
  52194. The folder is not currently open.
  52195. </exception>
  52196. <exception cref="T:System.OperationCanceledException">
  52197. The operation was canceled via the cancellation token.
  52198. </exception>
  52199. <exception cref="T:System.IO.IOException">
  52200. An I/O error occurred.
  52201. </exception>
  52202. <exception cref="T:MailKit.ProtocolException">
  52203. The server's response contained unexpected tokens.
  52204. </exception>
  52205. <exception cref="T:MailKit.CommandException">
  52206. The command failed.
  52207. </exception>
  52208. </member>
  52209. <member name="M:MailKit.MailFolder.Search(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  52210. <summary>
  52211. Search the subset of UIDs in the folder for messages matching the specified query.
  52212. </summary>
  52213. <remarks>
  52214. The returned array of unique identifiers can be used with methods such as
  52215. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  52216. </remarks>
  52217. <returns>An array of matching UIDs in the specified sort order.</returns>
  52218. <param name="uids">The subset of UIDs</param>
  52219. <param name="query">The search query.</param>
  52220. <param name="cancellationToken">The cancellation token.</param>
  52221. <exception cref="T:System.ArgumentNullException">
  52222. <para><paramref name="uids"/> is <c>null</c>.</para>
  52223. <para>-or-</para>
  52224. <para><paramref name="query"/> is <c>null</c>.</para>
  52225. </exception>
  52226. <exception cref="T:System.ArgumentException">
  52227. <para><paramref name="uids"/> is empty.</para>
  52228. <para>-or-</para>
  52229. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  52230. </exception>
  52231. <exception cref="T:System.NotSupportedException">
  52232. One or more search terms in the <paramref name="query"/> are not supported by the mail store.
  52233. </exception>
  52234. <exception cref="T:System.ObjectDisposedException">
  52235. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52236. </exception>
  52237. <exception cref="T:MailKit.ServiceNotConnectedException">
  52238. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52239. </exception>
  52240. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52241. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52242. </exception>
  52243. <exception cref="T:MailKit.FolderNotOpenException">
  52244. The folder is not currently open.
  52245. </exception>
  52246. <exception cref="T:System.OperationCanceledException">
  52247. The operation was canceled via the cancellation token.
  52248. </exception>
  52249. <exception cref="T:System.IO.IOException">
  52250. An I/O error occurred.
  52251. </exception>
  52252. <exception cref="T:MailKit.ProtocolException">
  52253. The server's response contained unexpected tokens.
  52254. </exception>
  52255. <exception cref="T:MailKit.CommandException">
  52256. The command failed.
  52257. </exception>
  52258. </member>
  52259. <member name="M:MailKit.MailFolder.SearchAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  52260. <summary>
  52261. Asynchronously search the subset of UIDs in the folder for messages matching the specified query.
  52262. </summary>
  52263. <remarks>
  52264. The returned array of unique identifiers can be used with methods such as
  52265. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  52266. </remarks>
  52267. <returns>An array of matching UIDs in the specified sort order.</returns>
  52268. <param name="uids">The subset of UIDs</param>
  52269. <param name="query">The search query.</param>
  52270. <param name="cancellationToken">The cancellation token.</param>
  52271. <exception cref="T:System.ArgumentNullException">
  52272. <para><paramref name="uids"/> is <c>null</c>.</para>
  52273. <para>-or-</para>
  52274. <para><paramref name="query"/> is <c>null</c>.</para>
  52275. </exception>
  52276. <exception cref="T:System.ArgumentException">
  52277. <para><paramref name="uids"/> is empty.</para>
  52278. <para>-or-</para>
  52279. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  52280. </exception>
  52281. <exception cref="T:System.NotSupportedException">
  52282. One or more search terms in the <paramref name="query"/> are not supported.
  52283. </exception>
  52284. <exception cref="T:System.ObjectDisposedException">
  52285. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52286. </exception>
  52287. <exception cref="T:MailKit.ServiceNotConnectedException">
  52288. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52289. </exception>
  52290. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52291. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52292. </exception>
  52293. <exception cref="T:MailKit.FolderNotOpenException">
  52294. The folder is not currently open.
  52295. </exception>
  52296. <exception cref="T:System.OperationCanceledException">
  52297. The operation was canceled via the cancellation token.
  52298. </exception>
  52299. <exception cref="T:System.IO.IOException">
  52300. An I/O error occurred.
  52301. </exception>
  52302. <exception cref="T:MailKit.ProtocolException">
  52303. The server's response contained unexpected tokens.
  52304. </exception>
  52305. <exception cref="T:MailKit.CommandException">
  52306. The command failed.
  52307. </exception>
  52308. </member>
  52309. <member name="M:MailKit.MailFolder.Search(MailKit.Search.SearchOptions,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  52310. <summary>
  52311. Search the folder for messages matching the specified query.
  52312. </summary>
  52313. <remarks>
  52314. Searches the folder for messages matching the specified query,
  52315. returning only the specified search results.
  52316. </remarks>
  52317. <returns>The search results.</returns>
  52318. <param name="options">The search options.</param>
  52319. <param name="query">The search query.</param>
  52320. <param name="cancellationToken">The cancellation token.</param>
  52321. <exception cref="T:System.ArgumentNullException">
  52322. <paramref name="query"/> is <c>null</c>.
  52323. </exception>
  52324. <exception cref="T:System.NotSupportedException">
  52325. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  52326. <para>-or-</para>
  52327. <para>The server does not support the specified search options.</para>
  52328. </exception>
  52329. <exception cref="T:System.ObjectDisposedException">
  52330. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52331. </exception>
  52332. <exception cref="T:MailKit.ServiceNotConnectedException">
  52333. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52334. </exception>
  52335. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52336. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52337. </exception>
  52338. <exception cref="T:MailKit.FolderNotOpenException">
  52339. The <see cref="T:MailKit.MailFolder"/> is not currently open.
  52340. </exception>
  52341. <exception cref="T:System.OperationCanceledException">
  52342. The operation was canceled via the cancellation token.
  52343. </exception>
  52344. <exception cref="T:System.IO.IOException">
  52345. An I/O error occurred.
  52346. </exception>
  52347. <exception cref="T:MailKit.ProtocolException">
  52348. The server's response contained unexpected tokens.
  52349. </exception>
  52350. <exception cref="T:MailKit.CommandException">
  52351. The command failed.
  52352. </exception>
  52353. </member>
  52354. <member name="M:MailKit.MailFolder.SearchAsync(MailKit.Search.SearchOptions,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  52355. <summary>
  52356. Asynchronously search the folder for messages matching the specified query.
  52357. </summary>
  52358. <remarks>
  52359. Asynchronously searches the folder for messages matching the specified query,
  52360. returning only the specified search results.
  52361. </remarks>
  52362. <returns>The search results.</returns>
  52363. <param name="options">The search options.</param>
  52364. <param name="query">The search query.</param>
  52365. <param name="cancellationToken">The cancellation token.</param>
  52366. <exception cref="T:System.ArgumentNullException">
  52367. <paramref name="query"/> is <c>null</c>.
  52368. </exception>
  52369. <exception cref="T:System.NotSupportedException">
  52370. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  52371. <para>-or-</para>
  52372. <para>The server does not support the specified search options.</para>
  52373. </exception>
  52374. <exception cref="T:System.ObjectDisposedException">
  52375. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52376. </exception>
  52377. <exception cref="T:MailKit.ServiceNotConnectedException">
  52378. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52379. </exception>
  52380. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52381. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52382. </exception>
  52383. <exception cref="T:MailKit.FolderNotOpenException">
  52384. The <see cref="T:MailKit.MailFolder"/> is not currently open.
  52385. </exception>
  52386. <exception cref="T:System.OperationCanceledException">
  52387. The operation was canceled via the cancellation token.
  52388. </exception>
  52389. <exception cref="T:System.IO.IOException">
  52390. An I/O error occurred.
  52391. </exception>
  52392. <exception cref="T:MailKit.ProtocolException">
  52393. The server's response contained unexpected tokens.
  52394. </exception>
  52395. <exception cref="T:MailKit.CommandException">
  52396. The command failed.
  52397. </exception>
  52398. </member>
  52399. <member name="M:MailKit.MailFolder.Search(MailKit.Search.SearchOptions,System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  52400. <summary>
  52401. Search the subset of UIDs in the folder for messages matching the specified query.
  52402. </summary>
  52403. <remarks>
  52404. Searches the fsubset of UIDs in the folder for messages matching the specified query,
  52405. returning only the specified search results.
  52406. </remarks>
  52407. <returns>The search results.</returns>
  52408. <param name="options">The search options.</param>
  52409. <param name="uids">The subset of UIDs</param>
  52410. <param name="query">The search query.</param>
  52411. <param name="cancellationToken">The cancellation token.</param>
  52412. <exception cref="T:System.ArgumentNullException">
  52413. <para><paramref name="uids"/> is <c>null</c>.</para>
  52414. <para>-or-</para>
  52415. <para><paramref name="query"/> is <c>null</c>.</para>
  52416. </exception>
  52417. <exception cref="T:System.ArgumentException">
  52418. <para><paramref name="uids"/> is empty.</para>
  52419. <para>-or-</para>
  52420. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  52421. </exception>
  52422. <exception cref="T:System.NotSupportedException">
  52423. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  52424. <para>-or-</para>
  52425. <para>The server does not support the specified search options.</para>
  52426. </exception>
  52427. <exception cref="T:System.ObjectDisposedException">
  52428. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52429. </exception>
  52430. <exception cref="T:MailKit.ServiceNotConnectedException">
  52431. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52432. </exception>
  52433. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52434. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52435. </exception>
  52436. <exception cref="T:MailKit.FolderNotOpenException">
  52437. The folder is not currently open.
  52438. </exception>
  52439. <exception cref="T:System.OperationCanceledException">
  52440. The operation was canceled via the cancellation token.
  52441. </exception>
  52442. <exception cref="T:System.IO.IOException">
  52443. An I/O error occurred.
  52444. </exception>
  52445. <exception cref="T:MailKit.ProtocolException">
  52446. The server's response contained unexpected tokens.
  52447. </exception>
  52448. <exception cref="T:MailKit.CommandException">
  52449. The command failed.
  52450. </exception>
  52451. </member>
  52452. <member name="M:MailKit.MailFolder.SearchAsync(MailKit.Search.SearchOptions,System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  52453. <summary>
  52454. Asynchronously search the subset of UIDs in the folder for messages matching the specified query.
  52455. </summary>
  52456. <remarks>
  52457. Asynchronously searches the fsubset of UIDs in the folder for messages matching the specified query,
  52458. returning only the specified search results.
  52459. </remarks>
  52460. <returns>The search results.</returns>
  52461. <param name="options">The search options.</param>
  52462. <param name="uids">The subset of UIDs</param>
  52463. <param name="query">The search query.</param>
  52464. <param name="cancellationToken">The cancellation token.</param>
  52465. <exception cref="T:System.ArgumentNullException">
  52466. <para><paramref name="uids"/> is <c>null</c>.</para>
  52467. <para>-or-</para>
  52468. <para><paramref name="query"/> is <c>null</c>.</para>
  52469. </exception>
  52470. <exception cref="T:System.ArgumentException">
  52471. <para><paramref name="uids"/> is empty.</para>
  52472. <para>-or-</para>
  52473. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  52474. </exception>
  52475. <exception cref="T:System.NotSupportedException">
  52476. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  52477. <para>-or-</para>
  52478. <para>The server does not support the specified search options.</para>
  52479. </exception>
  52480. <exception cref="T:System.ObjectDisposedException">
  52481. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52482. </exception>
  52483. <exception cref="T:MailKit.ServiceNotConnectedException">
  52484. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52485. </exception>
  52486. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52487. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52488. </exception>
  52489. <exception cref="T:MailKit.FolderNotOpenException">
  52490. The folder is not currently open.
  52491. </exception>
  52492. <exception cref="T:System.OperationCanceledException">
  52493. The operation was canceled via the cancellation token.
  52494. </exception>
  52495. <exception cref="T:System.IO.IOException">
  52496. An I/O error occurred.
  52497. </exception>
  52498. <exception cref="T:MailKit.ProtocolException">
  52499. The server's response contained unexpected tokens.
  52500. </exception>
  52501. <exception cref="T:MailKit.CommandException">
  52502. The command failed.
  52503. </exception>
  52504. </member>
  52505. <member name="M:MailKit.MailFolder.Sort(MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  52506. <summary>
  52507. Sort messages matching the specified query.
  52508. </summary>
  52509. <remarks>
  52510. The returned array of unique identifiers will be sorted in the preferred order and
  52511. can be used with <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  52512. </remarks>
  52513. /// <returns>An array of matching UIDs in the specified sort order.</returns>
  52514. <param name="query">The search query.</param>
  52515. <param name="orderBy">The sort order.</param>
  52516. <param name="cancellationToken">The cancellation token.</param>
  52517. <exception cref="T:System.ArgumentNullException">
  52518. <para><paramref name="query"/> is <c>null</c>.</para>
  52519. <para>-or-</para>
  52520. <para><paramref name="orderBy"/> is <c>null</c>.</para>
  52521. </exception>
  52522. <exception cref="T:System.ArgumentException">
  52523. <paramref name="orderBy"/> is empty.
  52524. </exception>
  52525. <exception cref="T:System.NotSupportedException">
  52526. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  52527. <para>-or-</para>
  52528. <para>The server does not support sorting search results.</para>
  52529. </exception>
  52530. <exception cref="T:System.ObjectDisposedException">
  52531. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52532. </exception>
  52533. <exception cref="T:MailKit.ServiceNotConnectedException">
  52534. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52535. </exception>
  52536. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52537. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52538. </exception>
  52539. <exception cref="T:MailKit.FolderNotOpenException">
  52540. The folder is not currently open.
  52541. </exception>
  52542. <exception cref="T:System.OperationCanceledException">
  52543. The operation was canceled via the cancellation token.
  52544. </exception>
  52545. <exception cref="T:System.IO.IOException">
  52546. An I/O error occurred.
  52547. </exception>
  52548. <exception cref="T:MailKit.ProtocolException">
  52549. The server's response contained unexpected tokens.
  52550. </exception>
  52551. <exception cref="T:MailKit.CommandException">
  52552. The command failed.
  52553. </exception>
  52554. </member>
  52555. <member name="M:MailKit.MailFolder.SortAsync(MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  52556. <summary>
  52557. Asynchronously sort messages matching the specified query.
  52558. </summary>
  52559. <remarks>
  52560. The returned array of unique identifiers will be sorted in the preferred order and
  52561. can be used with <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  52562. </remarks>
  52563. <returns>An array of matching UIDs in the specified sort order.</returns>
  52564. <param name="query">The search query.</param>
  52565. <param name="orderBy">The sort order.</param>
  52566. <param name="cancellationToken">The cancellation token.</param>
  52567. <exception cref="T:System.ArgumentNullException">
  52568. <para><paramref name="query"/> is <c>null</c>.</para>
  52569. <para>-or-</para>
  52570. <para><paramref name="orderBy"/> is <c>null</c>.</para>
  52571. </exception>
  52572. <exception cref="T:System.ArgumentException">
  52573. <paramref name="orderBy"/> is empty.
  52574. </exception>
  52575. <exception cref="T:System.NotSupportedException">
  52576. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  52577. <para>-or-</para>
  52578. <para>The server does not support sorting search results.</para>
  52579. </exception>
  52580. <exception cref="T:System.ObjectDisposedException">
  52581. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52582. </exception>
  52583. <exception cref="T:MailKit.ServiceNotConnectedException">
  52584. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52585. </exception>
  52586. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52587. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52588. </exception>
  52589. <exception cref="T:MailKit.FolderNotOpenException">
  52590. The folder is not currently open.
  52591. </exception>
  52592. <exception cref="T:System.OperationCanceledException">
  52593. The operation was canceled via the cancellation token.
  52594. </exception>
  52595. <exception cref="T:System.IO.IOException">
  52596. An I/O error occurred.
  52597. </exception>
  52598. <exception cref="T:MailKit.ProtocolException">
  52599. The server's response contained unexpected tokens.
  52600. </exception>
  52601. <exception cref="T:MailKit.CommandException">
  52602. The command failed.
  52603. </exception>
  52604. </member>
  52605. <member name="M:MailKit.MailFolder.Sort(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  52606. <summary>
  52607. Sort messages matching the specified query.
  52608. </summary>
  52609. <remarks>
  52610. The returned array of unique identifiers will be sorted in the preferred order and
  52611. can be used with <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  52612. </remarks>
  52613. <returns>An array of matching UIDs in the specified sort order.</returns>
  52614. <param name="uids">The subset of UIDs</param>
  52615. <param name="query">The search query.</param>
  52616. <param name="orderBy">The sort order.</param>
  52617. <param name="cancellationToken">The cancellation token.</param>
  52618. <exception cref="T:System.ArgumentNullException">
  52619. <para><paramref name="uids"/> is <c>null</c>.</para>
  52620. <para>-or-</para>
  52621. <para><paramref name="query"/> is <c>null</c>.</para>
  52622. <para>-or-</para>
  52623. <para><paramref name="orderBy"/> is <c>null</c>.</para>
  52624. </exception>
  52625. <exception cref="T:System.ArgumentException">
  52626. <para><paramref name="uids"/> is empty.</para>
  52627. <para>-or-</para>
  52628. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  52629. <para>-or-</para>
  52630. <para><paramref name="orderBy"/> is empty.</para>
  52631. </exception>
  52632. <exception cref="T:System.NotSupportedException">
  52633. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  52634. <para>-or-</para>
  52635. <para>The server does not support sorting search results.</para>
  52636. </exception>
  52637. <exception cref="T:System.ObjectDisposedException">
  52638. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52639. </exception>
  52640. <exception cref="T:MailKit.ServiceNotConnectedException">
  52641. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52642. </exception>
  52643. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52644. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52645. </exception>
  52646. <exception cref="T:MailKit.FolderNotOpenException">
  52647. The folder is not currently open.
  52648. </exception>
  52649. <exception cref="T:System.OperationCanceledException">
  52650. The operation was canceled via the cancellation token.
  52651. </exception>
  52652. <exception cref="T:System.IO.IOException">
  52653. An I/O error occurred.
  52654. </exception>
  52655. <exception cref="T:MailKit.ProtocolException">
  52656. The server's response contained unexpected tokens.
  52657. </exception>
  52658. <exception cref="T:MailKit.CommandException">
  52659. The command failed.
  52660. </exception>
  52661. </member>
  52662. <member name="M:MailKit.MailFolder.SortAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  52663. <summary>
  52664. Asynchronously sort messages matching the specified query.
  52665. </summary>
  52666. <remarks>
  52667. The returned array of unique identifiers will be sorted in the preferred order and
  52668. can be used with <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  52669. </remarks>
  52670. <returns>An array of matching UIDs in the specified sort order.</returns>
  52671. <param name="uids">The subset of UIDs</param>
  52672. <param name="query">The search query.</param>
  52673. <param name="orderBy">The sort order.</param>
  52674. <param name="cancellationToken">The cancellation token.</param>
  52675. <exception cref="T:System.ArgumentNullException">
  52676. <para><paramref name="uids"/> is <c>null</c>.</para>
  52677. <para>-or-</para>
  52678. <para><paramref name="query"/> is <c>null</c>.</para>
  52679. <para>-or-</para>
  52680. <para><paramref name="orderBy"/> is <c>null</c>.</para>
  52681. </exception>
  52682. <exception cref="T:System.ArgumentException">
  52683. <para><paramref name="uids"/> is empty.</para>
  52684. <para>-or-</para>
  52685. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  52686. <para>-or-</para>
  52687. <para><paramref name="orderBy"/> is empty.</para>
  52688. </exception>
  52689. <exception cref="T:System.NotSupportedException">
  52690. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  52691. <para>-or-</para>
  52692. <para>The server does not support sorting search results.</para>
  52693. </exception>
  52694. <exception cref="T:System.ObjectDisposedException">
  52695. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52696. </exception>
  52697. <exception cref="T:MailKit.ServiceNotConnectedException">
  52698. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52699. </exception>
  52700. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52701. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52702. </exception>
  52703. <exception cref="T:MailKit.FolderNotOpenException">
  52704. The folder is not currently open.
  52705. </exception>
  52706. <exception cref="T:System.OperationCanceledException">
  52707. The operation was canceled via the cancellation token.
  52708. </exception>
  52709. <exception cref="T:System.IO.IOException">
  52710. An I/O error occurred.
  52711. </exception>
  52712. <exception cref="T:MailKit.ProtocolException">
  52713. The server's response contained unexpected tokens.
  52714. </exception>
  52715. <exception cref="T:MailKit.CommandException">
  52716. The command failed.
  52717. </exception>
  52718. </member>
  52719. <member name="M:MailKit.MailFolder.Sort(MailKit.Search.SearchOptions,MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  52720. <summary>
  52721. Sort messages matching the specified query.
  52722. </summary>
  52723. <remarks>
  52724. Searches the folder for messages matching the specified query, returning the search results in the specified sort order.
  52725. </remarks>
  52726. <returns>The search results.</returns>
  52727. <param name="options">The search options.</param>
  52728. <param name="query">The search query.</param>
  52729. <param name="orderBy">The sort order.</param>
  52730. <param name="cancellationToken">The cancellation token.</param>
  52731. <exception cref="T:System.ArgumentNullException">
  52732. <para><paramref name="query"/> is <c>null</c>.</para>
  52733. <para>-or-</para>
  52734. <para><paramref name="orderBy"/> is <c>null</c>.</para>
  52735. </exception>
  52736. <exception cref="T:System.ArgumentException">
  52737. <paramref name="orderBy"/> is empty.
  52738. </exception>
  52739. <exception cref="T:System.NotSupportedException">
  52740. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  52741. <para>-or-</para>
  52742. <para>The server does not support the specified search options.</para>
  52743. <para>-or-</para>
  52744. <para>The server does not support sorting search results.</para>
  52745. </exception>
  52746. <exception cref="T:System.ObjectDisposedException">
  52747. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52748. </exception>
  52749. <exception cref="T:MailKit.ServiceNotConnectedException">
  52750. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52751. </exception>
  52752. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52753. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52754. </exception>
  52755. <exception cref="T:MailKit.FolderNotOpenException">
  52756. The <see cref="T:MailKit.MailFolder"/> is not currently open.
  52757. </exception>
  52758. <exception cref="T:System.OperationCanceledException">
  52759. The operation was canceled via the cancellation token.
  52760. </exception>
  52761. <exception cref="T:System.IO.IOException">
  52762. An I/O error occurred.
  52763. </exception>
  52764. <exception cref="T:MailKit.ProtocolException">
  52765. The server's response contained unexpected tokens.
  52766. </exception>
  52767. <exception cref="T:MailKit.CommandException">
  52768. The command failed.
  52769. </exception>
  52770. </member>
  52771. <member name="M:MailKit.MailFolder.SortAsync(MailKit.Search.SearchOptions,MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  52772. <summary>
  52773. Asynchronously sort messages matching the specified query.
  52774. </summary>
  52775. <remarks>
  52776. Asynchronously searches the folder for messages matching the specified query, returning the search results in the specified sort order.
  52777. </remarks>
  52778. <returns>The search results.</returns>
  52779. <param name="options">The search options.</param>
  52780. <param name="query">The search query.</param>
  52781. <param name="orderBy">The sort order.</param>
  52782. <param name="cancellationToken">The cancellation token.</param>
  52783. <exception cref="T:System.ArgumentNullException">
  52784. <para><paramref name="query"/> is <c>null</c>.</para>
  52785. <para>-or-</para>
  52786. <para><paramref name="orderBy"/> is <c>null</c>.</para>
  52787. </exception>
  52788. <exception cref="T:System.ArgumentException">
  52789. <paramref name="orderBy"/> is empty.
  52790. </exception>
  52791. <exception cref="T:System.NotSupportedException">
  52792. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  52793. <para>-or-</para>
  52794. <para>The server does not support the specified search options.</para>
  52795. <para>-or-</para>
  52796. <para>The server does not support sorting search results.</para>
  52797. </exception>
  52798. <exception cref="T:System.ObjectDisposedException">
  52799. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52800. </exception>
  52801. <exception cref="T:MailKit.ServiceNotConnectedException">
  52802. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52803. </exception>
  52804. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52805. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52806. </exception>
  52807. <exception cref="T:MailKit.FolderNotOpenException">
  52808. The <see cref="T:MailKit.MailFolder"/> is not currently open.
  52809. </exception>
  52810. <exception cref="T:System.OperationCanceledException">
  52811. The operation was canceled via the cancellation token.
  52812. </exception>
  52813. <exception cref="T:System.IO.IOException">
  52814. An I/O error occurred.
  52815. </exception>
  52816. <exception cref="T:MailKit.ProtocolException">
  52817. The server's response contained unexpected tokens.
  52818. </exception>
  52819. <exception cref="T:MailKit.CommandException">
  52820. The command failed.
  52821. </exception>
  52822. </member>
  52823. <member name="M:MailKit.MailFolder.Sort(MailKit.Search.SearchOptions,System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  52824. <summary>
  52825. Sort messages matching the specified query.
  52826. </summary>
  52827. <remarks>
  52828. Searches the folder for messages matching the specified query, returning the search results in the specified sort order.
  52829. </remarks>
  52830. <returns>The search results.</returns>
  52831. <param name="options">The search options.</param>
  52832. <param name="uids">The subset of UIDs</param>
  52833. <param name="query">The search query.</param>
  52834. <param name="orderBy">The sort order.</param>
  52835. <param name="cancellationToken">The cancellation token.</param>
  52836. <exception cref="T:System.ArgumentNullException">
  52837. <para><paramref name="uids"/> is <c>null</c>.</para>
  52838. <para>-or-</para>
  52839. <para><paramref name="query"/> is <c>null</c>.</para>
  52840. <para>-or-</para>
  52841. <para><paramref name="orderBy"/> is <c>null</c>.</para>
  52842. </exception>
  52843. <exception cref="T:System.ArgumentException">
  52844. <para><paramref name="uids"/> is empty.</para>
  52845. <para>-or-</para>
  52846. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  52847. <para>-or-</para>
  52848. <para><paramref name="orderBy"/> is empty.</para>
  52849. </exception>
  52850. <exception cref="T:System.NotSupportedException">
  52851. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  52852. <para>-or-</para>
  52853. <para>The server does not support the specified search options.</para>
  52854. <para>-or-</para>
  52855. <para>The server does not support sorting search results.</para>
  52856. </exception>
  52857. <exception cref="T:System.ObjectDisposedException">
  52858. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52859. </exception>
  52860. <exception cref="T:MailKit.ServiceNotConnectedException">
  52861. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52862. </exception>
  52863. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52864. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52865. </exception>
  52866. <exception cref="T:MailKit.FolderNotOpenException">
  52867. The folder is not currently open.
  52868. </exception>
  52869. <exception cref="T:System.OperationCanceledException">
  52870. The operation was canceled via the cancellation token.
  52871. </exception>
  52872. <exception cref="T:System.IO.IOException">
  52873. An I/O error occurred.
  52874. </exception>
  52875. <exception cref="T:MailKit.ProtocolException">
  52876. The server's response contained unexpected tokens.
  52877. </exception>
  52878. <exception cref="T:MailKit.CommandException">
  52879. The command failed.
  52880. </exception>
  52881. </member>
  52882. <member name="M:MailKit.MailFolder.SortAsync(MailKit.Search.SearchOptions,System.Collections.Generic.IList{MailKit.UniqueId},MailKit.Search.SearchQuery,System.Collections.Generic.IList{MailKit.Search.OrderBy},System.Threading.CancellationToken)">
  52883. <summary>
  52884. Asynchronously sort messages matching the specified query, returning the search results in the specified sort order.
  52885. </summary>
  52886. <remarks>
  52887. Asynchronously searches the folder for messages matching the specified query,
  52888. returning the search results in the specified sort order.
  52889. </remarks>
  52890. <returns>The search results.</returns>
  52891. <param name="options">The search options.</param>
  52892. <param name="uids">The subset of UIDs</param>
  52893. <param name="query">The search query.</param>
  52894. <param name="orderBy">The sort order.</param>
  52895. <param name="cancellationToken">The cancellation token.</param>
  52896. <exception cref="T:System.ArgumentNullException">
  52897. <para><paramref name="uids"/> is <c>null</c>.</para>
  52898. <para>-or-</para>
  52899. <para><paramref name="query"/> is <c>null</c>.</para>
  52900. <para>-or-</para>
  52901. <para><paramref name="orderBy"/> is <c>null</c>.</para>
  52902. </exception>
  52903. <exception cref="T:System.ArgumentException">
  52904. <para><paramref name="uids"/> is empty.</para>
  52905. <para>-or-</para>
  52906. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  52907. <para>-or-</para>
  52908. <para><paramref name="orderBy"/> is empty.</para>
  52909. </exception>
  52910. <exception cref="T:System.NotSupportedException">
  52911. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  52912. <para>-or-</para>
  52913. <para>The server does not support the specified search options.</para>
  52914. <para>-or-</para>
  52915. <para>The server does not support sorting search results.</para>
  52916. </exception>
  52917. <exception cref="T:System.ObjectDisposedException">
  52918. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52919. </exception>
  52920. <exception cref="T:MailKit.ServiceNotConnectedException">
  52921. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52922. </exception>
  52923. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52924. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52925. </exception>
  52926. <exception cref="T:MailKit.FolderNotOpenException">
  52927. The folder is not currently open.
  52928. </exception>
  52929. <exception cref="T:System.OperationCanceledException">
  52930. The operation was canceled via the cancellation token.
  52931. </exception>
  52932. <exception cref="T:System.IO.IOException">
  52933. An I/O error occurred.
  52934. </exception>
  52935. <exception cref="T:MailKit.ProtocolException">
  52936. The server's response contained unexpected tokens.
  52937. </exception>
  52938. <exception cref="T:MailKit.CommandException">
  52939. The command failed.
  52940. </exception>
  52941. </member>
  52942. <member name="M:MailKit.MailFolder.Thread(MailKit.ThreadingAlgorithm,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  52943. <summary>
  52944. Thread the messages in the folder that match the search query using the specified threading algorithm.
  52945. </summary>
  52946. <remarks>
  52947. The <see cref="P:MailKit.MessageThread.UniqueId"/> can be used with methods such as
  52948. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  52949. </remarks>
  52950. <returns>An array of message threads.</returns>
  52951. <param name="algorithm">The threading algorithm to use.</param>
  52952. <param name="query">The search query.</param>
  52953. <param name="cancellationToken">The cancellation token.</param>
  52954. <exception cref="T:System.ArgumentOutOfRangeException">
  52955. <paramref name="algorithm"/> is not supported.
  52956. </exception>
  52957. <exception cref="T:System.ArgumentNullException">
  52958. <paramref name="query"/> is <c>null</c>.
  52959. </exception>
  52960. <exception cref="T:System.NotSupportedException">
  52961. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  52962. <para>-or-</para>
  52963. <para>The server does not support threading search results.</para>
  52964. </exception>
  52965. <exception cref="T:System.ObjectDisposedException">
  52966. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  52967. </exception>
  52968. <exception cref="T:MailKit.ServiceNotConnectedException">
  52969. The <see cref="T:MailKit.IMailStore"/> is not connected.
  52970. </exception>
  52971. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  52972. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  52973. </exception>
  52974. <exception cref="T:MailKit.FolderNotOpenException">
  52975. The folder is not currently open.
  52976. </exception>
  52977. <exception cref="T:System.OperationCanceledException">
  52978. The operation was canceled via the cancellation token.
  52979. </exception>
  52980. <exception cref="T:System.IO.IOException">
  52981. An I/O error occurred.
  52982. </exception>
  52983. <exception cref="T:MailKit.ProtocolException">
  52984. The server's response contained unexpected tokens.
  52985. </exception>
  52986. <exception cref="T:MailKit.CommandException">
  52987. The command failed.
  52988. </exception>
  52989. </member>
  52990. <member name="M:MailKit.MailFolder.ThreadAsync(MailKit.ThreadingAlgorithm,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  52991. <summary>
  52992. Asynchronously thread the messages in the folder that match the search query using the specified threading algorithm.
  52993. </summary>
  52994. <remarks>
  52995. The <see cref="P:MailKit.MessageThread.UniqueId"/> can be used with methods such as
  52996. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  52997. </remarks>
  52998. <returns>An array of message threads.</returns>
  52999. <param name="algorithm">The threading algorithm to use.</param>
  53000. <param name="query">The search query.</param>
  53001. <param name="cancellationToken">The cancellation token.</param>
  53002. <exception cref="T:System.ArgumentOutOfRangeException">
  53003. <paramref name="algorithm"/> is not supported.
  53004. </exception>
  53005. <exception cref="T:System.ArgumentNullException">
  53006. <paramref name="query"/> is <c>null</c>.
  53007. </exception>
  53008. <exception cref="T:System.NotSupportedException">
  53009. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  53010. <para>-or-</para>
  53011. <para>The server does not support threading search results.</para>
  53012. </exception>
  53013. <exception cref="T:System.ObjectDisposedException">
  53014. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  53015. </exception>
  53016. <exception cref="T:MailKit.ServiceNotConnectedException">
  53017. The <see cref="T:MailKit.IMailStore"/> is not connected.
  53018. </exception>
  53019. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  53020. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  53021. </exception>
  53022. <exception cref="T:MailKit.FolderNotOpenException">
  53023. The folder is not currently open.
  53024. </exception>
  53025. <exception cref="T:System.OperationCanceledException">
  53026. The operation was canceled via the cancellation token.
  53027. </exception>
  53028. <exception cref="T:System.IO.IOException">
  53029. An I/O error occurred.
  53030. </exception>
  53031. <exception cref="T:MailKit.ProtocolException">
  53032. The server's response contained unexpected tokens.
  53033. </exception>
  53034. <exception cref="T:MailKit.CommandException">
  53035. The command failed.
  53036. </exception>
  53037. </member>
  53038. <member name="M:MailKit.MailFolder.Thread(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.ThreadingAlgorithm,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  53039. <summary>
  53040. Thread the messages in the folder that match the search query using the specified threading algorithm.
  53041. </summary>
  53042. <remarks>
  53043. The <see cref="P:MailKit.MessageThread.UniqueId"/> can be used with methods such as
  53044. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  53045. </remarks>
  53046. <returns>An array of message threads.</returns>
  53047. <param name="uids">The subset of UIDs</param>
  53048. <param name="algorithm">The threading algorithm to use.</param>
  53049. <param name="query">The search query.</param>
  53050. <param name="cancellationToken">The cancellation token.</param>
  53051. <exception cref="T:System.ArgumentOutOfRangeException">
  53052. <paramref name="algorithm"/> is not supported.
  53053. </exception>
  53054. <exception cref="T:System.ArgumentNullException">
  53055. <para><paramref name="uids"/> is <c>null</c>.</para>
  53056. <para>-or-</para>
  53057. <para><paramref name="query"/> is <c>null</c>.</para>
  53058. </exception>
  53059. <exception cref="T:System.ArgumentException">
  53060. <para><paramref name="uids"/> is empty.</para>
  53061. <para>-or-</para>
  53062. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  53063. </exception>
  53064. <exception cref="T:System.NotSupportedException">
  53065. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  53066. <para>-or-</para>
  53067. <para>The server does not support threading search results.</para>
  53068. </exception>
  53069. <exception cref="T:System.ObjectDisposedException">
  53070. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  53071. </exception>
  53072. <exception cref="T:MailKit.ServiceNotConnectedException">
  53073. The <see cref="T:MailKit.IMailStore"/> is not connected.
  53074. </exception>
  53075. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  53076. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  53077. </exception>
  53078. <exception cref="T:MailKit.FolderNotOpenException">
  53079. The folder is not currently open.
  53080. </exception>
  53081. <exception cref="T:System.OperationCanceledException">
  53082. The operation was canceled via the cancellation token.
  53083. </exception>
  53084. <exception cref="T:System.IO.IOException">
  53085. An I/O error occurred.
  53086. </exception>
  53087. <exception cref="T:MailKit.ProtocolException">
  53088. The server's response contained unexpected tokens.
  53089. </exception>
  53090. <exception cref="T:MailKit.CommandException">
  53091. The command failed.
  53092. </exception>
  53093. </member>
  53094. <member name="M:MailKit.MailFolder.ThreadAsync(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.ThreadingAlgorithm,MailKit.Search.SearchQuery,System.Threading.CancellationToken)">
  53095. <summary>
  53096. Asynchronously thread the messages in the folder that match the search query using the specified threading algorithm.
  53097. </summary>
  53098. <remarks>
  53099. The <see cref="P:MailKit.MessageThread.UniqueId"/> can be used with methods such as
  53100. <see cref="M:MailKit.IMailFolder.GetMessage(MailKit.UniqueId,System.Threading.CancellationToken,MailKit.ITransferProgress)"/>.
  53101. </remarks>
  53102. <returns>An array of message threads.</returns>
  53103. <param name="uids">The subset of UIDs</param>
  53104. <param name="algorithm">The threading algorithm to use.</param>
  53105. <param name="query">The search query.</param>
  53106. <param name="cancellationToken">The cancellation token.</param>
  53107. <exception cref="T:System.ArgumentOutOfRangeException">
  53108. <paramref name="algorithm"/> is not supported.
  53109. </exception>
  53110. <exception cref="T:System.ArgumentNullException">
  53111. <para><paramref name="uids"/> is <c>null</c>.</para>
  53112. <para>-or-</para>
  53113. <para><paramref name="query"/> is <c>null</c>.</para>
  53114. </exception>
  53115. <exception cref="T:System.ArgumentException">
  53116. <para><paramref name="uids"/> is empty.</para>
  53117. <para>-or-</para>
  53118. <para>One or more of the <paramref name="uids"/> is invalid.</para>
  53119. </exception>
  53120. <exception cref="T:System.NotSupportedException">
  53121. <para>One or more search terms in the <paramref name="query"/> are not supported.</para>
  53122. <para>-or-</para>
  53123. <para>The server does not support threading search results.</para>
  53124. </exception>
  53125. <exception cref="T:System.ObjectDisposedException">
  53126. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  53127. </exception>
  53128. <exception cref="T:MailKit.ServiceNotConnectedException">
  53129. The <see cref="T:MailKit.IMailStore"/> is not connected.
  53130. </exception>
  53131. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  53132. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  53133. </exception>
  53134. <exception cref="T:MailKit.FolderNotOpenException">
  53135. The folder is not currently open.
  53136. </exception>
  53137. <exception cref="T:System.OperationCanceledException">
  53138. The operation was canceled via the cancellation token.
  53139. </exception>
  53140. <exception cref="T:System.IO.IOException">
  53141. An I/O error occurred.
  53142. </exception>
  53143. <exception cref="T:MailKit.ProtocolException">
  53144. The server's response contained unexpected tokens.
  53145. </exception>
  53146. <exception cref="T:MailKit.CommandException">
  53147. The command failed.
  53148. </exception>
  53149. </member>
  53150. <member name="E:MailKit.MailFolder.Opened">
  53151. <summary>
  53152. Occurs when the folder is opened.
  53153. </summary>
  53154. <remarks>
  53155. The <see cref="E:MailKit.MailFolder.Opened"/> event is emitted when the folder is opened.
  53156. </remarks>
  53157. </member>
  53158. <member name="M:MailKit.MailFolder.OnOpened">
  53159. <summary>
  53160. Raise the opened event.
  53161. </summary>
  53162. <remarks>
  53163. Raises the opened event.
  53164. </remarks>
  53165. </member>
  53166. <member name="E:MailKit.MailFolder.Closed">
  53167. <summary>
  53168. Occurs when the folder is closed.
  53169. </summary>
  53170. <remarks>
  53171. The <see cref="E:MailKit.MailFolder.Closed"/> event is emitted when the folder is closed.
  53172. </remarks>
  53173. </member>
  53174. <member name="M:MailKit.MailFolder.OnClosed">
  53175. <summary>
  53176. Raise the closed event.
  53177. </summary>
  53178. <remarks>
  53179. Raises the closed event.
  53180. </remarks>
  53181. </member>
  53182. <member name="E:MailKit.MailFolder.Deleted">
  53183. <summary>
  53184. Occurs when the folder is deleted.
  53185. </summary>
  53186. <remarks>
  53187. The <see cref="E:MailKit.MailFolder.Deleted"/> event is emitted when the folder is deleted.
  53188. </remarks>
  53189. </member>
  53190. <member name="M:MailKit.MailFolder.OnDeleted">
  53191. <summary>
  53192. Raise the deleted event.
  53193. </summary>
  53194. <remarks>
  53195. Raises the deleted event.
  53196. </remarks>
  53197. </member>
  53198. <member name="E:MailKit.MailFolder.Renamed">
  53199. <summary>
  53200. Occurs when the folder is renamed.
  53201. </summary>
  53202. <remarks>
  53203. The <see cref="E:MailKit.MailFolder.Renamed"/> event is emitted when the folder is renamed.
  53204. </remarks>
  53205. </member>
  53206. <member name="M:MailKit.MailFolder.OnRenamed(System.String,System.String)">
  53207. <summary>
  53208. Raise the renamed event.
  53209. </summary>
  53210. <remarks>
  53211. Raises the renamed event.
  53212. </remarks>
  53213. <param name="oldName">The old name of the folder.</param>
  53214. <param name="newName">The new name of the folder.</param>
  53215. </member>
  53216. <member name="M:MailKit.MailFolder.OnParentFolderRenamed">
  53217. <summary>
  53218. Notifies the folder that a parent folder has been renamed.
  53219. </summary>
  53220. <remarks>
  53221. <see cref="T:MailKit.IMailFolder"/> implementations should override this method
  53222. to update their state (such as updating their <see cref="P:MailKit.MailFolder.FullName"/>
  53223. property).
  53224. </remarks>
  53225. </member>
  53226. <member name="E:MailKit.MailFolder.Subscribed">
  53227. <summary>
  53228. Occurs when the folder is subscribed.
  53229. </summary>
  53230. <remarks>
  53231. The <see cref="E:MailKit.MailFolder.Subscribed"/> event is emitted when the folder is subscribed.
  53232. </remarks>
  53233. </member>
  53234. <member name="M:MailKit.MailFolder.OnSubscribed">
  53235. <summary>
  53236. Raise the subscribed event.
  53237. </summary>
  53238. <remarks>
  53239. Raises the subscribed event.
  53240. </remarks>
  53241. </member>
  53242. <member name="E:MailKit.MailFolder.Unsubscribed">
  53243. <summary>
  53244. Occurs when the folder is unsubscribed.
  53245. </summary>
  53246. <remarks>
  53247. The <see cref="E:MailKit.MailFolder.Unsubscribed"/> event is emitted when the folder is unsubscribed.
  53248. </remarks>
  53249. </member>
  53250. <member name="M:MailKit.MailFolder.OnUnsubscribed">
  53251. <summary>
  53252. Raise the unsubscribed event.
  53253. </summary>
  53254. <remarks>
  53255. Raises the unsubscribed event.
  53256. </remarks>
  53257. </member>
  53258. <member name="E:MailKit.MailFolder.MessageExpunged">
  53259. <summary>
  53260. Occurs when a message is expunged from the folder.
  53261. </summary>
  53262. <remarks>
  53263. The <see cref="E:MailKit.MailFolder.MessageExpunged"/> event is emitted when a message is expunged from the folder.
  53264. </remarks>
  53265. <example>
  53266. <code language="c#" source="Examples\ImapIdleExample.cs"/>
  53267. </example>
  53268. </member>
  53269. <member name="M:MailKit.MailFolder.OnMessageExpunged(MailKit.MessageEventArgs)">
  53270. <summary>
  53271. Raise the message expunged event.
  53272. </summary>
  53273. <remarks>
  53274. Raises the message expunged event.
  53275. </remarks>
  53276. <param name="args">The message expunged event args.</param>
  53277. </member>
  53278. <member name="E:MailKit.MailFolder.MessagesVanished">
  53279. <summary>
  53280. Occurs when a message vanishes from the folder.
  53281. </summary>
  53282. <remarks>
  53283. The <see cref="E:MailKit.MailFolder.MessagesVanished"/> event is emitted when messages vanish from the folder.
  53284. </remarks>
  53285. </member>
  53286. <member name="M:MailKit.MailFolder.OnMessagesVanished(MailKit.MessagesVanishedEventArgs)">
  53287. <summary>
  53288. Raise the messages vanished event.
  53289. </summary>
  53290. <remarks>
  53291. Raises the messages vanished event.
  53292. </remarks>
  53293. <param name="args">The messages vanished event args.</param>
  53294. </member>
  53295. <member name="E:MailKit.MailFolder.MessageFlagsChanged">
  53296. <summary>
  53297. Occurs when flags changed on a message.
  53298. </summary>
  53299. <remarks>
  53300. The <see cref="E:MailKit.MailFolder.MessageFlagsChanged"/> event is emitted when the flags for a message are changed.
  53301. </remarks>
  53302. <example>
  53303. <code language="c#" source="Examples\ImapIdleExample.cs"/>
  53304. </example>
  53305. </member>
  53306. <member name="M:MailKit.MailFolder.OnMessageFlagsChanged(MailKit.MessageFlagsChangedEventArgs)">
  53307. <summary>
  53308. Raise the message flags changed event.
  53309. </summary>
  53310. <remarks>
  53311. Raises the message flags changed event.
  53312. </remarks>
  53313. <param name="args">The message flags changed event args.</param>
  53314. </member>
  53315. <member name="E:MailKit.MailFolder.MessageLabelsChanged">
  53316. <summary>
  53317. Occurs when labels changed on a message.
  53318. </summary>
  53319. <remarks>
  53320. The <see cref="E:MailKit.MailFolder.MessageLabelsChanged"/> event is emitted when the labels for a message are changed.
  53321. </remarks>
  53322. </member>
  53323. <member name="M:MailKit.MailFolder.OnMessageLabelsChanged(MailKit.MessageLabelsChangedEventArgs)">
  53324. <summary>
  53325. Raise the message labels changed event.
  53326. </summary>
  53327. <remarks>
  53328. Raises the message labels changed event.
  53329. </remarks>
  53330. <param name="args">The message labels changed event args.</param>
  53331. </member>
  53332. <member name="E:MailKit.MailFolder.AnnotationsChanged">
  53333. <summary>
  53334. Occurs when annotations changed on a message.
  53335. </summary>
  53336. <remarks>
  53337. The <see cref="E:MailKit.MailFolder.AnnotationsChanged"/> event is emitted when the annotations for a message are changed.
  53338. </remarks>
  53339. </member>
  53340. <member name="M:MailKit.MailFolder.OnAnnotationsChanged(MailKit.AnnotationsChangedEventArgs)">
  53341. <summary>
  53342. Raise the message annotations changed event.
  53343. </summary>
  53344. <remarks>
  53345. Raises the message annotations changed event.
  53346. </remarks>
  53347. <param name="args">The message annotations changed event args.</param>
  53348. </member>
  53349. <member name="E:MailKit.MailFolder.MessageSummaryFetched">
  53350. <summary>
  53351. Occurs when a message summary is fetched from the folder.
  53352. </summary>
  53353. <remarks>
  53354. <para>Emitted when a message summary is fetched from the folder.</para>
  53355. <para>When multiple message summaries are being fetched from a remote folder,
  53356. it is possible that the connection will drop or some other exception will
  53357. occur, causing the Fetch method to fail and lose all of the data that has been
  53358. downloaded up to that point, requiring the client to request the same set of
  53359. message summaries all over again after it reconnects. This is obviously
  53360. inefficient. To alleviate this potential problem, this event will be emitted
  53361. as soon as the <see cref="T:MailKit.IMailFolder"/> successfully parses each untagged FETCH
  53362. response from the server, allowing the client to commit this data immediately to
  53363. its local cache.</para>
  53364. <note type="note">Depending on the IMAP server, it is possible that the
  53365. <see cref="E:MailKit.MailFolder.MessageSummaryFetched"/> event will be emitted for the same message
  53366. multiple times if the IMAP server happens to split the requested fields into
  53367. multiple untagged FETCH responses. Use the <see cref="P:MailKit.IMessageSummary.Fields"/>
  53368. property to determine which f<see cref="T:MailKit.IMessageSummary"/> properties have
  53369. been populated.</note>
  53370. </remarks>
  53371. </member>
  53372. <member name="M:MailKit.MailFolder.OnMessageSummaryFetched(MailKit.IMessageSummary)">
  53373. <summary>
  53374. Raise the message summary fetched event.
  53375. </summary>
  53376. <remarks>
  53377. <para>Raises the message summary fetched event.</para>
  53378. <para>When multiple message summaries are being fetched from a remote folder,
  53379. it is possible that the connection will drop or some other exception will
  53380. occur, causing the Fetch method to fail and lose all of the data that has been
  53381. downloaded up to that point, requiring the client to request the same set of
  53382. message summaries all over again after it reconnects. This is obviously
  53383. inefficient. To alleviate this potential problem, this event will be emitted
  53384. as soon as the <see cref="T:MailKit.IMailFolder"/> successfully parses each untagged FETCH
  53385. response from the server, allowing the client to commit this data immediately to
  53386. its local cache.</para>
  53387. <note type="note">Depending on the IMAP server, it is possible that
  53388. <see cref="M:MailKit.MailFolder.OnMessageSummaryFetched(MailKit.IMessageSummary)"/> will be invoked for the same message
  53389. multiple times if the IMAP server happens to split the requested fields into
  53390. multiple untagged FETCH responses. Use the <see cref="P:MailKit.IMessageSummary.Fields"/>
  53391. property to determine which f<see cref="T:MailKit.IMessageSummary"/> properties have
  53392. been populated.</note>
  53393. </remarks>
  53394. <param name="message">The message summary.</param>
  53395. </member>
  53396. <member name="E:MailKit.MailFolder.MetadataChanged">
  53397. <summary>
  53398. Occurs when metadata changes.
  53399. </summary>
  53400. <remarks>
  53401. The <see cref="E:MailKit.MailFolder.MetadataChanged"/> event is emitted when metadata changes.
  53402. </remarks>
  53403. </member>
  53404. <member name="M:MailKit.MailFolder.OnMetadataChanged(MailKit.Metadata)">
  53405. <summary>
  53406. Raise the metadata changed event.
  53407. </summary>
  53408. <remarks>
  53409. Raises the metadata changed event.
  53410. </remarks>
  53411. <param name="metadata">The metadata that changed.</param>
  53412. </member>
  53413. <member name="E:MailKit.MailFolder.ModSeqChanged">
  53414. <summary>
  53415. Occurs when the mod-sequence changed on a message.
  53416. </summary>
  53417. <remarks>
  53418. The <see cref="E:MailKit.MailFolder.ModSeqChanged"/> event is emitted when the mod-sequence for a message is changed.
  53419. </remarks>
  53420. </member>
  53421. <member name="M:MailKit.MailFolder.OnModSeqChanged(MailKit.ModSeqChangedEventArgs)">
  53422. <summary>
  53423. Raise the message mod-sequence changed event.
  53424. </summary>
  53425. <remarks>
  53426. Raises the message mod-sequence changed event.
  53427. </remarks>
  53428. <param name="args">The mod-sequence changed event args.</param>
  53429. </member>
  53430. <member name="E:MailKit.MailFolder.HighestModSeqChanged">
  53431. <summary>
  53432. Occurs when the highest mod-sequence changes.
  53433. </summary>
  53434. <remarks>
  53435. The <see cref="E:MailKit.MailFolder.HighestModSeqChanged"/> event is emitted whenever the <see cref="P:MailKit.MailFolder.HighestModSeq"/> value changes.
  53436. </remarks>
  53437. </member>
  53438. <member name="M:MailKit.MailFolder.OnHighestModSeqChanged">
  53439. <summary>
  53440. Raise the highest mod-sequence changed event.
  53441. </summary>
  53442. <remarks>
  53443. Raises the highest mod-sequence changed event.
  53444. </remarks>
  53445. </member>
  53446. <member name="E:MailKit.MailFolder.UidNextChanged">
  53447. <summary>
  53448. Occurs when the next UID changes.
  53449. </summary>
  53450. <remarks>
  53451. The <see cref="E:MailKit.MailFolder.UidNextChanged"/> event is emitted whenever the <see cref="P:MailKit.MailFolder.UidNext"/> value changes.
  53452. </remarks>
  53453. </member>
  53454. <member name="M:MailKit.MailFolder.OnUidNextChanged">
  53455. <summary>
  53456. Raise the next UID changed event.
  53457. </summary>
  53458. <remarks>
  53459. Raises the next UID changed event.
  53460. </remarks>
  53461. </member>
  53462. <member name="E:MailKit.MailFolder.UidValidityChanged">
  53463. <summary>
  53464. Occurs when the UID validity changes.
  53465. </summary>
  53466. <remarks>
  53467. The <see cref="E:MailKit.MailFolder.UidValidityChanged"/> event is emitted whenever the <see cref="P:MailKit.MailFolder.UidValidity"/> value changes.
  53468. </remarks>
  53469. </member>
  53470. <member name="M:MailKit.MailFolder.OnUidValidityChanged">
  53471. <summary>
  53472. Raise the uid validity changed event.
  53473. </summary>
  53474. <remarks>
  53475. Raises the uid validity changed event.
  53476. </remarks>
  53477. </member>
  53478. <member name="E:MailKit.MailFolder.IdChanged">
  53479. <summary>
  53480. Occurs when the folder ID changes.
  53481. </summary>
  53482. <remarks>
  53483. The <see cref="E:MailKit.MailFolder.IdChanged"/> event is emitted whenever the <see cref="P:MailKit.MailFolder.Id"/> value changes.
  53484. </remarks>
  53485. </member>
  53486. <member name="M:MailKit.MailFolder.OnIdChanged">
  53487. <summary>
  53488. Raise the ID changed event.
  53489. </summary>
  53490. <remarks>
  53491. Raises the ID changed event.
  53492. </remarks>
  53493. </member>
  53494. <member name="E:MailKit.MailFolder.SizeChanged">
  53495. <summary>
  53496. Occurs when the folder size changes.
  53497. </summary>
  53498. <remarks>
  53499. The <see cref="E:MailKit.MailFolder.SizeChanged"/> event is emitted whenever the <see cref="P:MailKit.MailFolder.Size"/> value changes.
  53500. </remarks>
  53501. </member>
  53502. <member name="M:MailKit.MailFolder.OnSizeChanged">
  53503. <summary>
  53504. Raise the size changed event.
  53505. </summary>
  53506. <remarks>
  53507. Raises the size changed event.
  53508. </remarks>
  53509. </member>
  53510. <member name="E:MailKit.MailFolder.CountChanged">
  53511. <summary>
  53512. Occurs when the message count changes.
  53513. </summary>
  53514. <remarks>
  53515. The <see cref="E:MailKit.MailFolder.CountChanged"/> event is emitted whenever the <see cref="P:MailKit.MailFolder.Count"/> value changes.
  53516. </remarks>
  53517. <example>
  53518. <code language="c#" source="Examples\ImapIdleExample.cs"/>
  53519. </example>
  53520. </member>
  53521. <member name="M:MailKit.MailFolder.OnCountChanged">
  53522. <summary>
  53523. Raise the message count changed event.
  53524. </summary>
  53525. <remarks>
  53526. Raises the message count changed event.
  53527. </remarks>
  53528. </member>
  53529. <member name="E:MailKit.MailFolder.RecentChanged">
  53530. <summary>
  53531. Occurs when the recent message count changes.
  53532. </summary>
  53533. <remarks>
  53534. The <see cref="E:MailKit.MailFolder.RecentChanged"/> event is emitted whenever the <see cref="P:MailKit.MailFolder.Recent"/> value changes.
  53535. </remarks>
  53536. </member>
  53537. <member name="M:MailKit.MailFolder.OnRecentChanged">
  53538. <summary>
  53539. Raise the recent message count changed event.
  53540. </summary>
  53541. <remarks>
  53542. Raises the recent message count changed event.
  53543. </remarks>
  53544. </member>
  53545. <member name="E:MailKit.MailFolder.UnreadChanged">
  53546. <summary>
  53547. Occurs when the unread message count changes.
  53548. </summary>
  53549. <remarks>
  53550. The <see cref="E:MailKit.MailFolder.UnreadChanged"/> event is emitted whenever the <see cref="P:MailKit.MailFolder.Unread"/> value changes.
  53551. </remarks>
  53552. </member>
  53553. <member name="M:MailKit.MailFolder.OnUnreadChanged">
  53554. <summary>
  53555. Raise the unread message count changed event.
  53556. </summary>
  53557. <remarks>
  53558. Raises the unread message count changed event.
  53559. </remarks>
  53560. </member>
  53561. <member name="M:MailKit.MailFolder.GetEnumerator">
  53562. <summary>
  53563. Get an enumerator for the messages in the folder.
  53564. </summary>
  53565. <remarks>
  53566. Gets an enumerator for the messages in the folder.
  53567. </remarks>
  53568. <returns>The enumerator.</returns>
  53569. <exception cref="T:System.ObjectDisposedException">
  53570. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  53571. </exception>
  53572. <exception cref="T:MailKit.ServiceNotConnectedException">
  53573. The <see cref="T:MailKit.IMailStore"/> is not connected.
  53574. </exception>
  53575. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  53576. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  53577. </exception>
  53578. <exception cref="T:MailKit.FolderNotOpenException">
  53579. The folder is not currently open.
  53580. </exception>
  53581. </member>
  53582. <member name="M:MailKit.MailFolder.System#Collections#IEnumerable#GetEnumerator">
  53583. <summary>
  53584. Get an enumerator for the messages in the folder.
  53585. </summary>
  53586. <remarks>
  53587. Gets an enumerator for the messages in the folder.
  53588. </remarks>
  53589. <returns>The enumerator.</returns>
  53590. <exception cref="T:System.ObjectDisposedException">
  53591. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  53592. </exception>
  53593. <exception cref="T:MailKit.ServiceNotConnectedException">
  53594. The <see cref="T:MailKit.IMailStore"/> is not connected.
  53595. </exception>
  53596. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  53597. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  53598. </exception>
  53599. <exception cref="T:MailKit.FolderNotOpenException">
  53600. The folder is not currently open.
  53601. </exception>
  53602. </member>
  53603. <member name="M:MailKit.MailFolder.ToString">
  53604. <summary>
  53605. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.MailFolder"/>.
  53606. </summary>
  53607. <remarks>
  53608. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.MailFolder"/>.
  53609. </remarks>
  53610. <returns>A <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.MailFolder"/>.</returns>
  53611. </member>
  53612. <member name="T:MailKit.MailService">
  53613. <summary>
  53614. An abstract mail service implementation.
  53615. </summary>
  53616. <remarks>
  53617. An abstract mail service implementation.
  53618. </remarks>
  53619. </member>
  53620. <member name="M:MailKit.MailService.#ctor(MailKit.IProtocolLogger)">
  53621. <summary>
  53622. Initializes a new instance of the <see cref="T:MailKit.MailService"/> class.
  53623. </summary>
  53624. <remarks>
  53625. Initializes a new instance of the <see cref="T:MailKit.MailService"/> class.
  53626. </remarks>
  53627. <param name="protocolLogger">The protocol logger.</param>
  53628. <exception cref="T:System.ArgumentNullException">
  53629. <paramref name="protocolLogger"/> is <c>null</c>.
  53630. </exception>
  53631. </member>
  53632. <member name="M:MailKit.MailService.#ctor">
  53633. <summary>
  53634. Initializes a new instance of the <see cref="T:MailKit.MailService"/> class.
  53635. </summary>
  53636. <remarks>
  53637. Initializes a new instance of the <see cref="T:MailKit.MailService"/> class.
  53638. </remarks>
  53639. </member>
  53640. <member name="M:MailKit.MailService.Finalize">
  53641. <summary>
  53642. Releases unmanaged resources and performs other cleanup operations before the
  53643. <see cref="T:MailKit.MailService"/> is reclaimed by garbage collection.
  53644. </summary>
  53645. <remarks>
  53646. Releases unmanaged resources and performs other cleanup operations before the
  53647. <see cref="T:MailKit.MailService"/> is reclaimed by garbage collection.
  53648. </remarks>
  53649. </member>
  53650. <member name="P:MailKit.MailService.SyncRoot">
  53651. <summary>
  53652. Gets an object that can be used to synchronize access to the service.
  53653. </summary>
  53654. <remarks>
  53655. <para>Gets an object that can be used to synchronize access to the service.</para>
  53656. </remarks>
  53657. <value>The sync root.</value>
  53658. </member>
  53659. <member name="P:MailKit.MailService.Protocol">
  53660. <summary>
  53661. Gets the protocol supported by the message service.
  53662. </summary>
  53663. <remarks>
  53664. Gets the protocol supported by the message service.
  53665. </remarks>
  53666. <value>The protocol.</value>
  53667. </member>
  53668. <member name="P:MailKit.MailService.ProtocolLogger">
  53669. <summary>
  53670. Get the protocol logger.
  53671. </summary>
  53672. <remarks>
  53673. Gets the protocol logger.
  53674. </remarks>
  53675. <value>The protocol logger.</value>
  53676. </member>
  53677. <member name="P:MailKit.MailService.SslProtocols">
  53678. <summary>
  53679. Gets or sets the SSL and TLS protocol versions that the client is allowed to use.
  53680. </summary>
  53681. <remarks>
  53682. <para>Gets or sets the SSL and TLS protocol versions that the client is allowed to use.</para>
  53683. <para>By default, MailKit initializes this value to support only TLS v1.1 and greater and
  53684. does not support TLS v1.0 or any version of SSL due to those protocols no longer being considered
  53685. secure.</para>
  53686. <para>This property should be set before calling any of the
  53687. <a href="Overload_MailKit_MailService_Connect.htm">Connect</a> methods.</para>
  53688. </remarks>
  53689. <value>The SSL and TLS protocol versions that are supported.</value>
  53690. </member>
  53691. <member name="P:MailKit.MailService.ClientCertificates">
  53692. <summary>
  53693. Gets or sets the client SSL certificates.
  53694. </summary>
  53695. <remarks>
  53696. <para>Some servers may require the client SSL certificates in order
  53697. to allow the user to connect.</para>
  53698. <para>This property should be set before calling any of the
  53699. <a href="Overload_MailKit_MailService_Connect.htm">Connect</a> methods.</para>
  53700. </remarks>
  53701. <value>The client SSL certificates.</value>
  53702. </member>
  53703. <member name="P:MailKit.MailService.CheckCertificateRevocation">
  53704. <summary>
  53705. Get or set whether connecting via SSL/TLS should check certificate revocation.
  53706. </summary>
  53707. <remarks>
  53708. <para>Gets or sets whether connecting via SSL/TLS should check certificate revocation.</para>
  53709. <para>Normally, the value of this property should be set to <c>true</c> (the default) for security
  53710. reasons, but there are times when it may be necessary to set it to <c>false</c>.</para>
  53711. <para>For example, most Certificate Authorities are probably pretty good at keeping their CRL and/or
  53712. OCSP servers up 24/7, but occasionally they do go down or are otherwise unreachable due to other
  53713. network problems between the client and the Certificate Authority. When this happens, it becomes
  53714. impossible to check the revocation status of one or more of the certificates in the chain
  53715. resulting in an <see cref="T:MailKit.Security.SslHandshakeException"/> being thrown in the
  53716. <a href="Overload_MailKit_MailService_Connect.htm">Connect</a> method. If this becomes a problem,
  53717. it may become desirable to set <see cref="P:MailKit.MailService.CheckCertificateRevocation"/> to <c>false</c>.</para>
  53718. </remarks>
  53719. <value><c>true</c> if certificate revocation should be checked; otherwise, <c>false</c>.</value>
  53720. </member>
  53721. <member name="P:MailKit.MailService.ServerCertificateValidationCallback">
  53722. <summary>
  53723. Get or sets a callback function to validate the server certificate.
  53724. </summary>
  53725. <remarks>
  53726. <para>Gets or sets a callback function to validate the server certificate.</para>
  53727. <para>This property should be set before calling any of the
  53728. <a href="Overload_MailKit_MailService_Connect.htm">Connect</a> methods.</para>
  53729. </remarks>
  53730. <example>
  53731. <code language="c#" source="Examples\SslCertificateValidation.cs"/>
  53732. </example>
  53733. <value>The server certificate validation callback function.</value>
  53734. </member>
  53735. <member name="P:MailKit.MailService.LocalEndPoint">
  53736. <summary>
  53737. Get or set the local IP end point to use when connecting to the remote host.
  53738. </summary>
  53739. <remarks>
  53740. Gets or sets the local IP end point to use when connecting to the remote host.
  53741. </remarks>
  53742. <value>The local IP end point or <c>null</c> to use the default end point.</value>
  53743. </member>
  53744. <member name="P:MailKit.MailService.ProxyClient">
  53745. <summary>
  53746. Get or set the proxy client to use when connecting to a remote host.
  53747. </summary>
  53748. <remarks>
  53749. Gets or sets the proxy client to use when connecting to a remote host via any of the
  53750. <a href="Overload_MailKit_MailService_Connect.htm">Connect</a> methods.
  53751. </remarks>
  53752. <value>The proxy client.</value>
  53753. </member>
  53754. <member name="P:MailKit.MailService.AuthenticationMechanisms">
  53755. <summary>
  53756. Gets the authentication mechanisms supported by the mail server.
  53757. </summary>
  53758. <remarks>
  53759. The authentication mechanisms are queried as part of the
  53760. <a href="Overload_MailKit_MailService_Connect.htm">Connect</a> method.
  53761. </remarks>
  53762. <value>The authentication mechanisms.</value>
  53763. </member>
  53764. <member name="P:MailKit.MailService.IsConnected">
  53765. <summary>
  53766. Gets whether or not the client is currently connected to an mail server.
  53767. </summary>
  53768. <remarks>
  53769. <para>The <see cref="P:MailKit.MailService.IsConnected"/> state is set to <c>true</c> immediately after
  53770. one of the <a href="Overload_MailKit_MailService_Connect.htm">Connect</a>
  53771. methods succeeds and is not set back to <c>false</c> until either the client
  53772. is disconnected via <see cref="M:MailKit.MailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/> or until a
  53773. <see cref="T:MailKit.ProtocolException"/> is thrown while attempting to read or write to
  53774. the underlying network socket.</para>
  53775. <para>When an <see cref="T:MailKit.ProtocolException"/> is caught, the connection state of the
  53776. <see cref="T:MailKit.MailService"/> should be checked before continuing.</para>
  53777. </remarks>
  53778. <value><c>true</c> if the client is connected; otherwise, <c>false</c>.</value>
  53779. </member>
  53780. <member name="P:MailKit.MailService.IsSecure">
  53781. <summary>
  53782. Get whether or not the connection is secure (typically via SSL or TLS).
  53783. </summary>
  53784. <remarks>
  53785. Gets whether or not the connection is secure (typically via SSL or TLS).
  53786. </remarks>
  53787. <value><c>true</c> if the connection is secure; otherwise, <c>false</c>.</value>
  53788. </member>
  53789. <member name="P:MailKit.MailService.IsAuthenticated">
  53790. <summary>
  53791. Get whether or not the client is currently authenticated with the mail server.
  53792. </summary>
  53793. <remarks>
  53794. <para>Gets whether or not the client is currently authenticated with the mail server.</para>
  53795. <para>To authenticate with the mail server, use one of the
  53796. <a href="Overload_MailKit_MailService_Authenticate.htm">Authenticate</a> methods
  53797. or any of the Async alternatives.</para>
  53798. </remarks>
  53799. <value><c>true</c> if the client is authenticated; otherwise, <c>false</c>.</value>
  53800. </member>
  53801. <member name="P:MailKit.MailService.Timeout">
  53802. <summary>
  53803. Gets or sets the timeout for network streaming operations, in milliseconds.
  53804. </summary>
  53805. <remarks>
  53806. Gets or sets the underlying socket stream's <see cref="P:System.IO.Stream.ReadTimeout"/>
  53807. and <see cref="P:System.IO.Stream.WriteTimeout"/> values.
  53808. </remarks>
  53809. <value>The timeout in milliseconds.</value>
  53810. </member>
  53811. <!-- Badly formed XML comment ignored for member "M:MailKit.MailService.DefaultServerCertificateValidationCallback(System.Object,System.Security.Cryptography.X509Certificates.X509Certificate,System.Security.Cryptography.X509Certificates.X509Chain,System.Net.Security.SslPolicyErrors)" -->
  53812. <member name="M:MailKit.MailService.Connect(System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  53813. <summary>
  53814. Establish a connection to the specified mail server.
  53815. </summary>
  53816. <remarks>
  53817. Establishes a connection to the specified mail server.
  53818. </remarks>
  53819. <example>
  53820. <code language="c#" source="Examples\SmtpExamples.cs" region="SendMessage"/>
  53821. </example>
  53822. <param name="host">The host name to connect to.</param>
  53823. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  53824. <param name="options">The secure socket options to when connecting.</param>
  53825. <param name="cancellationToken">The cancellation token.</param>
  53826. <exception cref="T:System.ArgumentNullException">
  53827. <paramref name="host"/> is <c>null</c>.
  53828. </exception>
  53829. <exception cref="T:System.ArgumentOutOfRangeException">
  53830. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  53831. </exception>
  53832. <exception cref="T:System.ArgumentException">
  53833. The <paramref name="host"/> is a zero-length string.
  53834. </exception>
  53835. <exception cref="T:System.ObjectDisposedException">
  53836. The <see cref="T:MailKit.MailService"/> has been disposed.
  53837. </exception>
  53838. <exception cref="T:System.InvalidOperationException">
  53839. The <see cref="T:MailKit.MailService"/> is already connected.
  53840. </exception>
  53841. <exception cref="T:System.OperationCanceledException">
  53842. The operation was canceled via the cancellation token.
  53843. </exception>
  53844. <exception cref="T:System.Net.Sockets.SocketException">
  53845. A socket error occurred trying to connect to the remote host.
  53846. </exception>
  53847. <exception cref="T:System.IO.IOException">
  53848. An I/O error occurred.
  53849. </exception>
  53850. <exception cref="T:MailKit.ProtocolException">
  53851. A protocol error occurred.
  53852. </exception>
  53853. </member>
  53854. <member name="M:MailKit.MailService.ConnectAsync(System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  53855. <summary>
  53856. Asynchronously establish a connection to the specified mail server.
  53857. </summary>
  53858. <remarks>
  53859. Asynchronously establishes a connection to the specified mail server.
  53860. </remarks>
  53861. <returns>An asynchronous task context.</returns>
  53862. <param name="host">The host name to connect to.</param>
  53863. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  53864. <param name="options">The secure socket options to when connecting.</param>
  53865. <param name="cancellationToken">The cancellation token.</param>
  53866. <exception cref="T:System.ArgumentNullException">
  53867. <paramref name="host"/> is <c>null</c>.
  53868. </exception>
  53869. <exception cref="T:System.ArgumentOutOfRangeException">
  53870. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  53871. </exception>
  53872. <exception cref="T:System.ArgumentException">
  53873. The <paramref name="host"/> is a zero-length string.
  53874. </exception>
  53875. <exception cref="T:System.ObjectDisposedException">
  53876. The <see cref="T:MailKit.MailService"/> has been disposed.
  53877. </exception>
  53878. <exception cref="T:System.InvalidOperationException">
  53879. The <see cref="T:MailKit.MailService"/> is already connected.
  53880. </exception>
  53881. <exception cref="T:System.OperationCanceledException">
  53882. The operation was canceled via the cancellation token.
  53883. </exception>
  53884. <exception cref="T:System.Net.Sockets.SocketException">
  53885. A socket error occurred trying to connect to the remote host.
  53886. </exception>
  53887. <exception cref="T:System.IO.IOException">
  53888. An I/O error occurred.
  53889. </exception>
  53890. <exception cref="T:MailKit.ProtocolException">
  53891. A protocol error occurred.
  53892. </exception>
  53893. </member>
  53894. <member name="M:MailKit.MailService.Connect(System.Net.Sockets.Socket,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  53895. <summary>
  53896. Establish a connection to the specified mail server using the provided socket.
  53897. </summary>
  53898. <remarks>
  53899. <para>Establish a connection to the specified mail server using the provided socket.</para>
  53900. <para>If a successful connection is made, the <see cref="P:MailKit.MailService.AuthenticationMechanisms"/>
  53901. property will be populated.</para>
  53902. </remarks>
  53903. <param name="socket">The socket to use for the connection.</param>
  53904. <param name="host">The host name to connect to.</param>
  53905. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  53906. <param name="options">The secure socket options to when connecting.</param>
  53907. <param name="cancellationToken">The cancellation token.</param>
  53908. <exception cref="T:System.ArgumentNullException">
  53909. <para><paramref name="socket"/> is <c>null</c>.</para>
  53910. <para>-or-</para>
  53911. <para><paramref name="host"/> is <c>null</c>.</para>
  53912. </exception>
  53913. <exception cref="T:System.ArgumentOutOfRangeException">
  53914. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  53915. </exception>
  53916. <exception cref="T:System.ArgumentException">
  53917. <para><paramref name="socket"/> is not connected.</para>
  53918. <para>-or-</para>
  53919. <para>The <paramref name="host"/> is a zero-length string.</para>
  53920. </exception>
  53921. <exception cref="T:System.InvalidOperationException">
  53922. The <see cref="T:MailKit.IMailService"/> is already connected.
  53923. </exception>
  53924. <exception cref="T:System.OperationCanceledException">
  53925. The operation was canceled via the cancellation token.
  53926. </exception>
  53927. <exception cref="T:System.IO.IOException">
  53928. An I/O error occurred.
  53929. </exception>
  53930. <exception cref="T:MailKit.CommandException">
  53931. The command was rejected by the mail server.
  53932. </exception>
  53933. <exception cref="T:MailKit.ProtocolException">
  53934. The server responded with an unexpected token.
  53935. </exception>
  53936. </member>
  53937. <member name="M:MailKit.MailService.ConnectAsync(System.Net.Sockets.Socket,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  53938. <summary>
  53939. Asynchronously establish a connection to the specified mail server using the provided socket.
  53940. </summary>
  53941. <remarks>
  53942. <para>Asynchronously establishes a connection to the specified mail server using the provided socket.</para>
  53943. <para>If a successful connection is made, the <see cref="P:MailKit.MailService.AuthenticationMechanisms"/>
  53944. property will be populated.</para>
  53945. </remarks>
  53946. <returns>An asynchronous task context.</returns>
  53947. <param name="socket">The socket to use for the connection.</param>
  53948. <param name="host">The host name to connect to.</param>
  53949. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  53950. <param name="options">The secure socket options to when connecting.</param>
  53951. <param name="cancellationToken">The cancellation token.</param>
  53952. <exception cref="T:System.ArgumentNullException">
  53953. <para><paramref name="socket"/> is <c>null</c>.</para>
  53954. <para>-or-</para>
  53955. <para><paramref name="host"/> is <c>null</c>.</para>
  53956. </exception>
  53957. <exception cref="T:System.ArgumentOutOfRangeException">
  53958. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  53959. </exception>
  53960. <exception cref="T:System.ArgumentException">
  53961. <para><paramref name="socket"/> is not connected.</para>
  53962. <para>-or-</para>
  53963. <para>The <paramref name="host"/> is a zero-length string.</para>
  53964. </exception>
  53965. <exception cref="T:System.InvalidOperationException">
  53966. The <see cref="T:MailKit.IMailService"/> is already connected.
  53967. </exception>
  53968. <exception cref="T:System.OperationCanceledException">
  53969. The operation was canceled via the cancellation token.
  53970. </exception>
  53971. <exception cref="T:System.IO.IOException">
  53972. An I/O error occurred.
  53973. </exception>
  53974. <exception cref="T:MailKit.CommandException">
  53975. The command was rejected by the mail server.
  53976. </exception>
  53977. <exception cref="T:MailKit.ProtocolException">
  53978. The server responded with an unexpected token.
  53979. </exception>
  53980. </member>
  53981. <member name="M:MailKit.MailService.Connect(System.IO.Stream,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  53982. <summary>
  53983. Establish a connection to the specified mail server using the provided stream.
  53984. </summary>
  53985. <remarks>
  53986. <para>Establish a connection to the specified mail server using the provided stream.</para>
  53987. <para>If a successful connection is made, the <see cref="P:MailKit.MailService.AuthenticationMechanisms"/>
  53988. property will be populated.</para>
  53989. </remarks>
  53990. <param name="stream">The stream to use for the connection.</param>
  53991. <param name="host">The host name to connect to.</param>
  53992. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  53993. <param name="options">The secure socket options to when connecting.</param>
  53994. <param name="cancellationToken">The cancellation token.</param>
  53995. <exception cref="T:System.ArgumentNullException">
  53996. <para><paramref name="stream"/> is <c>null</c>.</para>
  53997. <para>-or-</para>
  53998. <para><paramref name="host"/> is <c>null</c>.</para>
  53999. </exception>
  54000. <exception cref="T:System.ArgumentOutOfRangeException">
  54001. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  54002. </exception>
  54003. <exception cref="T:System.ArgumentException">
  54004. The <paramref name="host"/> is a zero-length string.
  54005. </exception>
  54006. <exception cref="T:System.InvalidOperationException">
  54007. The <see cref="T:MailKit.IMailService"/> is already connected.
  54008. </exception>
  54009. <exception cref="T:System.OperationCanceledException">
  54010. The operation was canceled via the cancellation token.
  54011. </exception>
  54012. <exception cref="T:System.IO.IOException">
  54013. An I/O error occurred.
  54014. </exception>
  54015. <exception cref="T:MailKit.CommandException">
  54016. The command was rejected by the mail server.
  54017. </exception>
  54018. <exception cref="T:MailKit.ProtocolException">
  54019. The server responded with an unexpected token.
  54020. </exception>
  54021. </member>
  54022. <member name="M:MailKit.MailService.ConnectAsync(System.IO.Stream,System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)">
  54023. <summary>
  54024. Asynchronously establish a connection to the specified mail server using the provided stream.
  54025. </summary>
  54026. <remarks>
  54027. <para>Asynchronously establishes a connection to the specified mail server using the provided stream.</para>
  54028. <para>If a successful connection is made, the <see cref="P:MailKit.MailService.AuthenticationMechanisms"/>
  54029. property will be populated.</para>
  54030. </remarks>
  54031. <returns>An asynchronous task context.</returns>
  54032. <param name="stream">The stream to use for the connection.</param>
  54033. <param name="host">The host name to connect to.</param>
  54034. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  54035. <param name="options">The secure socket options to when connecting.</param>
  54036. <param name="cancellationToken">The cancellation token.</param>
  54037. <exception cref="T:System.ArgumentNullException">
  54038. <para><paramref name="stream"/> is <c>null</c>.</para>
  54039. <para>-or-</para>
  54040. <para><paramref name="host"/> is <c>null</c>.</para>
  54041. </exception>
  54042. <exception cref="T:System.ArgumentOutOfRangeException">
  54043. <paramref name="port"/> is not between <c>0</c> and <c>65535</c>.
  54044. </exception>
  54045. <exception cref="T:System.ArgumentException">
  54046. The <paramref name="host"/> is a zero-length string.
  54047. </exception>
  54048. <exception cref="T:System.InvalidOperationException">
  54049. The <see cref="T:MailKit.IMailService"/> is already connected.
  54050. </exception>
  54051. <exception cref="T:System.OperationCanceledException">
  54052. The operation was canceled via the cancellation token.
  54053. </exception>
  54054. <exception cref="T:System.IO.IOException">
  54055. An I/O error occurred.
  54056. </exception>
  54057. <exception cref="T:MailKit.CommandException">
  54058. The command was rejected by the mail server.
  54059. </exception>
  54060. <exception cref="T:MailKit.ProtocolException">
  54061. The server responded with an unexpected token.
  54062. </exception>
  54063. </member>
  54064. <member name="M:MailKit.MailService.Connect(System.Uri,System.Threading.CancellationToken)">
  54065. <summary>
  54066. Establish a connection to the specified mail server.
  54067. </summary>
  54068. <remarks>
  54069. Establishes a connection to the specified mail server.
  54070. </remarks>
  54071. <example>
  54072. <code language="c#" source="Examples\SmtpExamples.cs" region="SendMessageUri"/>
  54073. </example>
  54074. <param name="uri">The server URI.</param>
  54075. <param name="cancellationToken">The cancellation token.</param>
  54076. <exception cref="T:System.ArgumentNullException">
  54077. The <paramref name="uri"/> is <c>null</c>.
  54078. </exception>
  54079. <exception cref="T:System.ArgumentException">
  54080. The <paramref name="uri"/> is not an absolute URI.
  54081. </exception>
  54082. <exception cref="T:System.ObjectDisposedException">
  54083. The <see cref="T:MailKit.MailService"/> has been disposed.
  54084. </exception>
  54085. <exception cref="T:System.InvalidOperationException">
  54086. The <see cref="T:MailKit.MailService"/> is already connected.
  54087. </exception>
  54088. <exception cref="T:System.OperationCanceledException">
  54089. The operation was canceled via the cancellation token.
  54090. </exception>
  54091. <exception cref="T:System.Net.Sockets.SocketException">
  54092. A socket error occurred trying to connect to the remote host.
  54093. </exception>
  54094. <exception cref="T:System.IO.IOException">
  54095. An I/O error occurred.
  54096. </exception>
  54097. <exception cref="T:MailKit.ProtocolException">
  54098. A protocol error occurred.
  54099. </exception>
  54100. </member>
  54101. <member name="M:MailKit.MailService.ConnectAsync(System.Uri,System.Threading.CancellationToken)">
  54102. <summary>
  54103. Asynchronously establish a connection to the specified mail server.
  54104. </summary>
  54105. <remarks>
  54106. Asynchronously establishes a connection to the specified mail server.
  54107. </remarks>
  54108. <returns>An asynchronous task context.</returns>
  54109. <param name="uri">The server URI.</param>
  54110. <param name="cancellationToken">The cancellation token.</param>
  54111. <exception cref="T:System.ArgumentNullException">
  54112. The <paramref name="uri"/> is <c>null</c>.
  54113. </exception>
  54114. <exception cref="T:System.ArgumentException">
  54115. The <paramref name="uri"/> is not an absolute URI.
  54116. </exception>
  54117. <exception cref="T:System.ObjectDisposedException">
  54118. The <see cref="T:MailKit.MailService"/> has been disposed.
  54119. </exception>
  54120. <exception cref="T:System.InvalidOperationException">
  54121. The <see cref="T:MailKit.MailService"/> is already connected.
  54122. </exception>
  54123. <exception cref="T:System.OperationCanceledException">
  54124. The operation was canceled via the cancellation token.
  54125. </exception>
  54126. <exception cref="T:System.Net.Sockets.SocketException">
  54127. A socket error occurred trying to connect to the remote host.
  54128. </exception>
  54129. <exception cref="T:System.IO.IOException">
  54130. An I/O error occurred.
  54131. </exception>
  54132. <exception cref="T:MailKit.ProtocolException">
  54133. A protocol error occurred.
  54134. </exception>
  54135. </member>
  54136. <member name="M:MailKit.MailService.Connect(System.String,System.Int32,System.Boolean,System.Threading.CancellationToken)">
  54137. <summary>
  54138. Establish a connection to the specified mail server.
  54139. </summary>
  54140. <remarks>
  54141. <para>Establishes a connection to the specified mail server.</para>
  54142. <note type="note">
  54143. <para>The <paramref name="useSsl"/> argument only controls whether or
  54144. not the client makes an SSL-wrapped connection. In other words, even if the
  54145. <paramref name="useSsl"/> parameter is <c>false</c>, SSL/TLS may still be used if
  54146. the mail server supports the STARTTLS extension.</para>
  54147. <para>To disable all use of SSL/TLS, use the
  54148. <see cref="M:MailKit.MailService.Connect(System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)"/>
  54149. overload with a value of
  54150. <see cref="F:MailKit.Security.SecureSocketOptions.None">SecureSocketOptions.None</see>
  54151. instead.</para>
  54152. </note>
  54153. </remarks>
  54154. <param name="host">The host to connect to.</param>
  54155. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  54156. <param name="useSsl"><value>true</value> if the client should make an SSL-wrapped connection to the server; otherwise, <value>false</value>.</param>
  54157. <param name="cancellationToken">The cancellation token.</param>
  54158. <exception cref="T:System.ArgumentNullException">
  54159. The <paramref name="host"/> is <c>null</c>.
  54160. </exception>
  54161. <exception cref="T:System.ArgumentOutOfRangeException">
  54162. <paramref name="port"/> is out of range (<value>0</value> to <value>65535</value>, inclusive).
  54163. </exception>
  54164. <exception cref="T:System.ArgumentException">
  54165. The <paramref name="host"/> is a zero-length string.
  54166. </exception>
  54167. <exception cref="T:System.ObjectDisposedException">
  54168. The <see cref="T:MailKit.MailService"/> has been disposed.
  54169. </exception>
  54170. <exception cref="T:System.InvalidOperationException">
  54171. The <see cref="T:MailKit.MailService"/> is already connected.
  54172. </exception>
  54173. <exception cref="T:System.OperationCanceledException">
  54174. The operation was canceled via the cancellation token.
  54175. </exception>
  54176. <exception cref="T:System.Net.Sockets.SocketException">
  54177. A socket error occurred trying to connect to the remote host.
  54178. </exception>
  54179. <exception cref="T:System.IO.IOException">
  54180. An I/O error occurred.
  54181. </exception>
  54182. <exception cref="T:MailKit.ProtocolException">
  54183. A protocol error occurred.
  54184. </exception>
  54185. </member>
  54186. <member name="M:MailKit.MailService.ConnectAsync(System.String,System.Int32,System.Boolean,System.Threading.CancellationToken)">
  54187. <summary>
  54188. Asynchronously establish a connection to the specified mail server.
  54189. </summary>
  54190. <remarks>
  54191. <para>Asynchronously establishes a connection to the specified mail server.</para>
  54192. <note type="note">
  54193. <para>The <paramref name="useSsl"/> argument only controls whether or
  54194. not the client makes an SSL-wrapped connection. In other words, even if the
  54195. <paramref name="useSsl"/> parameter is <c>false</c>, SSL/TLS may still be used if
  54196. the mail server supports the STARTTLS extension.</para>
  54197. <para>To disable all use of SSL/TLS, use the
  54198. <see cref="M:MailKit.MailService.ConnectAsync(System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Threading.CancellationToken)"/>
  54199. overload with a value of
  54200. <see cref="F:MailKit.Security.SecureSocketOptions.None">SecureSocketOptions.None</see>
  54201. instead.</para>
  54202. </note>
  54203. </remarks>
  54204. <returns>An asynchronous task context.</returns>
  54205. <param name="host">The host to connect to.</param>
  54206. <param name="port">The port to connect to. If the specified port is <c>0</c>, then the default port will be used.</param>
  54207. <param name="useSsl"><value>true</value> if the client should make an SSL-wrapped connection to the server; otherwise, <value>false</value>.</param>
  54208. <param name="cancellationToken">The cancellation token.</param>
  54209. <exception cref="T:System.ArgumentNullException">
  54210. The <paramref name="host"/> is <c>null</c>.
  54211. </exception>
  54212. <exception cref="T:System.ArgumentOutOfRangeException">
  54213. <paramref name="port"/> is out of range (<value>0</value> to <value>65535</value>, inclusive).
  54214. </exception>
  54215. <exception cref="T:System.ArgumentException">
  54216. The <paramref name="host"/> is a zero-length string.
  54217. </exception>
  54218. <exception cref="T:System.ObjectDisposedException">
  54219. The <see cref="T:MailKit.MailService"/> has been disposed.
  54220. </exception>
  54221. <exception cref="T:System.InvalidOperationException">
  54222. The <see cref="T:MailKit.MailService"/> is already connected.
  54223. </exception>
  54224. <exception cref="T:System.OperationCanceledException">
  54225. The operation was canceled via the cancellation token.
  54226. </exception>
  54227. <exception cref="T:System.Net.Sockets.SocketException">
  54228. A socket error occurred trying to connect to the remote host.
  54229. </exception>
  54230. <exception cref="T:System.IO.IOException">
  54231. An I/O error occurred.
  54232. </exception>
  54233. <exception cref="T:MailKit.ProtocolException">
  54234. A protocol error occurred.
  54235. </exception>
  54236. </member>
  54237. <member name="M:MailKit.MailService.Authenticate(System.Text.Encoding,System.Net.ICredentials,System.Threading.CancellationToken)">
  54238. <summary>
  54239. Authenticate using the supplied credentials.
  54240. </summary>
  54241. <remarks>
  54242. <para>If the server supports one or more SASL authentication mechanisms,
  54243. then the SASL mechanisms that both the client and server support are tried
  54244. in order of greatest security to weakest security. Once a SASL
  54245. authentication mechanism is found that both client and server support,
  54246. the credentials are used to authenticate.</para>
  54247. <para>If the server does not support SASL or if no common SASL mechanisms
  54248. can be found, then the default login command is used as a fallback.</para>
  54249. <note type="tip">To prevent the usage of certain authentication mechanisms,
  54250. simply remove them from the <see cref="P:MailKit.MailService.AuthenticationMechanisms"/> hash set
  54251. before calling this method.</note>
  54252. </remarks>
  54253. <param name="encoding">The encoding to use for the user's credentials.</param>
  54254. <param name="credentials">The user's credentials.</param>
  54255. <param name="cancellationToken">The cancellation token.</param>
  54256. <exception cref="T:System.ArgumentNullException">
  54257. <para><paramref name="encoding"/> is <c>null</c>.</para>
  54258. <para>-or-</para>
  54259. <para><paramref name="credentials"/> is <c>null</c>.</para>
  54260. </exception>
  54261. <exception cref="T:System.ObjectDisposedException">
  54262. The <see cref="T:MailKit.MailService"/> has been disposed.
  54263. </exception>
  54264. <exception cref="T:System.InvalidOperationException">
  54265. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  54266. </exception>
  54267. <exception cref="T:System.OperationCanceledException">
  54268. The operation was canceled via the cancellation token.
  54269. </exception>
  54270. <exception cref="T:MailKit.Security.AuthenticationException">
  54271. Authentication using the supplied credentials has failed.
  54272. </exception>
  54273. <exception cref="T:MailKit.Security.SaslException">
  54274. A SASL authentication error occurred.
  54275. </exception>
  54276. <exception cref="T:System.IO.IOException">
  54277. An I/O error occurred.
  54278. </exception>
  54279. <exception cref="T:MailKit.ProtocolException">
  54280. A protocol error occurred.
  54281. </exception>
  54282. </member>
  54283. <member name="M:MailKit.MailService.AuthenticateAsync(System.Text.Encoding,System.Net.ICredentials,System.Threading.CancellationToken)">
  54284. <summary>
  54285. Asynchronously authenticate using the supplied credentials.
  54286. </summary>
  54287. <remarks>
  54288. <para>If the server supports one or more SASL authentication mechanisms,
  54289. then the SASL mechanisms that both the client and server support are tried
  54290. in order of greatest security to weakest security. Once a SASL
  54291. authentication mechanism is found that both client and server support,
  54292. the credentials are used to authenticate.</para>
  54293. <para>If the server does not support SASL or if no common SASL mechanisms
  54294. can be found, then the default login command is used as a fallback.</para>
  54295. <note type="tip">To prevent the usage of certain authentication mechanisms,
  54296. simply remove them from the <see cref="P:MailKit.MailService.AuthenticationMechanisms"/> hash set
  54297. before calling this method.</note>
  54298. </remarks>
  54299. <returns>An asynchronous task context.</returns>
  54300. <param name="encoding">The encoding to use for the user's credentials.</param>
  54301. <param name="credentials">The user's credentials.</param>
  54302. <param name="cancellationToken">The cancellation token.</param>
  54303. <exception cref="T:System.ArgumentNullException">
  54304. <para><paramref name="encoding"/> is <c>null</c>.</para>
  54305. <para>-or-</para>
  54306. <para><paramref name="credentials"/> is <c>null</c>.</para>
  54307. </exception>
  54308. <exception cref="T:System.ObjectDisposedException">
  54309. The <see cref="T:MailKit.MailService"/> has been disposed.
  54310. </exception>
  54311. <exception cref="T:System.InvalidOperationException">
  54312. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  54313. </exception>
  54314. <exception cref="T:System.OperationCanceledException">
  54315. The operation was canceled via the cancellation token.
  54316. </exception>
  54317. <exception cref="T:MailKit.Security.AuthenticationException">
  54318. Authentication using the supplied credentials has failed.
  54319. </exception>
  54320. <exception cref="T:MailKit.Security.SaslException">
  54321. A SASL authentication error occurred.
  54322. </exception>
  54323. <exception cref="T:System.IO.IOException">
  54324. An I/O error occurred.
  54325. </exception>
  54326. <exception cref="T:MailKit.ProtocolException">
  54327. A protocol error occurred.
  54328. </exception>
  54329. </member>
  54330. <member name="M:MailKit.MailService.Authenticate(System.Net.ICredentials,System.Threading.CancellationToken)">
  54331. <summary>
  54332. Authenticate using the supplied credentials.
  54333. </summary>
  54334. <remarks>
  54335. <para>If the server supports one or more SASL authentication mechanisms,
  54336. then the SASL mechanisms that both the client and server support are tried
  54337. in order of greatest security to weakest security. Once a SASL
  54338. authentication mechanism is found that both client and server support,
  54339. the credentials are used to authenticate.</para>
  54340. <para>If the server does not support SASL or if no common SASL mechanisms
  54341. can be found, then the default login command is used as a fallback.</para>
  54342. <note type="tip">To prevent the usage of certain authentication mechanisms,
  54343. simply remove them from the <see cref="P:MailKit.MailService.AuthenticationMechanisms"/> hash set
  54344. before calling this method.</note>
  54345. </remarks>
  54346. <param name="credentials">The user's credentials.</param>
  54347. <param name="cancellationToken">The cancellation token.</param>
  54348. <exception cref="T:System.ArgumentNullException">
  54349. <paramref name="credentials"/> is <c>null</c>.
  54350. </exception>
  54351. <exception cref="T:System.ObjectDisposedException">
  54352. The <see cref="T:MailKit.MailService"/> has been disposed.
  54353. </exception>
  54354. <exception cref="T:System.InvalidOperationException">
  54355. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  54356. </exception>
  54357. <exception cref="T:System.OperationCanceledException">
  54358. The operation was canceled via the cancellation token.
  54359. </exception>
  54360. <exception cref="T:MailKit.Security.AuthenticationException">
  54361. Authentication using the supplied credentials has failed.
  54362. </exception>
  54363. <exception cref="T:MailKit.Security.SaslException">
  54364. A SASL authentication error occurred.
  54365. </exception>
  54366. <exception cref="T:System.IO.IOException">
  54367. An I/O error occurred.
  54368. </exception>
  54369. <exception cref="T:MailKit.ProtocolException">
  54370. A protocol error occurred.
  54371. </exception>
  54372. </member>
  54373. <member name="M:MailKit.MailService.AuthenticateAsync(System.Net.ICredentials,System.Threading.CancellationToken)">
  54374. <summary>
  54375. Asynchronously authenticate using the supplied credentials.
  54376. </summary>
  54377. <remarks>
  54378. <para>If the server supports one or more SASL authentication mechanisms,
  54379. then the SASL mechanisms that both the client and server support are tried
  54380. in order of greatest security to weakest security. Once a SASL
  54381. authentication mechanism is found that both client and server support,
  54382. the credentials are used to authenticate.</para>
  54383. <para>If the server does not support SASL or if no common SASL mechanisms
  54384. can be found, then the default login command is used as a fallback.</para>
  54385. <note type="tip">To prevent the usage of certain authentication mechanisms,
  54386. simply remove them from the <see cref="P:MailKit.MailService.AuthenticationMechanisms"/> hash set
  54387. before calling this method.</note>
  54388. </remarks>
  54389. <returns>An asynchronous task context.</returns>
  54390. <param name="credentials">The user's credentials.</param>
  54391. <param name="cancellationToken">The cancellation token.</param>
  54392. <exception cref="T:System.ArgumentNullException">
  54393. <paramref name="credentials"/> is <c>null</c>.
  54394. </exception>
  54395. <exception cref="T:System.ObjectDisposedException">
  54396. The <see cref="T:MailKit.MailService"/> has been disposed.
  54397. </exception>
  54398. <exception cref="T:System.InvalidOperationException">
  54399. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  54400. </exception>
  54401. <exception cref="T:System.OperationCanceledException">
  54402. The operation was canceled via the cancellation token.
  54403. </exception>
  54404. <exception cref="T:MailKit.Security.AuthenticationException">
  54405. Authentication using the supplied credentials has failed.
  54406. </exception>
  54407. <exception cref="T:MailKit.Security.SaslException">
  54408. A SASL authentication error occurred.
  54409. </exception>
  54410. <exception cref="T:System.IO.IOException">
  54411. An I/O error occurred.
  54412. </exception>
  54413. <exception cref="T:MailKit.ProtocolException">
  54414. A protocol error occurred.
  54415. </exception>
  54416. </member>
  54417. <member name="M:MailKit.MailService.Authenticate(System.Text.Encoding,System.String,System.String,System.Threading.CancellationToken)">
  54418. <summary>
  54419. Authenticate using the specified user name and password.
  54420. </summary>
  54421. <remarks>
  54422. <para>If the server supports one or more SASL authentication mechanisms,
  54423. then the SASL mechanisms that both the client and server support are tried
  54424. in order of greatest security to weakest security. Once a SASL
  54425. authentication mechanism is found that both client and server support,
  54426. the credentials are used to authenticate.</para>
  54427. <para>If the server does not support SASL or if no common SASL mechanisms
  54428. can be found, then the default login command is used as a fallback.</para>
  54429. <note type="tip">To prevent the usage of certain authentication mechanisms,
  54430. simply remove them from the <see cref="P:MailKit.MailService.AuthenticationMechanisms"/> hash set
  54431. before calling this method.</note>
  54432. </remarks>
  54433. <param name="encoding">The encoding to use for the user's credentials.</param>
  54434. <param name="userName">The user name.</param>
  54435. <param name="password">The password.</param>
  54436. <param name="cancellationToken">The cancellation token.</param>
  54437. <exception cref="T:System.ArgumentNullException">
  54438. <para><paramref name="encoding"/> is <c>null</c>.</para>
  54439. <para>-or-</para>
  54440. <para><paramref name="userName"/> is <c>null</c>.</para>
  54441. <para>-or-</para>
  54442. <para><paramref name="password"/> is <c>null</c>.</para>
  54443. </exception>
  54444. <exception cref="T:System.ObjectDisposedException">
  54445. The <see cref="T:MailKit.MailService"/> has been disposed.
  54446. </exception>
  54447. <exception cref="T:System.InvalidOperationException">
  54448. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  54449. </exception>
  54450. <exception cref="T:System.OperationCanceledException">
  54451. The operation was canceled via the cancellation token.
  54452. </exception>
  54453. <exception cref="T:MailKit.Security.AuthenticationException">
  54454. Authentication using the supplied credentials has failed.
  54455. </exception>
  54456. <exception cref="T:MailKit.Security.SaslException">
  54457. A SASL authentication error occurred.
  54458. </exception>
  54459. <exception cref="T:System.IO.IOException">
  54460. An I/O error occurred.
  54461. </exception>
  54462. <exception cref="T:MailKit.ProtocolException">
  54463. A protocol error occurred.
  54464. </exception>
  54465. </member>
  54466. <member name="M:MailKit.MailService.AuthenticateAsync(System.Text.Encoding,System.String,System.String,System.Threading.CancellationToken)">
  54467. <summary>
  54468. Asynchronously authenticate using the specified user name and password.
  54469. </summary>
  54470. <remarks>
  54471. <para>If the server supports one or more SASL authentication mechanisms,
  54472. then the SASL mechanisms that both the client and server support are tried
  54473. in order of greatest security to weakest security. Once a SASL
  54474. authentication mechanism is found that both client and server support,
  54475. the credentials are used to authenticate.</para>
  54476. <para>If the server does not support SASL or if no common SASL mechanisms
  54477. can be found, then the default login command is used as a fallback.</para>
  54478. <note type="tip">To prevent the usage of certain authentication mechanisms,
  54479. simply remove them from the <see cref="P:MailKit.MailService.AuthenticationMechanisms"/> hash set
  54480. before calling this method.</note>
  54481. </remarks>
  54482. <returns>An asynchronous task context.</returns>
  54483. <param name="encoding">The encoding to use for the user's credentials.</param>
  54484. <param name="userName">The user name.</param>
  54485. <param name="password">The password.</param>
  54486. <param name="cancellationToken">The cancellation token.</param>
  54487. <exception cref="T:System.ArgumentNullException">
  54488. <para><paramref name="encoding"/> is <c>null</c>.</para>
  54489. <para>-or-</para>
  54490. <para><paramref name="userName"/> is <c>null</c>.</para>
  54491. <para>-or-</para>
  54492. <para><paramref name="password"/> is <c>null</c>.</para>
  54493. </exception>
  54494. <exception cref="T:System.ObjectDisposedException">
  54495. The <see cref="T:MailKit.MailService"/> has been disposed.
  54496. </exception>
  54497. <exception cref="T:System.InvalidOperationException">
  54498. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  54499. </exception>
  54500. <exception cref="T:System.OperationCanceledException">
  54501. The operation was canceled via the cancellation token.
  54502. </exception>
  54503. <exception cref="T:MailKit.Security.AuthenticationException">
  54504. Authentication using the supplied credentials has failed.
  54505. </exception>
  54506. <exception cref="T:MailKit.Security.SaslException">
  54507. A SASL authentication error occurred.
  54508. </exception>
  54509. <exception cref="T:System.IO.IOException">
  54510. An I/O error occurred.
  54511. </exception>
  54512. <exception cref="T:MailKit.ProtocolException">
  54513. A protocol error occurred.
  54514. </exception>
  54515. </member>
  54516. <member name="M:MailKit.MailService.Authenticate(System.String,System.String,System.Threading.CancellationToken)">
  54517. <summary>
  54518. Authenticate using the specified user name and password.
  54519. </summary>
  54520. <remarks>
  54521. <para>If the server supports one or more SASL authentication mechanisms,
  54522. then the SASL mechanisms that both the client and server support are tried
  54523. in order of greatest security to weakest security. Once a SASL
  54524. authentication mechanism is found that both client and server support,
  54525. the credentials are used to authenticate.</para>
  54526. <para>If the server does not support SASL or if no common SASL mechanisms
  54527. can be found, then the default login command is used as a fallback.</para>
  54528. <note type="tip">To prevent the usage of certain authentication mechanisms,
  54529. simply remove them from the <see cref="P:MailKit.MailService.AuthenticationMechanisms"/> hash set
  54530. before calling this method.</note>
  54531. </remarks>
  54532. <example>
  54533. <code language="c#" source="Examples\SmtpExamples.cs" region="SendMessage"/>
  54534. </example>
  54535. <param name="userName">The user name.</param>
  54536. <param name="password">The password.</param>
  54537. <param name="cancellationToken">The cancellation token.</param>
  54538. <exception cref="T:System.ArgumentNullException">
  54539. <para><paramref name="userName"/> is <c>null</c>.</para>
  54540. <para>-or-</para>
  54541. <para><paramref name="password"/> is <c>null</c>.</para>
  54542. </exception>
  54543. <exception cref="T:System.ObjectDisposedException">
  54544. The <see cref="T:MailKit.MailService"/> has been disposed.
  54545. </exception>
  54546. <exception cref="T:System.InvalidOperationException">
  54547. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  54548. </exception>
  54549. <exception cref="T:System.OperationCanceledException">
  54550. The operation was canceled via the cancellation token.
  54551. </exception>
  54552. <exception cref="T:MailKit.Security.AuthenticationException">
  54553. Authentication using the supplied credentials has failed.
  54554. </exception>
  54555. <exception cref="T:MailKit.Security.SaslException">
  54556. A SASL authentication error occurred.
  54557. </exception>
  54558. <exception cref="T:System.IO.IOException">
  54559. An I/O error occurred.
  54560. </exception>
  54561. <exception cref="T:MailKit.ProtocolException">
  54562. A protocol error occurred.
  54563. </exception>
  54564. </member>
  54565. <member name="M:MailKit.MailService.AuthenticateAsync(System.String,System.String,System.Threading.CancellationToken)">
  54566. <summary>
  54567. Asynchronously authenticate using the specified user name and password.
  54568. </summary>
  54569. <remarks>
  54570. <para>If the server supports one or more SASL authentication mechanisms,
  54571. then the SASL mechanisms that both the client and server support are tried
  54572. in order of greatest security to weakest security. Once a SASL
  54573. authentication mechanism is found that both client and server support,
  54574. the credentials are used to authenticate.</para>
  54575. <para>If the server does not support SASL or if no common SASL mechanisms
  54576. can be found, then the default login command is used as a fallback.</para>
  54577. <note type="tip">To prevent the usage of certain authentication mechanisms,
  54578. simply remove them from the <see cref="P:MailKit.MailService.AuthenticationMechanisms"/> hash set
  54579. before calling this method.</note>
  54580. </remarks>
  54581. <returns>An asynchronous task context.</returns>
  54582. <param name="userName">The user name.</param>
  54583. <param name="password">The password.</param>
  54584. <param name="cancellationToken">The cancellation token.</param>
  54585. <exception cref="T:System.ArgumentNullException">
  54586. <para><paramref name="userName"/> is <c>null</c>.</para>
  54587. <para>-or-</para>
  54588. <para><paramref name="password"/> is <c>null</c>.</para>
  54589. </exception>
  54590. <exception cref="T:System.ObjectDisposedException">
  54591. The <see cref="T:MailKit.MailService"/> has been disposed.
  54592. </exception>
  54593. <exception cref="T:System.InvalidOperationException">
  54594. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  54595. </exception>
  54596. <exception cref="T:System.OperationCanceledException">
  54597. The operation was canceled via the cancellation token.
  54598. </exception>
  54599. <exception cref="T:MailKit.Security.AuthenticationException">
  54600. Authentication using the supplied credentials has failed.
  54601. </exception>
  54602. <exception cref="T:MailKit.Security.SaslException">
  54603. A SASL authentication error occurred.
  54604. </exception>
  54605. <exception cref="T:System.IO.IOException">
  54606. An I/O error occurred.
  54607. </exception>
  54608. <exception cref="T:MailKit.ProtocolException">
  54609. A protocol error occurred.
  54610. </exception>
  54611. </member>
  54612. <member name="M:MailKit.MailService.Authenticate(MailKit.Security.SaslMechanism,System.Threading.CancellationToken)">
  54613. <summary>
  54614. Authenticate using the specified SASL mechanism.
  54615. </summary>
  54616. <remarks>
  54617. <para>Authenticates using the specified SASL mechanism.</para>
  54618. <para>For a list of available SASL authentication mechanisms supported by the server,
  54619. check the <see cref="P:MailKit.MailService.AuthenticationMechanisms"/> property after the service has been
  54620. connected.</para>
  54621. </remarks>
  54622. <param name="mechanism">The SASL mechanism.</param>
  54623. <param name="cancellationToken">The cancellation token.</param>
  54624. <exception cref="T:System.ArgumentNullException">
  54625. <paramref name="mechanism"/> is <c>null</c>.
  54626. </exception>
  54627. <exception cref="T:System.ObjectDisposedException">
  54628. The <see cref="T:MailKit.MailService"/> has been disposed.
  54629. </exception>
  54630. <exception cref="T:System.InvalidOperationException">
  54631. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  54632. </exception>
  54633. <exception cref="T:System.OperationCanceledException">
  54634. The operation was canceled via the cancellation token.
  54635. </exception>
  54636. <exception cref="T:MailKit.Security.AuthenticationException">
  54637. Authentication using the supplied credentials has failed.
  54638. </exception>
  54639. <exception cref="T:MailKit.Security.SaslException">
  54640. A SASL authentication error occurred.
  54641. </exception>
  54642. <exception cref="T:System.IO.IOException">
  54643. An I/O error occurred.
  54644. </exception>
  54645. <exception cref="T:MailKit.ProtocolException">
  54646. A protocol error occurred.
  54647. </exception>
  54648. </member>
  54649. <member name="M:MailKit.MailService.AuthenticateAsync(MailKit.Security.SaslMechanism,System.Threading.CancellationToken)">
  54650. <summary>
  54651. Asynchronously authenticate using the specified SASL mechanism.
  54652. </summary>
  54653. <remarks>
  54654. <para>Authenticates using the specified SASL mechanism.</para>
  54655. <para>For a list of available SASL authentication mechanisms supported by the server,
  54656. check the <see cref="P:MailKit.MailService.AuthenticationMechanisms"/> property after the service has been
  54657. connected.</para>
  54658. </remarks>
  54659. <returns>An asynchronous task context.</returns>
  54660. <param name="mechanism">The SASL mechanism.</param>
  54661. <param name="cancellationToken">The cancellation token.</param>
  54662. <exception cref="T:System.ArgumentNullException">
  54663. <paramref name="mechanism"/> is <c>null</c>.
  54664. </exception>
  54665. <exception cref="T:System.ObjectDisposedException">
  54666. The <see cref="T:MailKit.MailService"/> has been disposed.
  54667. </exception>
  54668. <exception cref="T:System.InvalidOperationException">
  54669. The <see cref="T:MailKit.MailService"/> is not connected or is already authenticated.
  54670. </exception>
  54671. <exception cref="T:System.OperationCanceledException">
  54672. The operation was canceled via the cancellation token.
  54673. </exception>
  54674. <exception cref="T:MailKit.Security.AuthenticationException">
  54675. Authentication using the supplied credentials has failed.
  54676. </exception>
  54677. <exception cref="T:MailKit.Security.SaslException">
  54678. A SASL authentication error occurred.
  54679. </exception>
  54680. <exception cref="T:System.IO.IOException">
  54681. An I/O error occurred.
  54682. </exception>
  54683. <exception cref="T:MailKit.ProtocolException">
  54684. A protocol error occurred.
  54685. </exception>
  54686. </member>
  54687. <member name="M:MailKit.MailService.Disconnect(System.Boolean,System.Threading.CancellationToken)">
  54688. <summary>
  54689. Disconnect the service.
  54690. </summary>
  54691. <remarks>
  54692. If <paramref name="quit"/> is <c>true</c>, a logout/quit command will be issued in order to disconnect cleanly.
  54693. </remarks>
  54694. <example>
  54695. <code language="c#" source="Examples\SmtpExamples.cs" region="SendMessage"/>
  54696. </example>
  54697. <param name="quit">If set to <c>true</c>, a logout/quit command will be issued in order to disconnect cleanly.</param>
  54698. <param name="cancellationToken">The cancellation token.</param>
  54699. <exception cref="T:System.ObjectDisposedException">
  54700. The <see cref="T:MailKit.MailService"/> has been disposed.
  54701. </exception>
  54702. </member>
  54703. <member name="M:MailKit.MailService.DisconnectAsync(System.Boolean,System.Threading.CancellationToken)">
  54704. <summary>
  54705. Asynchronously disconnect the service.
  54706. </summary>
  54707. <remarks>
  54708. If <paramref name="quit"/> is <c>true</c>, a logout/quit command will be issued in order to disconnect cleanly.
  54709. </remarks>
  54710. <returns>An asynchronous task context.</returns>
  54711. <param name="quit">If set to <c>true</c>, a logout/quit command will be issued in order to disconnect cleanly.</param>
  54712. <param name="cancellationToken">The cancellation token.</param>
  54713. <exception cref="T:System.ObjectDisposedException">
  54714. The <see cref="T:MailKit.MailService"/> has been disposed.
  54715. </exception>
  54716. </member>
  54717. <member name="M:MailKit.MailService.NoOp(System.Threading.CancellationToken)">
  54718. <summary>
  54719. Ping the mail server to keep the connection alive.
  54720. </summary>
  54721. <remarks>
  54722. Mail servers, if left idle for too long, will automatically drop the connection.
  54723. </remarks>
  54724. <param name="cancellationToken">The cancellation token.</param>
  54725. <exception cref="T:System.ObjectDisposedException">
  54726. The <see cref="T:MailKit.MailService"/> has been disposed.
  54727. </exception>
  54728. <exception cref="T:System.InvalidOperationException">
  54729. <para>The <see cref="T:MailKit.MailService"/> is not connected.</para>
  54730. <para>-or-</para>
  54731. <para>The <see cref="T:MailKit.MailService"/> is not authenticated.</para>
  54732. </exception>
  54733. <exception cref="T:System.OperationCanceledException">
  54734. The operation was canceled via the cancellation token.
  54735. </exception>
  54736. <exception cref="T:System.IO.IOException">
  54737. An I/O error occurred.
  54738. </exception>
  54739. <exception cref="T:MailKit.CommandException">
  54740. The command was rejected by the mail server.
  54741. </exception>
  54742. <exception cref="T:MailKit.ProtocolException">
  54743. The server responded with an unexpected token.
  54744. </exception>
  54745. </member>
  54746. <member name="M:MailKit.MailService.NoOpAsync(System.Threading.CancellationToken)">
  54747. <summary>
  54748. Asynchronously ping the mail server to keep the connection alive.
  54749. </summary>
  54750. <remarks>
  54751. Mail servers, if left idle for too long, will automatically drop the connection.
  54752. </remarks>
  54753. <returns>An asynchronous task context.</returns>
  54754. <param name="cancellationToken">The cancellation token.</param>
  54755. <exception cref="T:System.ObjectDisposedException">
  54756. The <see cref="T:MailKit.MailService"/> has been disposed.
  54757. </exception>
  54758. <exception cref="T:System.InvalidOperationException">
  54759. <para>The <see cref="T:MailKit.MailService"/> is not connected.</para>
  54760. <para>-or-</para>
  54761. <para>The <see cref="T:MailKit.MailService"/> is not authenticated.</para>
  54762. </exception>
  54763. <exception cref="T:System.OperationCanceledException">
  54764. The operation was canceled via the cancellation token.
  54765. </exception>
  54766. <exception cref="T:System.IO.IOException">
  54767. An I/O error occurred.
  54768. </exception>
  54769. <exception cref="T:MailKit.CommandException">
  54770. The command was rejected by the mail server.
  54771. </exception>
  54772. <exception cref="T:MailKit.ProtocolException">
  54773. The server responded with an unexpected token.
  54774. </exception>
  54775. </member>
  54776. <member name="E:MailKit.MailService.Connected">
  54777. <summary>
  54778. Occurs when the client has been successfully connected.
  54779. </summary>
  54780. <remarks>
  54781. The <see cref="E:MailKit.MailService.Connected"/> event is raised when the client
  54782. successfully connects to the mail server.
  54783. </remarks>
  54784. </member>
  54785. <member name="M:MailKit.MailService.OnConnected(System.String,System.Int32,MailKit.Security.SecureSocketOptions)">
  54786. <summary>
  54787. Raise the connected event.
  54788. </summary>
  54789. <remarks>
  54790. Raises the connected event.
  54791. </remarks>
  54792. <param name="host">The name of the host that the client connected to.</param>
  54793. <param name="port">The port that the client connected to on the remote host.</param>
  54794. <param name="options">The SSL/TLS options that were used when connecting.</param>
  54795. </member>
  54796. <member name="E:MailKit.MailService.Disconnected">
  54797. <summary>
  54798. Occurs when the client gets disconnected.
  54799. </summary>
  54800. <remarks>
  54801. The <see cref="E:MailKit.MailService.Disconnected"/> event is raised whenever the client
  54802. gets disconnected.
  54803. </remarks>
  54804. </member>
  54805. <member name="M:MailKit.MailService.OnDisconnected(System.String,System.Int32,MailKit.Security.SecureSocketOptions,System.Boolean)">
  54806. <summary>
  54807. Raise the disconnected event.
  54808. </summary>
  54809. <remarks>
  54810. Raises the disconnected event.
  54811. </remarks>
  54812. <param name="host">The name of the host that the client was connected to.</param>
  54813. <param name="port">The port that the client was connected to on the remote host.</param>
  54814. <param name="options">The SSL/TLS options that were used by the client.</param>
  54815. <param name="requested"><c>true</c> if the disconnect was explicitly requested; otherwise, <c>false</c>.</param>
  54816. </member>
  54817. <member name="E:MailKit.MailService.Authenticated">
  54818. <summary>
  54819. Occurs when the client has been successfully authenticated.
  54820. </summary>
  54821. <remarks>
  54822. The <see cref="E:MailKit.MailService.Authenticated"/> event is raised whenever the client
  54823. has been authenticated.
  54824. </remarks>
  54825. </member>
  54826. <member name="M:MailKit.MailService.OnAuthenticated(System.String)">
  54827. <summary>
  54828. Raise the authenticated event.
  54829. </summary>
  54830. <remarks>
  54831. Raises the authenticated event.
  54832. </remarks>
  54833. <param name="message">The notification sent by the server when the client successfully authenticates.</param>
  54834. </member>
  54835. <member name="M:MailKit.MailService.Dispose(System.Boolean)">
  54836. <summary>
  54837. Releases the unmanaged resources used by the <see cref="T:MailKit.MailService"/> and
  54838. optionally releases the managed resources.
  54839. </summary>
  54840. <remarks>
  54841. Releases the unmanaged resources used by the <see cref="T:MailKit.MailService"/> and
  54842. optionally releases the managed resources.
  54843. </remarks>
  54844. <param name="disposing"><c>true</c> to release both managed and unmanaged resources;
  54845. <c>false</c> to release only the unmanaged resources.</param>
  54846. </member>
  54847. <member name="M:MailKit.MailService.Dispose">
  54848. <summary>
  54849. Releases all resource used by the <see cref="T:MailKit.MailService"/> object.
  54850. </summary>
  54851. <remarks>Call <see cref="M:MailKit.MailService.Dispose"/> when you are finished using the <see cref="T:MailKit.MailService"/>. The
  54852. <see cref="M:MailKit.MailService.Dispose"/> method leaves the <see cref="T:MailKit.MailService"/> in an unusable state. After
  54853. calling <see cref="M:MailKit.MailService.Dispose"/>, you must release all references to the <see cref="T:MailKit.MailService"/> so
  54854. the garbage collector can reclaim the memory that the <see cref="T:MailKit.MailService"/> was occupying.</remarks>
  54855. </member>
  54856. <member name="T:MailKit.MailSpool">
  54857. <summary>
  54858. An abstract mail spool implementation.
  54859. </summary>
  54860. <remarks>
  54861. An abstract mail spool implementation.
  54862. </remarks>
  54863. </member>
  54864. <member name="M:MailKit.MailSpool.#ctor(MailKit.IProtocolLogger)">
  54865. <summary>
  54866. Initializes a new instance of the <see cref="T:MailKit.MailSpool"/> class.
  54867. </summary>
  54868. <remarks>
  54869. Initializes a new instance of the <see cref="T:MailKit.MailSpool"/> class.
  54870. </remarks>
  54871. <param name="protocolLogger">The protocol logger.</param>
  54872. <exception cref="T:System.ArgumentNullException">
  54873. <paramref name="protocolLogger"/> is <c>null</c>.
  54874. </exception>
  54875. </member>
  54876. <member name="P:MailKit.MailSpool.Count">
  54877. <summary>
  54878. Get the number of messages available in the message spool.
  54879. </summary>
  54880. <remarks>
  54881. <para>Gets the number of messages available in the message spool.</para>
  54882. <para>Once authenticated, the <see cref="P:MailKit.MailSpool.Count"/> property will be set
  54883. to the number of available messages in the spool.</para>
  54884. </remarks>
  54885. <example>
  54886. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadMessages"/>
  54887. </example>
  54888. <value>The message count.</value>
  54889. <exception cref="T:System.ObjectDisposedException">
  54890. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  54891. </exception>
  54892. <exception cref="T:System.InvalidOperationException">
  54893. The <see cref="T:MailKit.MailSpool"/> is not connected.
  54894. </exception>
  54895. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  54896. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  54897. </exception>
  54898. </member>
  54899. <member name="P:MailKit.MailSpool.SupportsUids">
  54900. <summary>
  54901. Get whether or not the service supports referencing messages by UIDs.
  54902. </summary>
  54903. <remarks>
  54904. <para>Not all servers support referencing messages by UID, so this property should
  54905. be checked before using <see cref="M:MailKit.MailSpool.GetMessageUid(System.Int32,System.Threading.CancellationToken)"/>
  54906. and <see cref="M:MailKit.MailSpool.GetMessageUids(System.Threading.CancellationToken)"/>.</para>
  54907. <para>If the server does not support UIDs, then all methods that take UID arguments
  54908. along with <see cref="M:MailKit.MailSpool.GetMessageUid(System.Int32,System.Threading.CancellationToken)"/> and
  54909. <see cref="M:MailKit.MailSpool.GetMessageUids(System.Threading.CancellationToken)"/> will fail.</para>
  54910. </remarks>
  54911. <value><c>true</c> if supports uids; otherwise, <c>false</c>.</value>
  54912. <exception cref="T:System.ObjectDisposedException">
  54913. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  54914. </exception>
  54915. <exception cref="T:System.InvalidOperationException">
  54916. The <see cref="T:MailKit.MailSpool"/> is not connected.
  54917. </exception>
  54918. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  54919. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  54920. </exception>
  54921. </member>
  54922. <member name="M:MailKit.MailSpool.GetMessageCount(System.Threading.CancellationToken)">
  54923. <summary>
  54924. Get the message count.
  54925. </summary>
  54926. <remarks>
  54927. Gets the message count.
  54928. </remarks>
  54929. <returns>The message count.</returns>
  54930. <param name="cancellationToken">The cancellation token.</param>
  54931. <exception cref="T:System.ObjectDisposedException">
  54932. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  54933. </exception>
  54934. <exception cref="T:MailKit.ServiceNotConnectedException">
  54935. The <see cref="T:MailKit.MailSpool"/> is not connected.
  54936. </exception>
  54937. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  54938. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  54939. </exception>
  54940. <exception cref="T:System.OperationCanceledException">
  54941. The operation was canceled via the cancellation token.
  54942. </exception>
  54943. <exception cref="T:System.IO.IOException">
  54944. An I/O error occurred.
  54945. </exception>
  54946. <exception cref="T:MailKit.CommandException">
  54947. The command failed.
  54948. </exception>
  54949. <exception cref="T:MailKit.ProtocolException">
  54950. A protocol error occurred.
  54951. </exception>
  54952. </member>
  54953. <member name="M:MailKit.MailSpool.GetMessageCountAsync(System.Threading.CancellationToken)">
  54954. <summary>
  54955. Asynchronously get the message count.
  54956. </summary>
  54957. <remarks>
  54958. Asynchronously gets the message count.
  54959. </remarks>
  54960. <returns>The message count.</returns>
  54961. <param name="cancellationToken">The cancellation token.</param>
  54962. <exception cref="T:System.ObjectDisposedException">
  54963. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  54964. </exception>
  54965. <exception cref="T:MailKit.ServiceNotConnectedException">
  54966. The <see cref="T:MailKit.MailSpool"/> is not connected.
  54967. </exception>
  54968. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  54969. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  54970. </exception>
  54971. <exception cref="T:System.OperationCanceledException">
  54972. The operation was canceled via the cancellation token.
  54973. </exception>
  54974. <exception cref="T:System.IO.IOException">
  54975. An I/O error occurred.
  54976. </exception>
  54977. <exception cref="T:MailKit.CommandException">
  54978. The command failed.
  54979. </exception>
  54980. <exception cref="T:MailKit.ProtocolException">
  54981. A protocol error occurred.
  54982. </exception>
  54983. </member>
  54984. <member name="M:MailKit.MailSpool.GetMessageUid(System.Int32,System.Threading.CancellationToken)">
  54985. <summary>
  54986. Get the UID of the message at the specified index.
  54987. </summary>
  54988. <remarks>
  54989. Not all servers support UIDs, so you should first check
  54990. the <see cref="P:MailKit.MailSpool.SupportsUids"/> property.
  54991. </remarks>
  54992. <returns>The message UID.</returns>
  54993. <param name="index">The message index.</param>
  54994. <param name="cancellationToken">The cancellation token.</param>
  54995. <exception cref="T:System.ArgumentOutOfRangeException">
  54996. <paramref name="index"/> is not a valid message index.
  54997. </exception>
  54998. <exception cref="T:System.ObjectDisposedException">
  54999. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55000. </exception>
  55001. <exception cref="T:MailKit.ServiceNotConnectedException">
  55002. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55003. </exception>
  55004. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55005. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55006. </exception>
  55007. <exception cref="T:System.NotSupportedException">
  55008. The mail spool does not support UIDs.
  55009. </exception>
  55010. <exception cref="T:System.OperationCanceledException">
  55011. The operation was canceled via the cancellation token.
  55012. </exception>
  55013. <exception cref="T:System.IO.IOException">
  55014. An I/O error occurred.
  55015. </exception>
  55016. <exception cref="T:MailKit.CommandException">
  55017. The command failed.
  55018. </exception>
  55019. <exception cref="T:MailKit.ProtocolException">
  55020. A protocol error occurred.
  55021. </exception>
  55022. </member>
  55023. <member name="M:MailKit.MailSpool.GetMessageUidAsync(System.Int32,System.Threading.CancellationToken)">
  55024. <summary>
  55025. Asynchronously get the UID of the message at the specified index.
  55026. </summary>
  55027. <remarks>
  55028. Not all servers support UIDs, so you should first check
  55029. the <see cref="P:MailKit.MailSpool.SupportsUids"/> property.
  55030. </remarks>
  55031. <returns>The message UID.</returns>
  55032. <param name="index">The message index.</param>
  55033. <param name="cancellationToken">The cancellation token.</param>
  55034. <exception cref="T:System.ArgumentOutOfRangeException">
  55035. <paramref name="index"/> is not a valid message index.
  55036. </exception>
  55037. <exception cref="T:System.ObjectDisposedException">
  55038. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55039. </exception>
  55040. <exception cref="T:MailKit.ServiceNotConnectedException">
  55041. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55042. </exception>
  55043. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55044. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55045. </exception>
  55046. <exception cref="T:System.NotSupportedException">
  55047. The mail spool does not support UIDs.
  55048. </exception>
  55049. <exception cref="T:System.OperationCanceledException">
  55050. The operation was canceled via the cancellation token.
  55051. </exception>
  55052. <exception cref="T:System.IO.IOException">
  55053. An I/O error occurred.
  55054. </exception>
  55055. <exception cref="T:MailKit.CommandException">
  55056. The command failed.
  55057. </exception>
  55058. <exception cref="T:MailKit.ProtocolException">
  55059. A protocol error occurred.
  55060. </exception>
  55061. </member>
  55062. <member name="M:MailKit.MailSpool.GetMessageUids(System.Threading.CancellationToken)">
  55063. <summary>
  55064. Get the full list of available message UIDs.
  55065. </summary>
  55066. <remarks>
  55067. Not all servers support UIDs, so you should first check
  55068. the <see cref="P:MailKit.MailSpool.SupportsUids"/> property.
  55069. </remarks>
  55070. <example>
  55071. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadNewMessages"/>
  55072. </example>
  55073. <returns>The message uids.</returns>
  55074. <param name="cancellationToken">The cancellation token.</param>
  55075. <exception cref="T:System.ObjectDisposedException">
  55076. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55077. </exception>
  55078. <exception cref="T:MailKit.ServiceNotConnectedException">
  55079. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55080. </exception>
  55081. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55082. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55083. </exception>
  55084. <exception cref="T:System.NotSupportedException">
  55085. The mail spool does not support UIDs.
  55086. </exception>
  55087. <exception cref="T:System.OperationCanceledException">
  55088. The operation was canceled via the cancellation token.
  55089. </exception>
  55090. <exception cref="T:System.IO.IOException">
  55091. An I/O error occurred.
  55092. </exception>
  55093. <exception cref="T:MailKit.CommandException">
  55094. The command failed.
  55095. </exception>
  55096. <exception cref="T:MailKit.ProtocolException">
  55097. A protocol error occurred.
  55098. </exception>
  55099. </member>
  55100. <member name="M:MailKit.MailSpool.GetMessageUidsAsync(System.Threading.CancellationToken)">
  55101. <summary>
  55102. Get the full list of available message UIDs.
  55103. </summary>
  55104. <remarks>
  55105. Not all servers support UIDs, so you should first check
  55106. the <see cref="P:MailKit.MailSpool.SupportsUids"/> property.
  55107. </remarks>
  55108. <returns>The message uids.</returns>
  55109. <param name="cancellationToken">The cancellation token.</param>
  55110. <exception cref="T:System.ObjectDisposedException">
  55111. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55112. </exception>
  55113. <exception cref="T:MailKit.ServiceNotConnectedException">
  55114. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55115. </exception>
  55116. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55117. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55118. </exception>
  55119. <exception cref="T:System.NotSupportedException">
  55120. The mail spool does not support UIDs.
  55121. </exception>
  55122. <exception cref="T:System.OperationCanceledException">
  55123. The operation was canceled via the cancellation token.
  55124. </exception>
  55125. <exception cref="T:System.IO.IOException">
  55126. An I/O error occurred.
  55127. </exception>
  55128. <exception cref="T:MailKit.CommandException">
  55129. The command failed.
  55130. </exception>
  55131. <exception cref="T:MailKit.ProtocolException">
  55132. A protocol error occurred.
  55133. </exception>
  55134. </member>
  55135. <member name="M:MailKit.MailSpool.GetMessageSize(System.Int32,System.Threading.CancellationToken)">
  55136. <summary>
  55137. Get the size of the specified message, in bytes.
  55138. </summary>
  55139. <remarks>
  55140. Gets the size of the specified message, in bytes.
  55141. </remarks>
  55142. <returns>The message size, in bytes.</returns>
  55143. <param name="index">The index of the message.</param>
  55144. <param name="cancellationToken">The cancellation token.</param>
  55145. <exception cref="T:System.ArgumentOutOfRangeException">
  55146. <paramref name="index"/> is not a valid message index.
  55147. </exception>
  55148. <exception cref="T:System.ObjectDisposedException">
  55149. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55150. </exception>
  55151. <exception cref="T:MailKit.ServiceNotConnectedException">
  55152. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55153. </exception>
  55154. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55155. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55156. </exception>
  55157. <exception cref="T:System.OperationCanceledException">
  55158. The operation was canceled via the cancellation token.
  55159. </exception>
  55160. <exception cref="T:System.IO.IOException">
  55161. An I/O error occurred.
  55162. </exception>
  55163. <exception cref="T:MailKit.CommandException">
  55164. The command failed.
  55165. </exception>
  55166. <exception cref="T:MailKit.ProtocolException">
  55167. A protocol error occurred.
  55168. </exception>
  55169. </member>
  55170. <member name="M:MailKit.MailSpool.GetMessageSizeAsync(System.Int32,System.Threading.CancellationToken)">
  55171. <summary>
  55172. Asynchronously get the size of the specified message, in bytes.
  55173. </summary>
  55174. <remarks>
  55175. Asynchronously gets the size of the specified message, in bytes.
  55176. </remarks>
  55177. <returns>The message size, in bytes.</returns>
  55178. <param name="index">The index of the message.</param>
  55179. <param name="cancellationToken">The cancellation token.</param>
  55180. <exception cref="T:System.ArgumentOutOfRangeException">
  55181. <paramref name="index"/> is not a valid message index.
  55182. </exception>
  55183. <exception cref="T:System.ObjectDisposedException">
  55184. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55185. </exception>
  55186. <exception cref="T:MailKit.ServiceNotConnectedException">
  55187. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55188. </exception>
  55189. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55190. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55191. </exception>
  55192. <exception cref="T:System.OperationCanceledException">
  55193. The operation was canceled via the cancellation token.
  55194. </exception>
  55195. <exception cref="T:System.IO.IOException">
  55196. An I/O error occurred.
  55197. </exception>
  55198. <exception cref="T:MailKit.CommandException">
  55199. The command failed.
  55200. </exception>
  55201. <exception cref="T:MailKit.ProtocolException">
  55202. A protocol error occurred.
  55203. </exception>
  55204. </member>
  55205. <member name="M:MailKit.MailSpool.GetMessageSizes(System.Threading.CancellationToken)">
  55206. <summary>
  55207. Get the sizes for all available messages, in bytes.
  55208. </summary>
  55209. <remarks>
  55210. Gets the sizes for all available messages, in bytes.
  55211. </remarks>
  55212. <returns>The message sizes, in bytes.</returns>
  55213. <param name="cancellationToken">The cancellation token.</param>
  55214. <exception cref="T:System.ObjectDisposedException">
  55215. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55216. </exception>
  55217. <exception cref="T:MailKit.ServiceNotConnectedException">
  55218. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55219. </exception>
  55220. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55221. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55222. </exception>
  55223. <exception cref="T:System.OperationCanceledException">
  55224. The operation was canceled via the cancellation token.
  55225. </exception>
  55226. <exception cref="T:System.IO.IOException">
  55227. An I/O error occurred.
  55228. </exception>
  55229. <exception cref="T:MailKit.CommandException">
  55230. The command failed.
  55231. </exception>
  55232. <exception cref="T:MailKit.ProtocolException">
  55233. A protocol error occurred.
  55234. </exception>
  55235. </member>
  55236. <member name="M:MailKit.MailSpool.GetMessageSizesAsync(System.Threading.CancellationToken)">
  55237. <summary>
  55238. Asynchronously get the sizes for all available messages, in bytes.
  55239. </summary>
  55240. <remarks>
  55241. Asynchronously gets the sizes for all available messages, in bytes.
  55242. </remarks>
  55243. <returns>The message sizes, in bytes.</returns>
  55244. <param name="cancellationToken">The cancellation token.</param>
  55245. <exception cref="T:System.ObjectDisposedException">
  55246. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55247. </exception>
  55248. <exception cref="T:MailKit.ServiceNotConnectedException">
  55249. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55250. </exception>
  55251. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55252. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55253. </exception>
  55254. <exception cref="T:System.OperationCanceledException">
  55255. The operation was canceled via the cancellation token.
  55256. </exception>
  55257. <exception cref="T:System.IO.IOException">
  55258. An I/O error occurred.
  55259. </exception>
  55260. <exception cref="T:MailKit.CommandException">
  55261. The command failed.
  55262. </exception>
  55263. <exception cref="T:MailKit.ProtocolException">
  55264. A protocol error occurred.
  55265. </exception>
  55266. </member>
  55267. <member name="M:MailKit.MailSpool.GetMessageHeaders(System.Int32,System.Threading.CancellationToken)">
  55268. <summary>
  55269. Get the headers for the specified message.
  55270. </summary>
  55271. <remarks>
  55272. Gets the headers for the specified message.
  55273. </remarks>
  55274. <returns>The message headers.</returns>
  55275. <param name="index">The index of the message.</param>
  55276. <param name="cancellationToken">The cancellation token.</param>
  55277. <exception cref="T:System.ArgumentOutOfRangeException">
  55278. <paramref name="index"/> is not a valid message index.
  55279. </exception>
  55280. <exception cref="T:System.ObjectDisposedException">
  55281. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55282. </exception>
  55283. <exception cref="T:MailKit.ServiceNotConnectedException">
  55284. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55285. </exception>
  55286. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55287. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55288. </exception>
  55289. <exception cref="T:System.OperationCanceledException">
  55290. The operation was canceled via the cancellation token.
  55291. </exception>
  55292. <exception cref="T:System.IO.IOException">
  55293. An I/O error occurred.
  55294. </exception>
  55295. <exception cref="T:MailKit.CommandException">
  55296. The command failed.
  55297. </exception>
  55298. <exception cref="T:MailKit.ProtocolException">
  55299. A protocol error occurred.
  55300. </exception>
  55301. </member>
  55302. <member name="M:MailKit.MailSpool.GetMessageHeadersAsync(System.Int32,System.Threading.CancellationToken)">
  55303. <summary>
  55304. Asynchronously get the headers for the specified message.
  55305. </summary>
  55306. <remarks>
  55307. Asynchronously gets the headers for the specified message.
  55308. </remarks>
  55309. <returns>The message headers.</returns>
  55310. <param name="index">The index of the message.</param>
  55311. <param name="cancellationToken">The cancellation token.</param>
  55312. <exception cref="T:System.ArgumentOutOfRangeException">
  55313. <paramref name="index"/> is not a valid message index.
  55314. </exception>
  55315. <exception cref="T:System.ObjectDisposedException">
  55316. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55317. </exception>
  55318. <exception cref="T:MailKit.ServiceNotConnectedException">
  55319. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55320. </exception>
  55321. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55322. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55323. </exception>
  55324. <exception cref="T:System.OperationCanceledException">
  55325. The operation was canceled via the cancellation token.
  55326. </exception>
  55327. <exception cref="T:System.IO.IOException">
  55328. An I/O error occurred.
  55329. </exception>
  55330. <exception cref="T:MailKit.CommandException">
  55331. The command failed.
  55332. </exception>
  55333. <exception cref="T:MailKit.ProtocolException">
  55334. A protocol error occurred.
  55335. </exception>
  55336. </member>
  55337. <member name="M:MailKit.MailSpool.GetMessageHeaders(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken)">
  55338. <summary>
  55339. Get the headers for the specified messages.
  55340. </summary>
  55341. <remarks>
  55342. Gets the headers for the specified messages.
  55343. </remarks>
  55344. <returns>The headers for the specified messages.</returns>
  55345. <param name="indexes">The indexes of the messages.</param>
  55346. <param name="cancellationToken">The cancellation token.</param>
  55347. <exception cref="T:System.ArgumentNullException">
  55348. <paramref name="indexes"/> is <c>null</c>.
  55349. </exception>
  55350. <exception cref="T:System.ArgumentException">
  55351. <para>One or more of the <paramref name="indexes"/> are invalid.</para>
  55352. <para>-or-</para>
  55353. <para>No indexes were specified.</para>
  55354. </exception>
  55355. <exception cref="T:System.ObjectDisposedException">
  55356. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55357. </exception>
  55358. <exception cref="T:MailKit.ServiceNotConnectedException">
  55359. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55360. </exception>
  55361. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55362. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55363. </exception>
  55364. <exception cref="T:System.OperationCanceledException">
  55365. The operation was canceled via the cancellation token.
  55366. </exception>
  55367. <exception cref="T:System.IO.IOException">
  55368. An I/O error occurred.
  55369. </exception>
  55370. <exception cref="T:MailKit.CommandException">
  55371. The command failed.
  55372. </exception>
  55373. <exception cref="T:MailKit.ProtocolException">
  55374. A protocol error occurred.
  55375. </exception>
  55376. </member>
  55377. <member name="M:MailKit.MailSpool.GetMessageHeadersAsync(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken)">
  55378. <summary>
  55379. Asynchronously get the headers for the specified messages.
  55380. </summary>
  55381. <remarks>
  55382. Asynchronously gets the headers for the specified messages.
  55383. </remarks>
  55384. <returns>The headers for the specified messages.</returns>
  55385. <param name="indexes">The indexes of the messages.</param>
  55386. <param name="cancellationToken">The cancellation token.</param>
  55387. <exception cref="T:System.ArgumentNullException">
  55388. <paramref name="indexes"/> is <c>null</c>.
  55389. </exception>
  55390. <exception cref="T:System.ArgumentException">
  55391. <para>One or more of the <paramref name="indexes"/> are invalid.</para>
  55392. <para>-or-</para>
  55393. <para>No indexes were specified.</para>
  55394. </exception>
  55395. <exception cref="T:System.ObjectDisposedException">
  55396. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55397. </exception>
  55398. <exception cref="T:MailKit.ServiceNotConnectedException">
  55399. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55400. </exception>
  55401. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55402. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55403. </exception>
  55404. <exception cref="T:System.OperationCanceledException">
  55405. The operation was canceled via the cancellation token.
  55406. </exception>
  55407. <exception cref="T:System.IO.IOException">
  55408. An I/O error occurred.
  55409. </exception>
  55410. <exception cref="T:MailKit.CommandException">
  55411. The command failed.
  55412. </exception>
  55413. <exception cref="T:MailKit.ProtocolException">
  55414. A protocol error occurred.
  55415. </exception>
  55416. </member>
  55417. <member name="M:MailKit.MailSpool.GetMessageHeaders(System.Int32,System.Int32,System.Threading.CancellationToken)">
  55418. <summary>
  55419. Get the headers of the messages within the specified range.
  55420. </summary>
  55421. <remarks>
  55422. Gets the headers of the messages within the specified range.
  55423. </remarks>
  55424. <returns>The headers of the messages within the specified range.</returns>
  55425. <param name="startIndex">The index of the first message to get.</param>
  55426. <param name="count">The number of messages to get.</param>
  55427. <param name="cancellationToken">The cancellation token.</param>
  55428. <exception cref="T:System.ArgumentOutOfRangeException">
  55429. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  55430. a valid range of messages.
  55431. </exception>
  55432. <exception cref="T:System.ObjectDisposedException">
  55433. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55434. </exception>
  55435. <exception cref="T:MailKit.ServiceNotConnectedException">
  55436. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55437. </exception>
  55438. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55439. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55440. </exception>
  55441. <exception cref="T:System.OperationCanceledException">
  55442. The operation was canceled via the cancellation token.
  55443. </exception>
  55444. <exception cref="T:System.IO.IOException">
  55445. An I/O error occurred.
  55446. </exception>
  55447. <exception cref="T:MailKit.CommandException">
  55448. The command failed.
  55449. </exception>
  55450. <exception cref="T:MailKit.ProtocolException">
  55451. A protocol error occurred.
  55452. </exception>
  55453. </member>
  55454. <member name="M:MailKit.MailSpool.GetMessageHeadersAsync(System.Int32,System.Int32,System.Threading.CancellationToken)">
  55455. <summary>
  55456. Get the headers of the messages within the specified range.
  55457. </summary>
  55458. <remarks>
  55459. Gets the headers of the messages within the specified range.
  55460. </remarks>
  55461. <returns>The headers of the messages within the specified range.</returns>
  55462. <param name="startIndex">The index of the first message to get.</param>
  55463. <param name="count">The number of messages to get.</param>
  55464. <param name="cancellationToken">The cancellation token.</param>
  55465. <exception cref="T:System.ArgumentOutOfRangeException">
  55466. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  55467. a valid range of messages.
  55468. </exception>
  55469. <exception cref="T:System.ObjectDisposedException">
  55470. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55471. </exception>
  55472. <exception cref="T:MailKit.ServiceNotConnectedException">
  55473. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55474. </exception>
  55475. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55476. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55477. </exception>
  55478. <exception cref="T:System.OperationCanceledException">
  55479. The operation was canceled via the cancellation token.
  55480. </exception>
  55481. <exception cref="T:System.IO.IOException">
  55482. An I/O error occurred.
  55483. </exception>
  55484. <exception cref="T:MailKit.CommandException">
  55485. The command failed.
  55486. </exception>
  55487. <exception cref="T:MailKit.ProtocolException">
  55488. A protocol error occurred.
  55489. </exception>
  55490. </member>
  55491. <member name="M:MailKit.MailSpool.GetMessage(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  55492. <summary>
  55493. Get the message at the specified index.
  55494. </summary>
  55495. <remarks>
  55496. Gets the message at the specified index.
  55497. </remarks>
  55498. <example>
  55499. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadMessages"/>
  55500. </example>
  55501. <returns>The message.</returns>
  55502. <param name="index">The index of the message.</param>
  55503. <param name="cancellationToken">The cancellation token.</param>
  55504. <param name="progress">The progress reporting mechanism.</param>
  55505. <exception cref="T:System.ArgumentOutOfRangeException">
  55506. <paramref name="index"/> is not a valid message index.
  55507. </exception>
  55508. <exception cref="T:System.ObjectDisposedException">
  55509. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55510. </exception>
  55511. <exception cref="T:MailKit.ServiceNotConnectedException">
  55512. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55513. </exception>
  55514. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55515. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55516. </exception>
  55517. <exception cref="T:System.OperationCanceledException">
  55518. The operation was canceled via the cancellation token.
  55519. </exception>
  55520. <exception cref="T:System.IO.IOException">
  55521. An I/O error occurred.
  55522. </exception>
  55523. <exception cref="T:MailKit.CommandException">
  55524. The command failed.
  55525. </exception>
  55526. <exception cref="T:MailKit.ProtocolException">
  55527. A protocol error occurred.
  55528. </exception>
  55529. </member>
  55530. <member name="M:MailKit.MailSpool.GetMessageAsync(System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  55531. <summary>
  55532. Asynchronously get the message at the specified index.
  55533. </summary>
  55534. <remarks>
  55535. Asynchronously gets the message at the specified index.
  55536. </remarks>
  55537. <returns>The message.</returns>
  55538. <param name="index">The index of the message.</param>
  55539. <param name="cancellationToken">The cancellation token.</param>
  55540. <param name="progress">The progress reporting mechanism.</param>
  55541. <exception cref="T:System.ArgumentOutOfRangeException">
  55542. <paramref name="index"/> is not a valid message index.
  55543. </exception>
  55544. <exception cref="T:System.ObjectDisposedException">
  55545. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55546. </exception>
  55547. <exception cref="T:MailKit.ServiceNotConnectedException">
  55548. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55549. </exception>
  55550. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55551. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55552. </exception>
  55553. <exception cref="T:System.OperationCanceledException">
  55554. The operation was canceled via the cancellation token.
  55555. </exception>
  55556. <exception cref="T:System.IO.IOException">
  55557. An I/O error occurred.
  55558. </exception>
  55559. <exception cref="T:MailKit.CommandException">
  55560. The command failed.
  55561. </exception>
  55562. <exception cref="T:MailKit.ProtocolException">
  55563. A protocol error occurred.
  55564. </exception>
  55565. </member>
  55566. <member name="M:MailKit.MailSpool.GetMessages(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  55567. <summary>
  55568. Get the messages at the specified indexes.
  55569. </summary>
  55570. <remarks>
  55571. Get the messages at the specified indexes.
  55572. </remarks>
  55573. <returns>The messages.</returns>
  55574. <param name="indexes">The indexes of the messages.</param>
  55575. <param name="cancellationToken">The cancellation token.</param>
  55576. <param name="progress">The progress reporting mechanism.</param>
  55577. <exception cref="T:System.ArgumentNullException">
  55578. <paramref name="indexes"/> is <c>null</c>.
  55579. </exception>
  55580. <exception cref="T:System.ArgumentException">
  55581. <para>One or more of the <paramref name="indexes"/> are invalid.</para>
  55582. <para>-or-</para>
  55583. <para>No indexes were specified.</para>
  55584. </exception>
  55585. <exception cref="T:System.ObjectDisposedException">
  55586. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55587. </exception>
  55588. <exception cref="T:MailKit.ServiceNotConnectedException">
  55589. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55590. </exception>
  55591. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55592. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55593. </exception>
  55594. <exception cref="T:System.OperationCanceledException">
  55595. The operation was canceled via the cancellation token.
  55596. </exception>
  55597. <exception cref="T:System.IO.IOException">
  55598. An I/O error occurred.
  55599. </exception>
  55600. <exception cref="T:MailKit.CommandException">
  55601. The command failed.
  55602. </exception>
  55603. <exception cref="T:MailKit.ProtocolException">
  55604. A protocol error occurred.
  55605. </exception>
  55606. </member>
  55607. <member name="M:MailKit.MailSpool.GetMessagesAsync(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  55608. <summary>
  55609. Asynchronously get the messages at the specified indexes.
  55610. </summary>
  55611. <remarks>
  55612. Asynchronously get the messages at the specified indexes.
  55613. </remarks>
  55614. <returns>The messages.</returns>
  55615. <param name="indexes">The indexes of the messages.</param>
  55616. <param name="cancellationToken">The cancellation token.</param>
  55617. <param name="progress">The progress reporting mechanism.</param>
  55618. <exception cref="T:System.ArgumentNullException">
  55619. <paramref name="indexes"/> is <c>null</c>.
  55620. </exception>
  55621. <exception cref="T:System.ArgumentException">
  55622. <para>One or more of the <paramref name="indexes"/> are invalid.</para>
  55623. <para>-or-</para>
  55624. <para>No indexes were specified.</para>
  55625. </exception>
  55626. <exception cref="T:System.ObjectDisposedException">
  55627. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55628. </exception>
  55629. <exception cref="T:MailKit.ServiceNotConnectedException">
  55630. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55631. </exception>
  55632. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55633. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55634. </exception>
  55635. <exception cref="T:System.OperationCanceledException">
  55636. The operation was canceled via the cancellation token.
  55637. </exception>
  55638. <exception cref="T:System.IO.IOException">
  55639. An I/O error occurred.
  55640. </exception>
  55641. <exception cref="T:MailKit.CommandException">
  55642. The command failed.
  55643. </exception>
  55644. <exception cref="T:MailKit.ProtocolException">
  55645. A protocol error occurred.
  55646. </exception>
  55647. </member>
  55648. <member name="M:MailKit.MailSpool.GetMessages(System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  55649. <summary>
  55650. Get the messages within the specified range.
  55651. </summary>
  55652. <remarks>
  55653. Gets the messages within the specified range.
  55654. </remarks>
  55655. <example>
  55656. <code language="c#" source="Examples\Pop3Examples.cs" region="BatchDownloadMessages"/>
  55657. </example>
  55658. <returns>The messages.</returns>
  55659. <param name="startIndex">The index of the first message to get.</param>
  55660. <param name="count">The number of messages to get.</param>
  55661. <param name="cancellationToken">The cancellation token.</param>
  55662. <param name="progress">The progress reporting mechanism.</param>
  55663. <exception cref="T:System.ArgumentOutOfRangeException">
  55664. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  55665. a valid range of messages.
  55666. </exception>
  55667. <exception cref="T:System.ObjectDisposedException">
  55668. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55669. </exception>
  55670. <exception cref="T:MailKit.ServiceNotConnectedException">
  55671. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55672. </exception>
  55673. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55674. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55675. </exception>
  55676. <exception cref="T:System.OperationCanceledException">
  55677. The operation was canceled via the cancellation token.
  55678. </exception>
  55679. <exception cref="T:System.IO.IOException">
  55680. An I/O error occurred.
  55681. </exception>
  55682. <exception cref="T:MailKit.CommandException">
  55683. The command failed.
  55684. </exception>
  55685. <exception cref="T:MailKit.ProtocolException">
  55686. A protocol error occurred.
  55687. </exception>
  55688. </member>
  55689. <member name="M:MailKit.MailSpool.GetMessagesAsync(System.Int32,System.Int32,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  55690. <summary>
  55691. Asynchronously get the messages within the specified range.
  55692. </summary>
  55693. <remarks>
  55694. Asynchronously gets the messages within the specified range.
  55695. </remarks>
  55696. <returns>The messages.</returns>
  55697. <param name="startIndex">The index of the first message to get.</param>
  55698. <param name="count">The number of messages to get.</param>
  55699. <param name="cancellationToken">The cancellation token.</param>
  55700. <param name="progress">The progress reporting mechanism.</param>
  55701. <exception cref="T:System.ArgumentOutOfRangeException">
  55702. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  55703. a valid range of messages.
  55704. </exception>
  55705. <exception cref="T:System.ObjectDisposedException">
  55706. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55707. </exception>
  55708. <exception cref="T:MailKit.ServiceNotConnectedException">
  55709. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55710. </exception>
  55711. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55712. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55713. </exception>
  55714. <exception cref="T:System.OperationCanceledException">
  55715. The operation was canceled via the cancellation token.
  55716. </exception>
  55717. <exception cref="T:System.IO.IOException">
  55718. An I/O error occurred.
  55719. </exception>
  55720. <exception cref="T:MailKit.CommandException">
  55721. The command failed.
  55722. </exception>
  55723. <exception cref="T:MailKit.ProtocolException">
  55724. A protocol error occurred.
  55725. </exception>
  55726. </member>
  55727. <member name="M:MailKit.MailSpool.GetStream(System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  55728. <summary>
  55729. Get the message or header stream at the specified index.
  55730. </summary>
  55731. <remarks>
  55732. Gets the message or header stream at the specified index.
  55733. </remarks>
  55734. <returns>The message or header stream.</returns>
  55735. <param name="index">The index of the message.</param>
  55736. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  55737. <param name="cancellationToken">The cancellation token.</param>
  55738. <param name="progress">The progress reporting mechanism.</param>
  55739. <exception cref="T:System.ArgumentOutOfRangeException">
  55740. <paramref name="index"/> is not a valid message index.
  55741. </exception>
  55742. <exception cref="T:System.ObjectDisposedException">
  55743. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55744. </exception>
  55745. <exception cref="T:MailKit.ServiceNotConnectedException">
  55746. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55747. </exception>
  55748. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55749. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55750. </exception>
  55751. <exception cref="T:System.OperationCanceledException">
  55752. The operation was canceled via the cancellation token.
  55753. </exception>
  55754. <exception cref="T:System.IO.IOException">
  55755. An I/O error occurred.
  55756. </exception>
  55757. <exception cref="T:MailKit.CommandException">
  55758. The command failed.
  55759. </exception>
  55760. <exception cref="T:MailKit.ProtocolException">
  55761. A protocol error occurred.
  55762. </exception>
  55763. </member>
  55764. <member name="M:MailKit.MailSpool.GetStreamAsync(System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  55765. <summary>
  55766. Asynchronously get the message or header stream at the specified index.
  55767. </summary>
  55768. <remarks>
  55769. Asynchronously gets the message or header stream at the specified index.
  55770. </remarks>
  55771. <returns>The message or header stream.</returns>
  55772. <param name="index">The index of the message.</param>
  55773. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  55774. <param name="cancellationToken">The cancellation token.</param>
  55775. <param name="progress">The progress reporting mechanism.</param>
  55776. <exception cref="T:System.ArgumentOutOfRangeException">
  55777. <paramref name="index"/> is not a valid message index.
  55778. </exception>
  55779. <exception cref="T:System.ObjectDisposedException">
  55780. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55781. </exception>
  55782. <exception cref="T:MailKit.ServiceNotConnectedException">
  55783. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55784. </exception>
  55785. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55786. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55787. </exception>
  55788. <exception cref="T:System.OperationCanceledException">
  55789. The operation was canceled via the cancellation token.
  55790. </exception>
  55791. <exception cref="T:System.IO.IOException">
  55792. An I/O error occurred.
  55793. </exception>
  55794. <exception cref="T:MailKit.CommandException">
  55795. The command failed.
  55796. </exception>
  55797. <exception cref="T:MailKit.ProtocolException">
  55798. A protocol error occurred.
  55799. </exception>
  55800. </member>
  55801. <member name="M:MailKit.MailSpool.GetStreams(System.Collections.Generic.IList{System.Int32},System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  55802. <summary>
  55803. Get the message or header streams at the specified indexes.
  55804. </summary>
  55805. <remarks>
  55806. <para>Get the message or header streams at the specified indexes.</para>
  55807. <para>If the mail server supports pipelining, this method will likely be more
  55808. efficient than using <see cref="M:MailKit.MailSpool.GetStream(System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)"/> for
  55809. each message because it will batch the commands to reduce latency.</para>
  55810. </remarks>
  55811. <returns>The message or header streams.</returns>
  55812. <param name="indexes">The indexes of the messages.</param>
  55813. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  55814. <param name="cancellationToken">The cancellation token.</param>
  55815. <param name="progress">The progress reporting mechanism.</param>
  55816. <exception cref="T:System.ArgumentNullException">
  55817. <paramref name="indexes"/> is <c>null</c>.
  55818. </exception>
  55819. <exception cref="T:System.ArgumentException">
  55820. <para>One or more of the <paramref name="indexes"/> are invalid.</para>
  55821. <para>-or-</para>
  55822. <para>No indexes were specified.</para>
  55823. </exception>
  55824. <exception cref="T:System.ObjectDisposedException">
  55825. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55826. </exception>
  55827. <exception cref="T:MailKit.ServiceNotConnectedException">
  55828. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55829. </exception>
  55830. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55831. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55832. </exception>
  55833. <exception cref="T:System.OperationCanceledException">
  55834. The operation was canceled via the cancellation token.
  55835. </exception>
  55836. <exception cref="T:System.IO.IOException">
  55837. An I/O error occurred.
  55838. </exception>
  55839. <exception cref="T:MailKit.CommandException">
  55840. The command failed.
  55841. </exception>
  55842. <exception cref="T:MailKit.ProtocolException">
  55843. A protocol error occurred.
  55844. </exception>
  55845. </member>
  55846. <member name="M:MailKit.MailSpool.GetStreamsAsync(System.Collections.Generic.IList{System.Int32},System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  55847. <summary>
  55848. Asynchronously get the message or header streams at the specified indexes.
  55849. </summary>
  55850. <remarks>
  55851. Asynchronously get the message or header streams at the specified indexes.
  55852. </remarks>
  55853. <returns>The messages.</returns>
  55854. <param name="indexes">The indexes of the messages.</param>
  55855. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  55856. <param name="cancellationToken">The cancellation token.</param>
  55857. <param name="progress">The progress reporting mechanism.</param>
  55858. <exception cref="T:System.ArgumentNullException">
  55859. <paramref name="indexes"/> is <c>null</c>.
  55860. </exception>
  55861. <exception cref="T:System.ArgumentException">
  55862. <para>One or more of the <paramref name="indexes"/> are invalid.</para>
  55863. <para>-or-</para>
  55864. <para>No indexes were specified.</para>
  55865. </exception>
  55866. <exception cref="T:System.ObjectDisposedException">
  55867. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55868. </exception>
  55869. <exception cref="T:MailKit.ServiceNotConnectedException">
  55870. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55871. </exception>
  55872. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55873. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55874. </exception>
  55875. <exception cref="T:System.OperationCanceledException">
  55876. The operation was canceled via the cancellation token.
  55877. </exception>
  55878. <exception cref="T:System.IO.IOException">
  55879. An I/O error occurred.
  55880. </exception>
  55881. <exception cref="T:MailKit.CommandException">
  55882. The command failed.
  55883. </exception>
  55884. <exception cref="T:MailKit.ProtocolException">
  55885. A protocol error occurred.
  55886. </exception>
  55887. </member>
  55888. <member name="M:MailKit.MailSpool.GetStreams(System.Int32,System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  55889. <summary>
  55890. Get the message or header streams within the specified range.
  55891. </summary>
  55892. <remarks>
  55893. <para>Gets the message or header streams within the specified range.</para>
  55894. <para>If the mail server supports pipelining, this method will likely be more
  55895. efficient than using <see cref="M:MailKit.MailSpool.GetStream(System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)"/> for
  55896. each message because it will batch the commands to reduce latency.</para>
  55897. </remarks>
  55898. <returns>The message or header streams.</returns>
  55899. <param name="startIndex">The index of the first stream to get.</param>
  55900. <param name="count">The number of streams to get.</param>
  55901. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  55902. <param name="cancellationToken">The cancellation token.</param>
  55903. <param name="progress">The progress reporting mechanism.</param>
  55904. <exception cref="T:System.ArgumentOutOfRangeException">
  55905. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  55906. a valid range of messages.
  55907. </exception>
  55908. <exception cref="T:System.ObjectDisposedException">
  55909. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55910. </exception>
  55911. <exception cref="T:MailKit.ServiceNotConnectedException">
  55912. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55913. </exception>
  55914. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55915. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55916. </exception>
  55917. <exception cref="T:System.OperationCanceledException">
  55918. The operation was canceled via the cancellation token.
  55919. </exception>
  55920. <exception cref="T:System.IO.IOException">
  55921. An I/O error occurred.
  55922. </exception>
  55923. <exception cref="T:MailKit.CommandException">
  55924. The command failed.
  55925. </exception>
  55926. <exception cref="T:MailKit.ProtocolException">
  55927. A protocol error occurred.
  55928. </exception>
  55929. </member>
  55930. <member name="M:MailKit.MailSpool.GetStreamsAsync(System.Int32,System.Int32,System.Boolean,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  55931. <summary>
  55932. Asynchronously get the message or header streams within the specified range.
  55933. </summary>
  55934. <remarks>
  55935. Asynchronously gets the message or header streams within the specified range.
  55936. </remarks>
  55937. <returns>The messages.</returns>
  55938. <param name="startIndex">The index of the first stream to get.</param>
  55939. <param name="count">The number of streams to get.</param>
  55940. <param name="headersOnly"><c>true</c> if only the headers should be retrieved; otherwise, <c>false</c>.</param>
  55941. <param name="cancellationToken">The cancellation token.</param>
  55942. <param name="progress">The progress reporting mechanism.</param>
  55943. <exception cref="T:System.ArgumentOutOfRangeException">
  55944. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  55945. a valid range of messages.
  55946. </exception>
  55947. <exception cref="T:System.ObjectDisposedException">
  55948. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55949. </exception>
  55950. <exception cref="T:MailKit.ServiceNotConnectedException">
  55951. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55952. </exception>
  55953. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55954. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55955. </exception>
  55956. <exception cref="T:System.OperationCanceledException">
  55957. The operation was canceled via the cancellation token.
  55958. </exception>
  55959. <exception cref="T:System.IO.IOException">
  55960. An I/O error occurred.
  55961. </exception>
  55962. <exception cref="T:MailKit.CommandException">
  55963. The command failed.
  55964. </exception>
  55965. <exception cref="T:MailKit.ProtocolException">
  55966. A protocol error occurred.
  55967. </exception>
  55968. </member>
  55969. <member name="M:MailKit.MailSpool.DeleteMessage(System.Int32,System.Threading.CancellationToken)">
  55970. <summary>
  55971. Mark the specified message for deletion.
  55972. </summary>
  55973. <remarks>
  55974. Messages marked for deletion are not actually deleted until the session
  55975. is cleanly disconnected
  55976. (see <see cref="M:MailKit.MailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  55977. </remarks>
  55978. <example>
  55979. <code language="c#" source="Examples\Pop3Examples.cs" region="DownloadMessages"/>
  55980. </example>
  55981. <param name="index">The index of the message.</param>
  55982. <param name="cancellationToken">The cancellation token.</param>
  55983. <exception cref="T:System.ArgumentOutOfRangeException">
  55984. <paramref name="index"/> is not a valid message index.
  55985. </exception>
  55986. <exception cref="T:System.ObjectDisposedException">
  55987. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  55988. </exception>
  55989. <exception cref="T:MailKit.ServiceNotConnectedException">
  55990. The <see cref="T:MailKit.MailSpool"/> is not connected.
  55991. </exception>
  55992. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  55993. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  55994. </exception>
  55995. <exception cref="T:System.OperationCanceledException">
  55996. The operation was canceled via the cancellation token.
  55997. </exception>
  55998. <exception cref="T:System.IO.IOException">
  55999. An I/O error occurred.
  56000. </exception>
  56001. <exception cref="T:MailKit.CommandException">
  56002. The command failed.
  56003. </exception>
  56004. <exception cref="T:MailKit.ProtocolException">
  56005. A protocol error occurred.
  56006. </exception>
  56007. </member>
  56008. <member name="M:MailKit.MailSpool.DeleteMessageAsync(System.Int32,System.Threading.CancellationToken)">
  56009. <summary>
  56010. Asynchronously mark the specified message for deletion.
  56011. </summary>
  56012. <remarks>
  56013. Messages marked for deletion are not actually deleted until the session
  56014. is cleanly disconnected
  56015. (see <see cref="M:MailKit.MailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  56016. </remarks>
  56017. <returns>An asynchronous task context.</returns>
  56018. <param name="index">The index of the message.</param>
  56019. <param name="cancellationToken">The cancellation token.</param>
  56020. <exception cref="T:System.ArgumentOutOfRangeException">
  56021. <paramref name="index"/> is not a valid message index.
  56022. </exception>
  56023. <exception cref="T:System.ObjectDisposedException">
  56024. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  56025. </exception>
  56026. <exception cref="T:MailKit.ServiceNotConnectedException">
  56027. The <see cref="T:MailKit.MailSpool"/> is not connected.
  56028. </exception>
  56029. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56030. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  56031. </exception>
  56032. <exception cref="T:System.OperationCanceledException">
  56033. The operation was canceled via the cancellation token.
  56034. </exception>
  56035. <exception cref="T:System.IO.IOException">
  56036. An I/O error occurred.
  56037. </exception>
  56038. <exception cref="T:MailKit.CommandException">
  56039. The command failed.
  56040. </exception>
  56041. <exception cref="T:MailKit.ProtocolException">
  56042. A protocol error occurred.
  56043. </exception>
  56044. </member>
  56045. <member name="M:MailKit.MailSpool.DeleteMessages(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken)">
  56046. <summary>
  56047. Mark the specified messages for deletion.
  56048. </summary>
  56049. <remarks>
  56050. Messages marked for deletion are not actually deleted until the session
  56051. is cleanly disconnected
  56052. (see <see cref="M:MailKit.MailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  56053. </remarks>
  56054. <param name="indexes">The indexes of the messages.</param>
  56055. <param name="cancellationToken">The cancellation token.</param>
  56056. <exception cref="T:System.ArgumentNullException">
  56057. <paramref name="indexes"/> is <c>null</c>.
  56058. </exception>
  56059. <exception cref="T:System.ArgumentException">
  56060. <para>One or more of the <paramref name="indexes"/> are invalid.</para>
  56061. <para>-or-</para>
  56062. <para>No indexes were specified.</para>
  56063. </exception>
  56064. <exception cref="T:System.ObjectDisposedException">
  56065. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  56066. </exception>
  56067. <exception cref="T:MailKit.ServiceNotConnectedException">
  56068. The <see cref="T:MailKit.MailSpool"/> is not connected.
  56069. </exception>
  56070. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56071. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  56072. </exception>
  56073. <exception cref="T:System.OperationCanceledException">
  56074. The operation was canceled via the cancellation token.
  56075. </exception>
  56076. <exception cref="T:System.IO.IOException">
  56077. An I/O error occurred.
  56078. </exception>
  56079. <exception cref="T:MailKit.CommandException">
  56080. The command failed.
  56081. </exception>
  56082. <exception cref="T:MailKit.ProtocolException">
  56083. A protocol error occurred.
  56084. </exception>
  56085. </member>
  56086. <member name="M:MailKit.MailSpool.DeleteMessagesAsync(System.Collections.Generic.IList{System.Int32},System.Threading.CancellationToken)">
  56087. <summary>
  56088. Asynchronously mark the specified messages for deletion.
  56089. </summary>
  56090. <remarks>
  56091. Messages marked for deletion are not actually deleted until the session
  56092. is cleanly disconnected
  56093. (see <see cref="M:MailKit.MailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  56094. </remarks>
  56095. <returns>An asynchronous task context.</returns>
  56096. <param name="indexes">The indexes of the messages.</param>
  56097. <param name="cancellationToken">The cancellation token.</param>
  56098. <exception cref="T:System.ArgumentNullException">
  56099. <paramref name="indexes"/> is <c>null</c>.
  56100. </exception>
  56101. <exception cref="T:System.ArgumentException">
  56102. <para>One or more of the <paramref name="indexes"/> are invalid.</para>
  56103. <para>-or-</para>
  56104. <para>No indexes were specified.</para>
  56105. </exception>
  56106. <exception cref="T:System.ObjectDisposedException">
  56107. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  56108. </exception>
  56109. <exception cref="T:MailKit.ServiceNotConnectedException">
  56110. The <see cref="T:MailKit.MailSpool"/> is not connected.
  56111. </exception>
  56112. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56113. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  56114. </exception>
  56115. <exception cref="T:System.OperationCanceledException">
  56116. The operation was canceled via the cancellation token.
  56117. </exception>
  56118. <exception cref="T:System.IO.IOException">
  56119. An I/O error occurred.
  56120. </exception>
  56121. <exception cref="T:MailKit.CommandException">
  56122. The command failed.
  56123. </exception>
  56124. <exception cref="T:MailKit.ProtocolException">
  56125. A protocol error occurred.
  56126. </exception>
  56127. </member>
  56128. <member name="M:MailKit.MailSpool.DeleteMessages(System.Int32,System.Int32,System.Threading.CancellationToken)">
  56129. <summary>
  56130. Mark the specified range of messages for deletion.
  56131. </summary>
  56132. <remarks>
  56133. Messages marked for deletion are not actually deleted until the session
  56134. is cleanly disconnected
  56135. (see <see cref="M:MailKit.MailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  56136. </remarks>
  56137. <example>
  56138. <code language="c#" source="Examples\Pop3Examples.cs" region="BatchDownloadMessages"/>
  56139. </example>
  56140. <param name="startIndex">The index of the first message to mark for deletion.</param>
  56141. <param name="count">The number of messages to mark for deletion.</param>
  56142. <param name="cancellationToken">The cancellation token.</param>
  56143. <exception cref="T:System.ArgumentOutOfRangeException">
  56144. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  56145. a valid range of messages.
  56146. </exception>
  56147. <exception cref="T:System.ObjectDisposedException">
  56148. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  56149. </exception>
  56150. <exception cref="T:MailKit.ServiceNotConnectedException">
  56151. The <see cref="T:MailKit.MailSpool"/> is not connected.
  56152. </exception>
  56153. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56154. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  56155. </exception>
  56156. <exception cref="T:System.OperationCanceledException">
  56157. The operation was canceled via the cancellation token.
  56158. </exception>
  56159. <exception cref="T:System.IO.IOException">
  56160. An I/O error occurred.
  56161. </exception>
  56162. <exception cref="T:MailKit.CommandException">
  56163. The command failed.
  56164. </exception>
  56165. <exception cref="T:MailKit.ProtocolException">
  56166. A protocol error occurred.
  56167. </exception>
  56168. </member>
  56169. <member name="M:MailKit.MailSpool.DeleteMessagesAsync(System.Int32,System.Int32,System.Threading.CancellationToken)">
  56170. <summary>
  56171. Asynchronously mark the specified range of messages for deletion.
  56172. </summary>
  56173. <remarks>
  56174. Messages marked for deletion are not actually deleted until the session
  56175. is cleanly disconnected
  56176. (see <see cref="M:MailKit.MailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  56177. </remarks>
  56178. <returns>An asynchronous task context.</returns>
  56179. <param name="startIndex">The index of the first message to mark for deletion.</param>
  56180. <param name="count">The number of messages to mark for deletion.</param>
  56181. <param name="cancellationToken">The cancellation token.</param>
  56182. <exception cref="T:System.ArgumentOutOfRangeException">
  56183. <paramref name="startIndex"/> and <paramref name="count"/> do not specify
  56184. a valid range of messages.
  56185. </exception>
  56186. <exception cref="T:System.ObjectDisposedException">
  56187. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  56188. </exception>
  56189. <exception cref="T:MailKit.ServiceNotConnectedException">
  56190. The <see cref="T:MailKit.MailSpool"/> is not connected.
  56191. </exception>
  56192. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56193. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  56194. </exception>
  56195. <exception cref="T:System.OperationCanceledException">
  56196. The operation was canceled via the cancellation token.
  56197. </exception>
  56198. <exception cref="T:System.IO.IOException">
  56199. An I/O error occurred.
  56200. </exception>
  56201. <exception cref="T:MailKit.CommandException">
  56202. The command failed.
  56203. </exception>
  56204. <exception cref="T:MailKit.ProtocolException">
  56205. A protocol error occurred.
  56206. </exception>
  56207. </member>
  56208. <member name="M:MailKit.MailSpool.DeleteAllMessages(System.Threading.CancellationToken)">
  56209. <summary>
  56210. Mark all messages for deletion.
  56211. </summary>
  56212. <remarks>
  56213. Messages marked for deletion are not actually deleted until the session
  56214. is cleanly disconnected
  56215. (see <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  56216. </remarks>
  56217. <param name="cancellationToken">The cancellation token.</param>
  56218. <exception cref="T:System.ObjectDisposedException">
  56219. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  56220. </exception>
  56221. <exception cref="T:MailKit.ServiceNotConnectedException">
  56222. The <see cref="T:MailKit.MailSpool"/> is not connected.
  56223. </exception>
  56224. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56225. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  56226. </exception>
  56227. <exception cref="T:System.OperationCanceledException">
  56228. The operation was canceled via the cancellation token.
  56229. </exception>
  56230. <exception cref="T:System.IO.IOException">
  56231. An I/O error occurred.
  56232. </exception>
  56233. <exception cref="T:MailKit.CommandException">
  56234. The command failed.
  56235. </exception>
  56236. <exception cref="T:MailKit.ProtocolException">
  56237. A protocol error occurred.
  56238. </exception>
  56239. </member>
  56240. <member name="M:MailKit.MailSpool.DeleteAllMessagesAsync(System.Threading.CancellationToken)">
  56241. <summary>
  56242. Asynchronously mark all messages for deletion.
  56243. </summary>
  56244. <remarks>
  56245. Messages marked for deletion are not actually deleted until the session
  56246. is cleanly disconnected
  56247. (see <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  56248. </remarks>
  56249. <returns>An asynchronous task context.</returns>
  56250. <param name="cancellationToken">The cancellation token.</param>
  56251. <exception cref="T:System.ObjectDisposedException">
  56252. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  56253. </exception>
  56254. <exception cref="T:MailKit.ServiceNotConnectedException">
  56255. The <see cref="T:MailKit.MailSpool"/> is not connected.
  56256. </exception>
  56257. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56258. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  56259. </exception>
  56260. <exception cref="T:System.OperationCanceledException">
  56261. The operation was canceled via the cancellation token.
  56262. </exception>
  56263. <exception cref="T:System.IO.IOException">
  56264. An I/O error occurred.
  56265. </exception>
  56266. <exception cref="T:MailKit.CommandException">
  56267. The command failed.
  56268. </exception>
  56269. <exception cref="T:MailKit.ProtocolException">
  56270. A protocol error occurred.
  56271. </exception>
  56272. </member>
  56273. <member name="M:MailKit.MailSpool.Reset(System.Threading.CancellationToken)">
  56274. <summary>
  56275. Reset the state of all messages marked for deletion.
  56276. </summary>
  56277. <remarks>
  56278. Messages marked for deletion are not actually deleted until the session
  56279. is cleanly disconnected
  56280. (see <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  56281. </remarks>
  56282. <param name="cancellationToken">The cancellation token.</param>
  56283. <exception cref="T:System.ObjectDisposedException">
  56284. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  56285. </exception>
  56286. <exception cref="T:MailKit.ServiceNotConnectedException">
  56287. The <see cref="T:MailKit.MailSpool"/> is not connected.
  56288. </exception>
  56289. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56290. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  56291. </exception>
  56292. <exception cref="T:System.OperationCanceledException">
  56293. The operation was canceled via the cancellation token.
  56294. </exception>
  56295. <exception cref="T:System.IO.IOException">
  56296. An I/O error occurred.
  56297. </exception>
  56298. <exception cref="T:MailKit.CommandException">
  56299. The command failed.
  56300. </exception>
  56301. <exception cref="T:MailKit.ProtocolException">
  56302. A protocol error occurred.
  56303. </exception>
  56304. </member>
  56305. <member name="M:MailKit.MailSpool.ResetAsync(System.Threading.CancellationToken)">
  56306. <summary>
  56307. Asynchronously reset the state of all messages marked for deletion.
  56308. </summary>
  56309. <remarks>
  56310. Messages marked for deletion are not actually deleted until the session
  56311. is cleanly disconnected
  56312. (see <see cref="M:MailKit.IMailService.Disconnect(System.Boolean,System.Threading.CancellationToken)"/>).
  56313. </remarks>
  56314. <returns>An asynchronous task context.</returns>
  56315. <param name="cancellationToken">The cancellation token.</param>
  56316. <exception cref="T:System.ObjectDisposedException">
  56317. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  56318. </exception>
  56319. <exception cref="T:MailKit.ServiceNotConnectedException">
  56320. The <see cref="T:MailKit.MailSpool"/> is not connected.
  56321. </exception>
  56322. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56323. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  56324. </exception>
  56325. <exception cref="T:System.OperationCanceledException">
  56326. The operation was canceled via the cancellation token.
  56327. </exception>
  56328. <exception cref="T:System.IO.IOException">
  56329. An I/O error occurred.
  56330. </exception>
  56331. <exception cref="T:MailKit.CommandException">
  56332. The command failed.
  56333. </exception>
  56334. <exception cref="T:MailKit.ProtocolException">
  56335. A protocol error occurred.
  56336. </exception>
  56337. </member>
  56338. <member name="M:MailKit.MailSpool.GetEnumerator">
  56339. <summary>
  56340. Get an enumerator for the messages in the folder.
  56341. </summary>
  56342. <remarks>
  56343. Gets an enumerator for the messages in the folder.
  56344. </remarks>
  56345. <returns>The enumerator.</returns>
  56346. <exception cref="T:System.ObjectDisposedException">
  56347. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  56348. </exception>
  56349. <exception cref="T:MailKit.ServiceNotConnectedException">
  56350. The <see cref="T:MailKit.MailSpool"/> is not connected.
  56351. </exception>
  56352. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56353. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  56354. </exception>
  56355. <exception cref="T:System.OperationCanceledException">
  56356. The operation was canceled via the cancellation token.
  56357. </exception>
  56358. <exception cref="T:System.IO.IOException">
  56359. An I/O error occurred.
  56360. </exception>
  56361. <exception cref="T:MailKit.CommandException">
  56362. A command failed.
  56363. </exception>
  56364. <exception cref="T:MailKit.ProtocolException">
  56365. A protocol error occurred.
  56366. </exception>
  56367. </member>
  56368. <member name="M:MailKit.MailSpool.System#Collections#IEnumerable#GetEnumerator">
  56369. <summary>
  56370. Get an enumerator for the messages in the folder.
  56371. </summary>
  56372. <remarks>
  56373. Gets an enumerator for the messages in the folder.
  56374. </remarks>
  56375. <returns>The enumerator.</returns>
  56376. <exception cref="T:System.ObjectDisposedException">
  56377. The <see cref="T:MailKit.MailSpool"/> has been disposed.
  56378. </exception>
  56379. <exception cref="T:MailKit.ServiceNotConnectedException">
  56380. The <see cref="T:MailKit.MailSpool"/> is not connected.
  56381. </exception>
  56382. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56383. The <see cref="T:MailKit.MailSpool"/> is not authenticated.
  56384. </exception>
  56385. <exception cref="T:System.OperationCanceledException">
  56386. The operation was canceled via the cancellation token.
  56387. </exception>
  56388. <exception cref="T:System.IO.IOException">
  56389. An I/O error occurred.
  56390. </exception>
  56391. <exception cref="T:MailKit.CommandException">
  56392. A command failed.
  56393. </exception>
  56394. <exception cref="T:MailKit.ProtocolException">
  56395. A protocol error occurred.
  56396. </exception>
  56397. </member>
  56398. <member name="T:MailKit.MailStore">
  56399. <summary>
  56400. An abstract mail store implementation.
  56401. </summary>
  56402. <remarks>
  56403. An abstract mail store implementation.
  56404. </remarks>
  56405. </member>
  56406. <member name="M:MailKit.MailStore.#ctor(MailKit.IProtocolLogger)">
  56407. <summary>
  56408. Initializes a new instance of the <see cref="T:MailKit.MailStore"/> class.
  56409. </summary>
  56410. <remarks>
  56411. Initializes a new instance of the <see cref="T:MailKit.MailStore"/> class.
  56412. </remarks>
  56413. <param name="protocolLogger">The protocol logger.</param>
  56414. <exception cref="T:System.ArgumentNullException">
  56415. <paramref name="protocolLogger"/> is <c>null</c>.
  56416. </exception>
  56417. </member>
  56418. <member name="P:MailKit.MailStore.PersonalNamespaces">
  56419. <summary>
  56420. Gets the personal namespaces.
  56421. </summary>
  56422. <remarks>
  56423. The personal folder namespaces contain a user's personal mailbox folders.
  56424. </remarks>
  56425. <value>The personal namespaces.</value>
  56426. </member>
  56427. <member name="P:MailKit.MailStore.SharedNamespaces">
  56428. <summary>
  56429. Gets the shared namespaces.
  56430. </summary>
  56431. <remarks>
  56432. The shared folder namespaces contain mailbox folders that are shared with the user.
  56433. </remarks>
  56434. <value>The shared namespaces.</value>
  56435. </member>
  56436. <member name="P:MailKit.MailStore.OtherNamespaces">
  56437. <summary>
  56438. Gets the other namespaces.
  56439. </summary>
  56440. <remarks>
  56441. The other folder namespaces contain other mailbox folders.
  56442. </remarks>
  56443. <value>The other namespaces.</value>
  56444. </member>
  56445. <member name="P:MailKit.MailStore.SupportsQuotas">
  56446. <summary>
  56447. Get whether or not the mail store supports quotas.
  56448. </summary>
  56449. <remarks>
  56450. Gets whether or not the mail store supports quotas.
  56451. </remarks>
  56452. <value><c>true</c> if the mail store supports quotas; otherwise, <c>false</c>.</value>
  56453. </member>
  56454. <member name="P:MailKit.MailStore.ThreadingAlgorithms">
  56455. <summary>
  56456. Get the threading algorithms supported by the mail store.
  56457. </summary>
  56458. <remarks>
  56459. The threading algorithms are queried as part of the
  56460. <a href="Overload_MailKit_MailStore_Connect.htm">Connect</a>
  56461. and <a href="Overload_MailKit_MailStore_Authenticate.htm">Authenticate</a> methods.
  56462. </remarks>
  56463. <example>
  56464. <code language="c#" source="Examples\ImapExamples.cs" region="Capabilities"/>
  56465. </example>
  56466. <value>The supported threading algorithms.</value>
  56467. </member>
  56468. <member name="P:MailKit.MailStore.Inbox">
  56469. <summary>
  56470. Get the Inbox folder.
  56471. </summary>
  56472. <remarks>
  56473. <para>The Inbox folder is the default folder and always exists on the mail store.</para>
  56474. <note type="note">This property will only be available after the client has been authenticated.</note>
  56475. </remarks>
  56476. <value>The Inbox folder.</value>
  56477. </member>
  56478. <member name="M:MailKit.MailStore.EnableQuickResync(System.Threading.CancellationToken)">
  56479. <summary>
  56480. Enable the quick resynchronization feature.
  56481. </summary>
  56482. <remarks>
  56483. <para>Enables quick resynchronization when a folder is opened using the
  56484. <see cref="M:MailKit.MailFolder.Open(MailKit.FolderAccess,System.UInt32,System.UInt64,System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)"/>
  56485. method.</para>
  56486. <para>If this feature is enabled, the <see cref="E:MailKit.MailFolder.MessageExpunged"/> event is replaced
  56487. with the <see cref="E:MailKit.MailFolder.MessagesVanished"/> event.</para>
  56488. <para>This method needs to be called immediately after calling one of the
  56489. <a href="Overload_MailKit_MailService_Authenticate.htm">Authenticate</a> methods, before
  56490. opening any folders.</para>
  56491. </remarks>
  56492. <param name="cancellationToken">The cancellation token.</param>
  56493. <exception cref="T:System.ObjectDisposedException">
  56494. The <see cref="T:MailKit.MailStore"/> has been disposed.
  56495. </exception>
  56496. <exception cref="T:MailKit.ServiceNotConnectedException">
  56497. The <see cref="T:MailKit.MailStore"/> is not connected.
  56498. </exception>
  56499. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56500. The <see cref="T:MailKit.MailStore"/> is not authenticated.
  56501. </exception>
  56502. <exception cref="T:System.InvalidOperationException">
  56503. Quick resynchronization needs to be enabled before selecting a folder.
  56504. </exception>
  56505. <exception cref="T:System.NotSupportedException">
  56506. The mail store does not support quick resynchronization.
  56507. </exception>
  56508. <exception cref="T:System.OperationCanceledException">
  56509. The operation was canceled via the cancellation token.
  56510. </exception>
  56511. <exception cref="T:System.IO.IOException">
  56512. An I/O error occurred.
  56513. </exception>
  56514. <exception cref="T:MailKit.ProtocolException">
  56515. A protocol error occurred.
  56516. </exception>
  56517. <exception cref="T:MailKit.CommandException">
  56518. The command failed.
  56519. </exception>
  56520. </member>
  56521. <member name="M:MailKit.MailStore.EnableQuickResyncAsync(System.Threading.CancellationToken)">
  56522. <summary>
  56523. Asynchronously enable the quick resynchronization feature.
  56524. </summary>
  56525. <remarks>
  56526. <para>Enables quick resynchronization when a folder is opened using the
  56527. <see cref="M:MailKit.MailFolder.Open(MailKit.FolderAccess,System.UInt32,System.UInt64,System.Collections.Generic.IList{MailKit.UniqueId},System.Threading.CancellationToken)"/>
  56528. method.</para>
  56529. <para>If this feature is enabled, the <see cref="E:MailKit.MailFolder.MessageExpunged"/> event is replaced
  56530. with the <see cref="E:MailKit.MailFolder.MessagesVanished"/> event.</para>
  56531. <para>This method needs to be called immediately after calling one of the
  56532. <a href="Overload_MailKit_MailService_Authenticate.htm">Authenticate</a> methods, before
  56533. opening any folders.</para>
  56534. </remarks>
  56535. <returns>An asynchronous task context.</returns>
  56536. <param name="cancellationToken">The cancellation token.</param>
  56537. <exception cref="T:System.ObjectDisposedException">
  56538. The <see cref="T:MailKit.MailStore"/> has been disposed.
  56539. </exception>
  56540. <exception cref="T:MailKit.ServiceNotConnectedException">
  56541. The <see cref="T:MailKit.MailStore"/> is not connected.
  56542. </exception>
  56543. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56544. The <see cref="T:MailKit.MailStore"/> is not authenticated.
  56545. </exception>
  56546. <exception cref="T:System.InvalidOperationException">
  56547. Quick resynchronization needs to be enabled before selecting a folder.
  56548. </exception>
  56549. <exception cref="T:System.NotSupportedException">
  56550. The mail store does not support quick resynchronization.
  56551. </exception>
  56552. <exception cref="T:System.OperationCanceledException">
  56553. The operation was canceled via the cancellation token.
  56554. </exception>
  56555. <exception cref="T:System.IO.IOException">
  56556. An I/O error occurred.
  56557. </exception>
  56558. <exception cref="T:MailKit.ProtocolException">
  56559. A protocol error occurred.
  56560. </exception>
  56561. <exception cref="T:MailKit.CommandException">
  56562. The command failed.
  56563. </exception>
  56564. </member>
  56565. <member name="M:MailKit.MailStore.GetFolder(MailKit.SpecialFolder)">
  56566. <summary>
  56567. Get the specified special folder.
  56568. </summary>
  56569. <remarks>
  56570. Not all mail stores support special folders. Each implementation
  56571. should provide a way to determine if special folders are supported.
  56572. </remarks>
  56573. <returns>The folder if available; otherwise <c>null</c>.</returns>
  56574. <param name="folder">The type of special folder.</param>
  56575. <exception cref="T:System.ArgumentOutOfRangeException">
  56576. <paramref name="folder"/> is out of range.
  56577. </exception>
  56578. <exception cref="T:System.ObjectDisposedException">
  56579. The <see cref="T:MailKit.MailStore"/> has been disposed.
  56580. </exception>
  56581. <exception cref="T:MailKit.ServiceNotConnectedException">
  56582. The <see cref="T:MailKit.MailStore"/> is not connected.
  56583. </exception>
  56584. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56585. The <see cref="T:MailKit.MailStore"/> is not authenticated.
  56586. </exception>
  56587. </member>
  56588. <member name="M:MailKit.MailStore.GetFolder(MailKit.FolderNamespace)">
  56589. <summary>
  56590. Get the folder for the specified namespace.
  56591. </summary>
  56592. <remarks>
  56593. Gets the folder for the specified namespace.
  56594. </remarks>
  56595. <returns>The folder.</returns>
  56596. <param name="namespace">The namespace.</param>
  56597. <exception cref="T:System.ArgumentNullException">
  56598. <paramref name="namespace"/> is <c>null</c>.
  56599. </exception>
  56600. <exception cref="T:System.ObjectDisposedException">
  56601. The <see cref="T:MailKit.MailStore"/> has been disposed.
  56602. </exception>
  56603. <exception cref="T:MailKit.ServiceNotConnectedException">
  56604. The <see cref="T:MailKit.MailStore"/> is not connected.
  56605. </exception>
  56606. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56607. The <see cref="T:MailKit.MailStore"/> is not authenticated.
  56608. </exception>
  56609. <exception cref="T:MailKit.FolderNotFoundException">
  56610. The folder could not be found.
  56611. </exception>
  56612. </member>
  56613. <member name="M:MailKit.MailStore.GetFolders(MailKit.FolderNamespace,System.Boolean,System.Threading.CancellationToken)">
  56614. <summary>
  56615. Get all of the folders within the specified namespace.
  56616. </summary>
  56617. <remarks>
  56618. Gets all of the folders within the specified namespace.
  56619. </remarks>
  56620. <returns>The folders.</returns>
  56621. <param name="namespace">The namespace.</param>
  56622. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  56623. <param name="cancellationToken">The cancellation token.</param>
  56624. <exception cref="T:System.ArgumentNullException">
  56625. <paramref name="namespace"/> is <c>null</c>.
  56626. </exception>
  56627. <exception cref="T:System.ObjectDisposedException">
  56628. The <see cref="T:MailKit.MailStore"/> has been disposed.
  56629. </exception>
  56630. <exception cref="T:MailKit.ServiceNotConnectedException">
  56631. The <see cref="T:MailKit.MailStore"/> is not connected.
  56632. </exception>
  56633. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56634. The <see cref="T:MailKit.MailStore"/> is not authenticated.
  56635. </exception>
  56636. <exception cref="T:System.OperationCanceledException">
  56637. The operation was canceled via the cancellation token.
  56638. </exception>
  56639. <exception cref="T:System.IO.IOException">
  56640. An I/O error occurred.
  56641. </exception>
  56642. <exception cref="T:MailKit.ProtocolException">
  56643. A protocol error occurred.
  56644. </exception>
  56645. <exception cref="T:MailKit.CommandException">
  56646. The command failed.
  56647. </exception>
  56648. </member>
  56649. <member name="M:MailKit.MailStore.GetFoldersAsync(MailKit.FolderNamespace,System.Boolean,System.Threading.CancellationToken)">
  56650. <summary>
  56651. Asynchronously get all of the folders within the specified namespace.
  56652. </summary>
  56653. <remarks>
  56654. Asynchronously gets all of the folders within the specified namespace.
  56655. </remarks>
  56656. <returns>The folders.</returns>
  56657. <param name="namespace">The namespace.</param>
  56658. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  56659. <param name="cancellationToken">The cancellation token.</param>
  56660. <exception cref="T:System.ArgumentNullException">
  56661. <paramref name="namespace"/> is <c>null</c>.
  56662. </exception>
  56663. <exception cref="T:System.ObjectDisposedException">
  56664. The <see cref="T:MailKit.MailStore"/> has been disposed.
  56665. </exception>
  56666. <exception cref="T:MailKit.ServiceNotConnectedException">
  56667. The <see cref="T:MailKit.MailStore"/> is not connected.
  56668. </exception>
  56669. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56670. The <see cref="T:MailKit.MailStore"/> is not authenticated.
  56671. </exception>
  56672. <exception cref="T:System.OperationCanceledException">
  56673. The operation was canceled via the cancellation token.
  56674. </exception>
  56675. <exception cref="T:System.IO.IOException">
  56676. An I/O error occurred.
  56677. </exception>
  56678. <exception cref="T:MailKit.ProtocolException">
  56679. A protocol error occurred.
  56680. </exception>
  56681. <exception cref="T:MailKit.CommandException">
  56682. The command failed.
  56683. </exception>
  56684. </member>
  56685. <member name="M:MailKit.MailStore.GetFolders(MailKit.FolderNamespace,MailKit.StatusItems,System.Boolean,System.Threading.CancellationToken)">
  56686. <summary>
  56687. Get all of the folders within the specified namespace.
  56688. </summary>
  56689. <remarks>
  56690. Gets all of the folders within the specified namespace.
  56691. </remarks>
  56692. <returns>The folders.</returns>
  56693. <param name="namespace">The namespace.</param>
  56694. <param name="items">The status items to pre-populate.</param>
  56695. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  56696. <param name="cancellationToken">The cancellation token.</param>
  56697. <exception cref="T:System.ArgumentNullException">
  56698. <paramref name="namespace"/> is <c>null</c>.
  56699. </exception>
  56700. <exception cref="T:System.ObjectDisposedException">
  56701. The <see cref="T:MailKit.MailStore"/> has been disposed.
  56702. </exception>
  56703. <exception cref="T:MailKit.ServiceNotConnectedException">
  56704. The <see cref="T:MailKit.MailStore"/> is not connected.
  56705. </exception>
  56706. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56707. The <see cref="T:MailKit.MailStore"/> is not authenticated.
  56708. </exception>
  56709. <exception cref="T:System.OperationCanceledException">
  56710. The operation was canceled via the cancellation token.
  56711. </exception>
  56712. <exception cref="T:System.IO.IOException">
  56713. An I/O error occurred.
  56714. </exception>
  56715. <exception cref="T:MailKit.ProtocolException">
  56716. A protocol error occurred.
  56717. </exception>
  56718. <exception cref="T:MailKit.CommandException">
  56719. The command failed.
  56720. </exception>
  56721. </member>
  56722. <member name="M:MailKit.MailStore.GetFoldersAsync(MailKit.FolderNamespace,MailKit.StatusItems,System.Boolean,System.Threading.CancellationToken)">
  56723. <summary>
  56724. Asynchronously get all of the folders within the specified namespace.
  56725. </summary>
  56726. <remarks>
  56727. Asynchronously gets all of the folders within the specified namespace.
  56728. </remarks>
  56729. <returns>The folders.</returns>
  56730. <param name="namespace">The namespace.</param>
  56731. <param name="items">The status items to pre-populate.</param>
  56732. <param name="subscribedOnly">If set to <c>true</c>, only subscribed folders will be listed.</param>
  56733. <param name="cancellationToken">The cancellation token.</param>
  56734. <exception cref="T:System.ArgumentNullException">
  56735. <paramref name="namespace"/> is <c>null</c>.
  56736. </exception>
  56737. <exception cref="T:System.ObjectDisposedException">
  56738. The <see cref="T:MailKit.MailStore"/> has been disposed.
  56739. </exception>
  56740. <exception cref="T:MailKit.ServiceNotConnectedException">
  56741. The <see cref="T:MailKit.MailStore"/> is not connected.
  56742. </exception>
  56743. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56744. The <see cref="T:MailKit.MailStore"/> is not authenticated.
  56745. </exception>
  56746. <exception cref="T:System.OperationCanceledException">
  56747. The operation was canceled via the cancellation token.
  56748. </exception>
  56749. <exception cref="T:System.IO.IOException">
  56750. An I/O error occurred.
  56751. </exception>
  56752. <exception cref="T:MailKit.ProtocolException">
  56753. A protocol error occurred.
  56754. </exception>
  56755. <exception cref="T:MailKit.CommandException">
  56756. The command failed.
  56757. </exception>
  56758. </member>
  56759. <member name="M:MailKit.MailStore.GetFolder(System.String,System.Threading.CancellationToken)">
  56760. <summary>
  56761. Get the folder for the specified path.
  56762. </summary>
  56763. <remarks>
  56764. Gets the folder for the specified path.
  56765. </remarks>
  56766. <returns>The folder.</returns>
  56767. <param name="path">The folder path.</param>
  56768. <param name="cancellationToken">The cancellation token.</param>
  56769. <exception cref="T:System.ArgumentNullException">
  56770. <paramref name="path"/> is <c>null</c>.
  56771. </exception>
  56772. <exception cref="T:System.ObjectDisposedException">
  56773. The <see cref="T:MailKit.MailStore"/> has been disposed.
  56774. </exception>
  56775. <exception cref="T:MailKit.ServiceNotConnectedException">
  56776. The <see cref="T:MailKit.MailStore"/> is not connected.
  56777. </exception>
  56778. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56779. The <see cref="T:MailKit.MailStore"/> is not authenticated.
  56780. </exception>
  56781. <exception cref="T:System.OperationCanceledException">
  56782. The operation was canceled via the cancellation token.
  56783. </exception>
  56784. <exception cref="T:MailKit.FolderNotFoundException">
  56785. The folder could not be found.
  56786. </exception>
  56787. <exception cref="T:System.IO.IOException">
  56788. An I/O error occurred.
  56789. </exception>
  56790. <exception cref="T:MailKit.ProtocolException">
  56791. A protocol error occurred.
  56792. </exception>
  56793. <exception cref="T:MailKit.CommandException">
  56794. The command failed.
  56795. </exception>
  56796. </member>
  56797. <member name="M:MailKit.MailStore.GetFolderAsync(System.String,System.Threading.CancellationToken)">
  56798. <summary>
  56799. Asynchronously get the folder for the specified path.
  56800. </summary>
  56801. <remarks>
  56802. Asynchronously gets the folder for the specified path.
  56803. </remarks>
  56804. <returns>The folder.</returns>
  56805. <param name="path">The folder path.</param>
  56806. <param name="cancellationToken">The cancellation token.</param>
  56807. <exception cref="T:System.ArgumentNullException">
  56808. <paramref name="path"/> is <c>null</c>.
  56809. </exception>
  56810. <exception cref="T:System.ObjectDisposedException">
  56811. The <see cref="T:MailKit.MailStore"/> has been disposed.
  56812. </exception>
  56813. <exception cref="T:MailKit.ServiceNotConnectedException">
  56814. The <see cref="T:MailKit.MailStore"/> is not connected.
  56815. </exception>
  56816. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56817. The <see cref="T:MailKit.MailStore"/> is not authenticated.
  56818. </exception>
  56819. <exception cref="T:System.OperationCanceledException">
  56820. The operation was canceled via the cancellation token.
  56821. </exception>
  56822. <exception cref="T:MailKit.FolderNotFoundException">
  56823. The folder could not be found.
  56824. </exception>
  56825. <exception cref="T:System.IO.IOException">
  56826. An I/O error occurred.
  56827. </exception>
  56828. <exception cref="T:MailKit.ProtocolException">
  56829. A protocol error occurred.
  56830. </exception>
  56831. <exception cref="T:MailKit.CommandException">
  56832. The command failed.
  56833. </exception>
  56834. </member>
  56835. <member name="M:MailKit.MailStore.GetMetadata(MailKit.MetadataTag,System.Threading.CancellationToken)">
  56836. <summary>
  56837. Gets the specified metadata.
  56838. </summary>
  56839. <remarks>
  56840. Gets the specified metadata.
  56841. </remarks>
  56842. <returns>The requested metadata value.</returns>
  56843. <param name="tag">The metadata tag.</param>
  56844. <param name="cancellationToken">The cancellation token.</param>
  56845. <exception cref="T:System.ObjectDisposedException">
  56846. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  56847. </exception>
  56848. <exception cref="T:MailKit.ServiceNotConnectedException">
  56849. The <see cref="T:MailKit.IMailStore"/> is not connected.
  56850. </exception>
  56851. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56852. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  56853. </exception>
  56854. <exception cref="T:System.NotSupportedException">
  56855. The folder does not support metadata.
  56856. </exception>
  56857. <exception cref="T:System.OperationCanceledException">
  56858. The operation was canceled via the cancellation token.
  56859. </exception>
  56860. <exception cref="T:System.IO.IOException">
  56861. An I/O error occurred.
  56862. </exception>
  56863. <exception cref="T:MailKit.ProtocolException">
  56864. The server's response contained unexpected tokens.
  56865. </exception>
  56866. <exception cref="T:MailKit.CommandException">
  56867. The command failed.
  56868. </exception>
  56869. </member>
  56870. <member name="M:MailKit.MailStore.GetMetadataAsync(MailKit.MetadataTag,System.Threading.CancellationToken)">
  56871. <summary>
  56872. Asynchronously gets the specified metadata.
  56873. </summary>
  56874. <remarks>
  56875. Asynchronously gets the specified metadata.
  56876. </remarks>
  56877. <returns>The requested metadata value.</returns>
  56878. <param name="tag">The metadata tag.</param>
  56879. <param name="cancellationToken">The cancellation token.</param>
  56880. <exception cref="T:System.ObjectDisposedException">
  56881. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  56882. </exception>
  56883. <exception cref="T:MailKit.ServiceNotConnectedException">
  56884. The <see cref="T:MailKit.IMailStore"/> is not connected.
  56885. </exception>
  56886. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56887. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  56888. </exception>
  56889. <exception cref="T:System.NotSupportedException">
  56890. The folder does not support metadata.
  56891. </exception>
  56892. <exception cref="T:System.OperationCanceledException">
  56893. The operation was canceled via the cancellation token.
  56894. </exception>
  56895. <exception cref="T:System.IO.IOException">
  56896. An I/O error occurred.
  56897. </exception>
  56898. <exception cref="T:MailKit.ProtocolException">
  56899. The server's response contained unexpected tokens.
  56900. </exception>
  56901. <exception cref="T:MailKit.CommandException">
  56902. The command failed.
  56903. </exception>
  56904. </member>
  56905. <member name="M:MailKit.MailStore.GetMetadata(System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  56906. <summary>
  56907. Gets the specified metadata.
  56908. </summary>
  56909. <remarks>
  56910. Gets the specified metadata.
  56911. </remarks>
  56912. <returns>The requested metadata.</returns>
  56913. <param name="tags">The metadata tags.</param>
  56914. <param name="cancellationToken">The cancellation token.</param>
  56915. <exception cref="T:System.ArgumentNullException">
  56916. <paramref name="tags"/> is <c>null</c>.
  56917. </exception>
  56918. <exception cref="T:System.ObjectDisposedException">
  56919. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  56920. </exception>
  56921. <exception cref="T:MailKit.ServiceNotConnectedException">
  56922. The <see cref="T:MailKit.IMailStore"/> is not connected.
  56923. </exception>
  56924. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56925. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  56926. </exception>
  56927. <exception cref="T:System.NotSupportedException">
  56928. The folder does not support metadata.
  56929. </exception>
  56930. <exception cref="T:System.OperationCanceledException">
  56931. The operation was canceled via the cancellation token.
  56932. </exception>
  56933. <exception cref="T:System.IO.IOException">
  56934. An I/O error occurred.
  56935. </exception>
  56936. <exception cref="T:MailKit.ProtocolException">
  56937. The server's response contained unexpected tokens.
  56938. </exception>
  56939. <exception cref="T:MailKit.CommandException">
  56940. The command failed.
  56941. </exception>
  56942. </member>
  56943. <member name="M:MailKit.MailStore.GetMetadataAsync(System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  56944. <summary>
  56945. Asynchronously gets the specified metadata.
  56946. </summary>
  56947. <remarks>
  56948. Asynchronously gets the specified metadata.
  56949. </remarks>
  56950. <returns>The requested metadata.</returns>
  56951. <param name="tags">The metadata tags.</param>
  56952. <param name="cancellationToken">The cancellation token.</param>
  56953. <exception cref="T:System.ArgumentNullException">
  56954. <paramref name="tags"/> is <c>null</c>.
  56955. </exception>
  56956. <exception cref="T:System.ObjectDisposedException">
  56957. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  56958. </exception>
  56959. <exception cref="T:MailKit.ServiceNotConnectedException">
  56960. The <see cref="T:MailKit.IMailStore"/> is not connected.
  56961. </exception>
  56962. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  56963. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  56964. </exception>
  56965. <exception cref="T:System.NotSupportedException">
  56966. The folder does not support metadata.
  56967. </exception>
  56968. <exception cref="T:System.OperationCanceledException">
  56969. The operation was canceled via the cancellation token.
  56970. </exception>
  56971. <exception cref="T:System.IO.IOException">
  56972. An I/O error occurred.
  56973. </exception>
  56974. <exception cref="T:MailKit.ProtocolException">
  56975. The server's response contained unexpected tokens.
  56976. </exception>
  56977. <exception cref="T:MailKit.CommandException">
  56978. The command failed.
  56979. </exception>
  56980. </member>
  56981. <member name="M:MailKit.MailStore.GetMetadata(MailKit.MetadataOptions,System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  56982. <summary>
  56983. Gets the specified metadata.
  56984. </summary>
  56985. <remarks>
  56986. Gets the specified metadata.
  56987. </remarks>
  56988. <returns>The requested metadata.</returns>
  56989. <param name="options">The metadata options.</param>
  56990. <param name="tags">The metadata tags.</param>
  56991. <param name="cancellationToken">The cancellation token.</param>
  56992. <exception cref="T:System.ArgumentNullException">
  56993. <para><paramref name="options"/> is <c>null</c>.</para>
  56994. <para>-or-</para>
  56995. <para><paramref name="tags"/> is <c>null</c>.</para>
  56996. </exception>
  56997. <exception cref="T:System.ObjectDisposedException">
  56998. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  56999. </exception>
  57000. <exception cref="T:MailKit.ServiceNotConnectedException">
  57001. The <see cref="T:MailKit.IMailStore"/> is not connected.
  57002. </exception>
  57003. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  57004. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  57005. </exception>
  57006. <exception cref="T:System.NotSupportedException">
  57007. The folder does not support metadata.
  57008. </exception>
  57009. <exception cref="T:System.OperationCanceledException">
  57010. The operation was canceled via the cancellation token.
  57011. </exception>
  57012. <exception cref="T:System.IO.IOException">
  57013. An I/O error occurred.
  57014. </exception>
  57015. <exception cref="T:MailKit.ProtocolException">
  57016. The server's response contained unexpected tokens.
  57017. </exception>
  57018. <exception cref="T:MailKit.CommandException">
  57019. The command failed.
  57020. </exception>
  57021. </member>
  57022. <member name="M:MailKit.MailStore.GetMetadataAsync(MailKit.MetadataOptions,System.Collections.Generic.IEnumerable{MailKit.MetadataTag},System.Threading.CancellationToken)">
  57023. <summary>
  57024. Asynchronously gets the specified metadata.
  57025. </summary>
  57026. <remarks>
  57027. Asynchronously gets the specified metadata.
  57028. </remarks>
  57029. <returns>The requested metadata.</returns>
  57030. <param name="options">The metadata options.</param>
  57031. <param name="tags">The metadata tags.</param>
  57032. <param name="cancellationToken">The cancellation token.</param>
  57033. <exception cref="T:System.ArgumentNullException">
  57034. <para><paramref name="options"/> is <c>null</c>.</para>
  57035. <para>-or-</para>
  57036. <para><paramref name="tags"/> is <c>null</c>.</para>
  57037. </exception>
  57038. <exception cref="T:System.ObjectDisposedException">
  57039. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  57040. </exception>
  57041. <exception cref="T:MailKit.ServiceNotConnectedException">
  57042. The <see cref="T:MailKit.IMailStore"/> is not connected.
  57043. </exception>
  57044. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  57045. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  57046. </exception>
  57047. <exception cref="T:System.NotSupportedException">
  57048. The folder does not support metadata.
  57049. </exception>
  57050. <exception cref="T:System.OperationCanceledException">
  57051. The operation was canceled via the cancellation token.
  57052. </exception>
  57053. <exception cref="T:System.IO.IOException">
  57054. An I/O error occurred.
  57055. </exception>
  57056. <exception cref="T:MailKit.ProtocolException">
  57057. The server's response contained unexpected tokens.
  57058. </exception>
  57059. <exception cref="T:MailKit.CommandException">
  57060. The command failed.
  57061. </exception>
  57062. </member>
  57063. <member name="M:MailKit.MailStore.SetMetadata(MailKit.MetadataCollection,System.Threading.CancellationToken)">
  57064. <summary>
  57065. Sets the specified metadata.
  57066. </summary>
  57067. <remarks>
  57068. Sets the specified metadata.
  57069. </remarks>
  57070. <param name="metadata">The metadata.</param>
  57071. <param name="cancellationToken">The cancellation token.</param>
  57072. <exception cref="T:System.ArgumentNullException">
  57073. <paramref name="metadata"/> is <c>null</c>.
  57074. </exception>
  57075. <exception cref="T:System.ObjectDisposedException">
  57076. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  57077. </exception>
  57078. <exception cref="T:MailKit.ServiceNotConnectedException">
  57079. The <see cref="T:MailKit.IMailStore"/> is not connected.
  57080. </exception>
  57081. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  57082. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  57083. </exception>
  57084. <exception cref="T:System.NotSupportedException">
  57085. The folder does not support metadata.
  57086. </exception>
  57087. <exception cref="T:System.OperationCanceledException">
  57088. The operation was canceled via the cancellation token.
  57089. </exception>
  57090. <exception cref="T:System.IO.IOException">
  57091. An I/O error occurred.
  57092. </exception>
  57093. <exception cref="T:MailKit.ProtocolException">
  57094. The server's response contained unexpected tokens.
  57095. </exception>
  57096. <exception cref="T:MailKit.CommandException">
  57097. The command failed.
  57098. </exception>
  57099. </member>
  57100. <member name="M:MailKit.MailStore.SetMetadataAsync(MailKit.MetadataCollection,System.Threading.CancellationToken)">
  57101. <summary>
  57102. Asynchronously sets the specified metadata.
  57103. </summary>
  57104. <remarks>
  57105. Asynchronously sets the specified metadata.
  57106. </remarks>
  57107. <returns>An asynchronous task context.</returns>
  57108. <param name="metadata">The metadata.</param>
  57109. <param name="cancellationToken">The cancellation token.</param>
  57110. <exception cref="T:System.ArgumentNullException">
  57111. <paramref name="metadata"/> is <c>null</c>.
  57112. </exception>
  57113. <exception cref="T:System.ObjectDisposedException">
  57114. The <see cref="T:MailKit.IMailStore"/> has been disposed.
  57115. </exception>
  57116. <exception cref="T:MailKit.ServiceNotConnectedException">
  57117. The <see cref="T:MailKit.IMailStore"/> is not connected.
  57118. </exception>
  57119. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  57120. The <see cref="T:MailKit.IMailStore"/> is not authenticated.
  57121. </exception>
  57122. <exception cref="T:System.NotSupportedException">
  57123. The folder does not support metadata.
  57124. </exception>
  57125. <exception cref="T:System.OperationCanceledException">
  57126. The operation was canceled via the cancellation token.
  57127. </exception>
  57128. <exception cref="T:System.IO.IOException">
  57129. An I/O error occurred.
  57130. </exception>
  57131. <exception cref="T:MailKit.ProtocolException">
  57132. The server's response contained unexpected tokens.
  57133. </exception>
  57134. <exception cref="T:MailKit.CommandException">
  57135. The command failed.
  57136. </exception>
  57137. </member>
  57138. <member name="E:MailKit.MailStore.Alert">
  57139. <summary>
  57140. Occurs when a remote message store receives an alert message from the server.
  57141. </summary>
  57142. <remarks>
  57143. The <see cref="E:MailKit.MailStore.Alert"/> event is raised whenever the mail server sends an
  57144. alert message.
  57145. </remarks>
  57146. </member>
  57147. <member name="M:MailKit.MailStore.OnAlert(System.String)">
  57148. <summary>
  57149. Raise the alert event.
  57150. </summary>
  57151. <remarks>
  57152. Raises the alert event.
  57153. </remarks>
  57154. <param name="message">The alert message.</param>
  57155. <exception cref="T:System.ArgumentNullException">
  57156. <paramref name="message"/> is <c>null</c>.
  57157. </exception>
  57158. </member>
  57159. <member name="E:MailKit.MailStore.FolderCreated">
  57160. <summary>
  57161. Occurs when a folder is created.
  57162. </summary>
  57163. <remarks>
  57164. The <see cref="E:MailKit.MailStore.FolderCreated"/> event is emitted when a new folder is created.
  57165. </remarks>
  57166. </member>
  57167. <member name="M:MailKit.MailStore.OnFolderCreated(MailKit.IMailFolder)">
  57168. <summary>
  57169. Raise the folder created event.
  57170. </summary>
  57171. <remarks>
  57172. Raises the folder created event.
  57173. </remarks>
  57174. <param name="folder">The folder that was just created.</param>
  57175. </member>
  57176. <member name="E:MailKit.MailStore.MetadataChanged">
  57177. <summary>
  57178. Occurs when metadata changes.
  57179. </summary>
  57180. <remarks>
  57181. The <see cref="E:MailKit.MailStore.MetadataChanged"/> event is emitted when metadata changes.
  57182. </remarks>
  57183. </member>
  57184. <member name="M:MailKit.MailStore.OnMetadataChanged(MailKit.Metadata)">
  57185. <summary>
  57186. Raise the metadata changed event.
  57187. </summary>
  57188. <remarks>
  57189. Raises the metadata changed event.
  57190. </remarks>
  57191. <param name="metadata">The metadata that changed.</param>
  57192. </member>
  57193. <member name="T:MailKit.MailTransport">
  57194. <summary>
  57195. An abstract mail transport implementation.
  57196. </summary>
  57197. <remarks>
  57198. An abstract mail transport implementation.
  57199. </remarks>
  57200. </member>
  57201. <member name="M:MailKit.MailTransport.#ctor(MailKit.IProtocolLogger)">
  57202. <summary>
  57203. Initializes a new instance of the <see cref="T:MailKit.MailTransport"/> class.
  57204. </summary>
  57205. <remarks>
  57206. Initializes a new instance of the <see cref="T:MailKit.MailTransport"/> class.
  57207. </remarks>
  57208. <param name="protocolLogger">The protocol logger.</param>
  57209. <exception cref="T:System.ArgumentNullException">
  57210. <paramref name="protocolLogger"/> is <c>null</c>.
  57211. </exception>
  57212. </member>
  57213. <member name="M:MailKit.MailTransport.Send(MimeKit.MimeMessage,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  57214. <summary>
  57215. Send the specified message.
  57216. </summary>
  57217. <remarks>
  57218. <para>Sends the specified message.</para>
  57219. <para>The sender address is determined by checking the following
  57220. message headers (in order of precedence): Resent-Sender,
  57221. Resent-From, Sender, and From.</para>
  57222. <para>If either the Resent-Sender or Resent-From addresses are present,
  57223. the recipients are collected from the Resent-To, Resent-Cc, and
  57224. Resent-Bcc headers, otherwise the To, Cc, and Bcc headers are used.</para>
  57225. </remarks>
  57226. <example>
  57227. <code language="c#" source="Examples\SmtpExamples.cs" region="SendMessage"/>
  57228. </example>
  57229. <param name="message">The message.</param>
  57230. <param name="cancellationToken">The cancellation token.</param>
  57231. <param name="progress">The progress reporting mechanism.</param>
  57232. <exception cref="T:System.ArgumentNullException">
  57233. <paramref name="message"/> is <c>null</c>.
  57234. </exception>
  57235. <exception cref="T:System.ObjectDisposedException">
  57236. The <see cref="T:MailKit.MailTransport"/> has been disposed.
  57237. </exception>
  57238. <exception cref="T:MailKit.ServiceNotConnectedException">
  57239. The <see cref="T:MailKit.MailTransport"/> is not connected.
  57240. </exception>
  57241. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  57242. Authentication is required before sending a message.
  57243. </exception>
  57244. <exception cref="T:System.InvalidOperationException">
  57245. <para>A sender has not been specified.</para>
  57246. <para>-or-</para>
  57247. <para>No recipients have been specified.</para>
  57248. </exception>
  57249. <exception cref="T:System.OperationCanceledException">
  57250. The operation has been canceled.
  57251. </exception>
  57252. <exception cref="T:System.IO.IOException">
  57253. An I/O error occurred.
  57254. </exception>
  57255. <exception cref="T:MailKit.CommandException">
  57256. The send command failed.
  57257. </exception>
  57258. <exception cref="T:MailKit.ProtocolException">
  57259. A protocol exception occurred.
  57260. </exception>
  57261. </member>
  57262. <member name="M:MailKit.MailTransport.SendAsync(MimeKit.MimeMessage,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  57263. <summary>
  57264. Asynchronously send the specified message.
  57265. </summary>
  57266. <remarks>
  57267. <para>Asynchronously sends the specified message.</para>
  57268. <para>The sender address is determined by checking the following
  57269. message headers (in order of precedence): Resent-Sender,
  57270. Resent-From, Sender, and From.</para>
  57271. <para>If either the Resent-Sender or Resent-From addresses are present,
  57272. the recipients are collected from the Resent-To, Resent-Cc, and
  57273. Resent-Bcc headers, otherwise the To, Cc, and Bcc headers are used.</para>
  57274. </remarks>
  57275. <returns>An asynchronous task context.</returns>
  57276. <param name="message">The message.</param>
  57277. <param name="cancellationToken">The cancellation token.</param>
  57278. <param name="progress">The progress reporting mechanism.</param>
  57279. <exception cref="T:System.ArgumentNullException">
  57280. <paramref name="message"/> is <c>null</c>.
  57281. </exception>
  57282. <exception cref="T:System.ObjectDisposedException">
  57283. The <see cref="T:MailKit.MailTransport"/> has been disposed.
  57284. </exception>
  57285. <exception cref="T:MailKit.ServiceNotConnectedException">
  57286. The <see cref="T:MailKit.MailTransport"/> is not connected.
  57287. </exception>
  57288. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  57289. Authentication is required before sending a message.
  57290. </exception>
  57291. <exception cref="T:System.InvalidOperationException">
  57292. <para>A sender has not been specified.</para>
  57293. <para>-or-</para>
  57294. <para>No recipients have been specified.</para>
  57295. </exception>
  57296. <exception cref="T:System.OperationCanceledException">
  57297. The operation has been canceled.
  57298. </exception>
  57299. <exception cref="T:System.IO.IOException">
  57300. An I/O error occurred.
  57301. </exception>
  57302. <exception cref="T:MailKit.CommandException">
  57303. The send command failed.
  57304. </exception>
  57305. <exception cref="T:MailKit.ProtocolException">
  57306. A protocol exception occurred.
  57307. </exception>
  57308. </member>
  57309. <member name="M:MailKit.MailTransport.Send(MimeKit.MimeMessage,MimeKit.MailboxAddress,System.Collections.Generic.IEnumerable{MimeKit.MailboxAddress},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  57310. <summary>
  57311. Send the specified message using the supplied sender and recipients.
  57312. </summary>
  57313. <remarks>
  57314. Sends the specified message using the supplied sender and recipients.
  57315. </remarks>
  57316. <param name="message">The message.</param>
  57317. <param name="sender">The mailbox address to use for sending the message.</param>
  57318. <param name="recipients">The mailbox addresses that should receive the message.</param>
  57319. <param name="cancellationToken">The cancellation token.</param>
  57320. <param name="progress">The progress reporting mechanism.</param>
  57321. <exception cref="T:System.ArgumentNullException">
  57322. <para><paramref name="message"/> is <c>null</c>.</para>
  57323. <para>-or-</para>
  57324. <para><paramref name="sender"/> is <c>null</c>.</para>
  57325. <para>-or-</para>
  57326. <para><paramref name="recipients"/> is <c>null</c>.</para>
  57327. </exception>
  57328. <exception cref="T:System.ObjectDisposedException">
  57329. The <see cref="T:MailKit.MailTransport"/> has been disposed.
  57330. </exception>
  57331. <exception cref="T:MailKit.ServiceNotConnectedException">
  57332. The <see cref="T:MailKit.MailTransport"/> is not connected.
  57333. </exception>
  57334. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  57335. Authentication is required before sending a message.
  57336. </exception>
  57337. <exception cref="T:System.InvalidOperationException">
  57338. <para>A sender has not been specified.</para>
  57339. <para>-or-</para>
  57340. <para>No recipients have been specified.</para>
  57341. </exception>
  57342. <exception cref="T:System.OperationCanceledException">
  57343. The operation has been canceled.
  57344. </exception>
  57345. <exception cref="T:System.IO.IOException">
  57346. An I/O error occurred.
  57347. </exception>
  57348. <exception cref="T:MailKit.CommandException">
  57349. The send command failed.
  57350. </exception>
  57351. <exception cref="T:MailKit.ProtocolException">
  57352. A protocol exception occurred.
  57353. </exception>
  57354. </member>
  57355. <member name="M:MailKit.MailTransport.SendAsync(MimeKit.MimeMessage,MimeKit.MailboxAddress,System.Collections.Generic.IEnumerable{MimeKit.MailboxAddress},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  57356. <summary>
  57357. Asynchronously send the specified message using the supplied sender and recipients.
  57358. </summary>
  57359. <remarks>
  57360. Asynchronously sends the specified message using the supplied sender and recipients.
  57361. </remarks>
  57362. <returns>An asynchronous task context.</returns>
  57363. <param name="message">The message.</param>
  57364. <param name="sender">The mailbox address to use for sending the message.</param>
  57365. <param name="recipients">The mailbox addresses that should receive the message.</param>
  57366. <param name="cancellationToken">The cancellation token.</param>
  57367. <param name="progress">The progress reporting mechanism.</param>
  57368. <exception cref="T:System.ArgumentNullException">
  57369. <para><paramref name="message"/> is <c>null</c>.</para>
  57370. <para>-or-</para>
  57371. <para><paramref name="sender"/> is <c>null</c>.</para>
  57372. <para>-or-</para>
  57373. <para><paramref name="recipients"/> is <c>null</c>.</para>
  57374. </exception>
  57375. <exception cref="T:System.ObjectDisposedException">
  57376. The <see cref="T:MailKit.MailTransport"/> has been disposed.
  57377. </exception>
  57378. <exception cref="T:MailKit.ServiceNotConnectedException">
  57379. The <see cref="T:MailKit.MailTransport"/> is not connected.
  57380. </exception>
  57381. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  57382. Authentication is required before sending a message.
  57383. </exception>
  57384. <exception cref="T:System.InvalidOperationException">
  57385. <para>A sender has not been specified.</para>
  57386. <para>-or-</para>
  57387. <para>No recipients have been specified.</para>
  57388. </exception>
  57389. <exception cref="T:System.OperationCanceledException">
  57390. The operation has been canceled.
  57391. </exception>
  57392. <exception cref="T:System.IO.IOException">
  57393. An I/O error occurred.
  57394. </exception>
  57395. <exception cref="T:MailKit.CommandException">
  57396. The send command failed.
  57397. </exception>
  57398. <exception cref="T:MailKit.ProtocolException">
  57399. A protocol exception occurred.
  57400. </exception>
  57401. </member>
  57402. <member name="M:MailKit.MailTransport.Send(MimeKit.FormatOptions,MimeKit.MimeMessage,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  57403. <summary>
  57404. Send the specified message.
  57405. </summary>
  57406. <remarks>
  57407. <para>Sends the specified message.</para>
  57408. <para>The sender address is determined by checking the following
  57409. message headers (in order of precedence): Resent-Sender,
  57410. Resent-From, Sender, and From.</para>
  57411. <para>If either the Resent-Sender or Resent-From addresses are present,
  57412. the recipients are collected from the Resent-To, Resent-Cc, and
  57413. Resent-Bcc headers, otherwise the To, Cc, and Bcc headers are used.</para>
  57414. </remarks>
  57415. <example>
  57416. <code language="c#" source="Examples\SmtpExamples.cs" region="SendMessageWithOptions"/>
  57417. </example>
  57418. <param name="options">The formatting options.</param>
  57419. <param name="message">The message.</param>
  57420. <param name="cancellationToken">The cancellation token.</param>
  57421. <param name="progress">The progress reporting mechanism.</param>
  57422. <exception cref="T:System.ArgumentNullException">
  57423. <para><paramref name="options"/> is <c>null</c>.</para>
  57424. <para>-or-</para>
  57425. <para><paramref name="message"/> is <c>null</c>.</para>
  57426. </exception>
  57427. <exception cref="T:System.ObjectDisposedException">
  57428. The <see cref="T:MailKit.MailTransport"/> has been disposed.
  57429. </exception>
  57430. <exception cref="T:MailKit.ServiceNotConnectedException">
  57431. The <see cref="T:MailKit.MailTransport"/> is not connected.
  57432. </exception>
  57433. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  57434. Authentication is required before sending a message.
  57435. </exception>
  57436. <exception cref="T:System.InvalidOperationException">
  57437. <para>A sender has not been specified.</para>
  57438. <para>-or-</para>
  57439. <para>No recipients have been specified.</para>
  57440. </exception>
  57441. <exception cref="T:System.OperationCanceledException">
  57442. The operation has been canceled.
  57443. </exception>
  57444. <exception cref="T:System.NotSupportedException">
  57445. <para>Internationalized formatting was requested but is not supported by the transport.</para>
  57446. </exception>
  57447. <exception cref="T:System.IO.IOException">
  57448. An I/O error occurred.
  57449. </exception>
  57450. <exception cref="T:MailKit.CommandException">
  57451. The send command failed.
  57452. </exception>
  57453. <exception cref="T:MailKit.ProtocolException">
  57454. A protocol exception occurred.
  57455. </exception>
  57456. </member>
  57457. <member name="M:MailKit.MailTransport.SendAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,System.Threading.CancellationToken,MailKit.ITransferProgress)">
  57458. <summary>
  57459. Asynchronously send the specified message.
  57460. </summary>
  57461. <remarks>
  57462. <para>Asynchronously sends the specified message.</para>
  57463. <para>The sender address is determined by checking the following
  57464. message headers (in order of precedence): Resent-Sender,
  57465. Resent-From, Sender, and From.</para>
  57466. <para>If either the Resent-Sender or Resent-From addresses are present,
  57467. the recipients are collected from the Resent-To, Resent-Cc, and
  57468. Resent-Bcc headers, otherwise the To, Cc, and Bcc headers are used.</para>
  57469. </remarks>
  57470. <returns>An asynchronous task context.</returns>
  57471. <param name="options">The formatting options.</param>
  57472. <param name="message">The message.</param>
  57473. <param name="cancellationToken">The cancellation token.</param>
  57474. <param name="progress">The progress reporting mechanism.</param>
  57475. <exception cref="T:System.ArgumentNullException">
  57476. <para><paramref name="options"/> is <c>null</c>.</para>
  57477. <para>-or-</para>
  57478. <para><paramref name="message"/> is <c>null</c>.</para>
  57479. </exception>
  57480. <exception cref="T:System.ObjectDisposedException">
  57481. The <see cref="T:MailKit.MailTransport"/> has been disposed.
  57482. </exception>
  57483. <exception cref="T:MailKit.ServiceNotConnectedException">
  57484. The <see cref="T:MailKit.MailTransport"/> is not connected.
  57485. </exception>
  57486. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  57487. Authentication is required before sending a message.
  57488. </exception>
  57489. <exception cref="T:System.InvalidOperationException">
  57490. <para>A sender has not been specified.</para>
  57491. <para>-or-</para>
  57492. <para>No recipients have been specified.</para>
  57493. </exception>
  57494. <exception cref="T:System.OperationCanceledException">
  57495. The operation has been canceled.
  57496. </exception>
  57497. <exception cref="T:System.NotSupportedException">
  57498. <para>Internationalized formatting was requested but is not supported by the transport.</para>
  57499. </exception>
  57500. <exception cref="T:System.IO.IOException">
  57501. An I/O error occurred.
  57502. </exception>
  57503. <exception cref="T:MailKit.CommandException">
  57504. The send command failed.
  57505. </exception>
  57506. <exception cref="T:MailKit.ProtocolException">
  57507. A protocol exception occurred.
  57508. </exception>
  57509. </member>
  57510. <member name="M:MailKit.MailTransport.Send(MimeKit.FormatOptions,MimeKit.MimeMessage,MimeKit.MailboxAddress,System.Collections.Generic.IEnumerable{MimeKit.MailboxAddress},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  57511. <summary>
  57512. Send the specified message using the supplied sender and recipients.
  57513. </summary>
  57514. <remarks>
  57515. Sends the specified message using the supplied sender and recipients.
  57516. </remarks>
  57517. <param name="options">The formatting options.</param>
  57518. <param name="message">The message.</param>
  57519. <param name="sender">The mailbox address to use for sending the message.</param>
  57520. <param name="recipients">The mailbox addresses that should receive the message.</param>
  57521. <param name="cancellationToken">The cancellation token.</param>
  57522. <param name="progress">The progress reporting mechanism.</param>
  57523. <exception cref="T:System.ArgumentNullException">
  57524. <para><paramref name="options"/> is <c>null</c>.</para>
  57525. <para>-or-</para>
  57526. <para><paramref name="message"/> is <c>null</c>.</para>
  57527. <para>-or-</para>
  57528. <para><paramref name="sender"/> is <c>null</c>.</para>
  57529. <para>-or-</para>
  57530. <para><paramref name="recipients"/> is <c>null</c>.</para>
  57531. </exception>
  57532. <exception cref="T:System.ObjectDisposedException">
  57533. The <see cref="T:MailKit.MailTransport"/> has been disposed.
  57534. </exception>
  57535. <exception cref="T:MailKit.ServiceNotConnectedException">
  57536. The <see cref="T:MailKit.MailTransport"/> is not connected.
  57537. </exception>
  57538. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  57539. Authentication is required before sending a message.
  57540. </exception>
  57541. <exception cref="T:System.InvalidOperationException">
  57542. <para>A sender has not been specified.</para>
  57543. <para>-or-</para>
  57544. <para>No recipients have been specified.</para>
  57545. </exception>
  57546. <exception cref="T:System.OperationCanceledException">
  57547. The operation has been canceled.
  57548. </exception>
  57549. <exception cref="T:System.NotSupportedException">
  57550. <para>Internationalized formatting was requested but is not supported by the transport.</para>
  57551. </exception>
  57552. <exception cref="T:System.IO.IOException">
  57553. An I/O error occurred.
  57554. </exception>
  57555. <exception cref="T:MailKit.CommandException">
  57556. The send command failed.
  57557. </exception>
  57558. <exception cref="T:MailKit.ProtocolException">
  57559. A protocol exception occurred.
  57560. </exception>
  57561. </member>
  57562. <member name="M:MailKit.MailTransport.SendAsync(MimeKit.FormatOptions,MimeKit.MimeMessage,MimeKit.MailboxAddress,System.Collections.Generic.IEnumerable{MimeKit.MailboxAddress},System.Threading.CancellationToken,MailKit.ITransferProgress)">
  57563. <summary>
  57564. Asynchronously send the specified message using the supplied sender and recipients.
  57565. </summary>
  57566. <remarks>
  57567. Asynchronously sends the specified message using the supplied sender and recipients.
  57568. </remarks>
  57569. <returns>An asynchronous task context.</returns>
  57570. <param name="options">The formatting options.</param>
  57571. <param name="message">The message.</param>
  57572. <param name="sender">The mailbox address to use for sending the message.</param>
  57573. <param name="recipients">The mailbox addresses that should receive the message.</param>
  57574. <param name="cancellationToken">The cancellation token.</param>
  57575. <param name="progress">The progress reporting mechanism.</param>
  57576. <exception cref="T:System.ArgumentNullException">
  57577. <para><paramref name="options"/> is <c>null</c>.</para>
  57578. <para>-or-</para>
  57579. <para><paramref name="message"/> is <c>null</c>.</para>
  57580. <para>-or-</para>
  57581. <para><paramref name="sender"/> is <c>null</c>.</para>
  57582. <para>-or-</para>
  57583. <para><paramref name="recipients"/> is <c>null</c>.</para>
  57584. </exception>
  57585. <exception cref="T:System.ObjectDisposedException">
  57586. The <see cref="T:MailKit.MailTransport"/> has been disposed.
  57587. </exception>
  57588. <exception cref="T:MailKit.ServiceNotConnectedException">
  57589. The <see cref="T:MailKit.MailTransport"/> is not connected.
  57590. </exception>
  57591. <exception cref="T:MailKit.ServiceNotAuthenticatedException">
  57592. Authentication is required before sending a message.
  57593. </exception>
  57594. <exception cref="T:System.InvalidOperationException">
  57595. <para>A sender has not been specified.</para>
  57596. <para>-or-</para>
  57597. <para>No recipients have been specified.</para>
  57598. </exception>
  57599. <exception cref="T:System.OperationCanceledException">
  57600. The operation has been canceled.
  57601. </exception>
  57602. <exception cref="T:System.NotSupportedException">
  57603. <para>Internationalized formatting was requested but is not supported by the transport.</para>
  57604. </exception>
  57605. <exception cref="T:System.IO.IOException">
  57606. An I/O error occurred.
  57607. </exception>
  57608. <exception cref="T:MailKit.CommandException">
  57609. The send command failed.
  57610. </exception>
  57611. <exception cref="T:MailKit.ProtocolException">
  57612. A protocol exception occurred.
  57613. </exception>
  57614. </member>
  57615. <member name="E:MailKit.MailTransport.MessageSent">
  57616. <summary>
  57617. Occurs when a message is successfully sent via the transport.
  57618. </summary>
  57619. <remarks>
  57620. The <see cref="E:MailKit.MailTransport.MessageSent"/> event will be emitted each time a message is successfully sent.
  57621. </remarks>
  57622. </member>
  57623. <member name="M:MailKit.MailTransport.OnMessageSent(MailKit.MessageSentEventArgs)">
  57624. <summary>
  57625. Raise the message sent event.
  57626. </summary>
  57627. <remarks>
  57628. Raises the message sent event.
  57629. </remarks>
  57630. <param name="e">The message sent event args.</param>
  57631. </member>
  57632. <member name="T:MailKit.MessageEventArgs">
  57633. <summary>
  57634. Event args used when the state of a message changes.
  57635. </summary>
  57636. <remarks>
  57637. Event args used when the state of a message changes.
  57638. </remarks>
  57639. </member>
  57640. <member name="M:MailKit.MessageEventArgs.#ctor(System.Int32)">
  57641. <summary>
  57642. Initializes a new instance of the <see cref="T:MailKit.MessageEventArgs"/> class.
  57643. </summary>
  57644. <remarks>
  57645. Creates a new <see cref="T:MailKit.MessageEventArgs"/>.
  57646. </remarks>
  57647. <param name="index">The message index.</param>
  57648. <exception cref="T:System.ArgumentOutOfRangeException">
  57649. <paramref name="index"/> is out of range.
  57650. </exception>
  57651. </member>
  57652. <member name="M:MailKit.MessageEventArgs.#ctor(System.Int32,MailKit.UniqueId)">
  57653. <summary>
  57654. Initializes a new instance of the <see cref="T:MailKit.MessageEventArgs"/> class.
  57655. </summary>
  57656. <remarks>
  57657. Creates a new <see cref="T:MailKit.MessageEventArgs"/>.
  57658. </remarks>
  57659. <param name="index">The message index.</param>
  57660. <param name="uid">The unique id of the message.</param>
  57661. <exception cref="T:System.ArgumentOutOfRangeException">
  57662. <paramref name="index"/> is out of range.
  57663. </exception>
  57664. </member>
  57665. <member name="P:MailKit.MessageEventArgs.Index">
  57666. <summary>
  57667. Gets the index of the message that changed.
  57668. </summary>
  57669. <remarks>
  57670. Gets the index of the message that changed.
  57671. </remarks>
  57672. <value>The index of the message.</value>
  57673. </member>
  57674. <member name="P:MailKit.MessageEventArgs.UniqueId">
  57675. <summary>
  57676. Gets the unique ID of the message that changed, if available.
  57677. </summary>
  57678. <remarks>
  57679. Gets the unique ID of the message that changed, if available.
  57680. </remarks>
  57681. <value>The unique ID of the message.</value>
  57682. </member>
  57683. <member name="T:MailKit.MessageFlags">
  57684. <summary>
  57685. An enumeration of message flags.
  57686. </summary>
  57687. <remarks>
  57688. An enumeration of message flags.
  57689. </remarks>
  57690. </member>
  57691. <member name="F:MailKit.MessageFlags.None">
  57692. <summary>
  57693. No message flags are set.
  57694. </summary>
  57695. </member>
  57696. <member name="F:MailKit.MessageFlags.Seen">
  57697. <summary>
  57698. The message has been read.
  57699. </summary>
  57700. </member>
  57701. <member name="F:MailKit.MessageFlags.Answered">
  57702. <summary>
  57703. The message has been answered (replied to).
  57704. </summary>
  57705. </member>
  57706. <member name="F:MailKit.MessageFlags.Flagged">
  57707. <summary>
  57708. The message has been flagged for importance.
  57709. </summary>
  57710. </member>
  57711. <member name="F:MailKit.MessageFlags.Deleted">
  57712. <summary>
  57713. The message has been marked for deletion.
  57714. </summary>
  57715. </member>
  57716. <member name="F:MailKit.MessageFlags.Draft">
  57717. <summary>
  57718. The message is marked as a draft.
  57719. </summary>
  57720. </member>
  57721. <member name="F:MailKit.MessageFlags.Recent">
  57722. <summary>
  57723. The message has just recently arrived in the folder.
  57724. </summary>
  57725. </member>
  57726. <member name="F:MailKit.MessageFlags.UserDefined">
  57727. <summary>
  57728. User-defined flags are allowed by the folder.
  57729. </summary>
  57730. </member>
  57731. <member name="T:MailKit.MessageFlagsChangedEventArgs">
  57732. <summary>
  57733. Event args for the <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> event.
  57734. </summary>
  57735. <remarks>
  57736. Event args for the <see cref="E:MailKit.IMailFolder.MessageFlagsChanged"/> event.
  57737. </remarks>
  57738. </member>
  57739. <member name="M:MailKit.MessageFlagsChangedEventArgs.#ctor(System.Int32)">
  57740. <summary>
  57741. Initializes a new instance of the <see cref="T:MailKit.MessageFlagsChangedEventArgs"/> class.
  57742. </summary>
  57743. <remarks>
  57744. Creates a new <see cref="T:MailKit.MessageFlagsChangedEventArgs"/>.
  57745. </remarks>
  57746. <param name="index">The message index.</param>
  57747. </member>
  57748. <member name="M:MailKit.MessageFlagsChangedEventArgs.#ctor(System.Int32,MailKit.MessageFlags)">
  57749. <summary>
  57750. Initializes a new instance of the <see cref="T:MailKit.MessageFlagsChangedEventArgs"/> class.
  57751. </summary>
  57752. <remarks>
  57753. Creates a new <see cref="T:MailKit.MessageFlagsChangedEventArgs"/>.
  57754. </remarks>
  57755. <param name="index">The message index.</param>
  57756. <param name="flags">The message flags.</param>
  57757. </member>
  57758. <member name="M:MailKit.MessageFlagsChangedEventArgs.#ctor(System.Int32,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String})">
  57759. <summary>
  57760. Initializes a new instance of the <see cref="T:MailKit.MessageFlagsChangedEventArgs"/> class.
  57761. </summary>
  57762. <remarks>
  57763. Creates a new <see cref="T:MailKit.MessageFlagsChangedEventArgs"/>.
  57764. </remarks>
  57765. <param name="index">The message index.</param>
  57766. <param name="flags">The message flags.</param>
  57767. <param name="keywords">The user-defined message flags.</param>
  57768. <exception cref="T:System.ArgumentNullException">
  57769. <paramref name="keywords"/> is <c>null</c>.
  57770. </exception>
  57771. <exception cref="T:System.ArgumentOutOfRangeException">
  57772. <paramref name="index"/> is out of range.
  57773. </exception>
  57774. </member>
  57775. <member name="M:MailKit.MessageFlagsChangedEventArgs.#ctor(System.Int32,MailKit.MessageFlags,System.UInt64)">
  57776. <summary>
  57777. Initializes a new instance of the <see cref="T:MailKit.MessageFlagsChangedEventArgs"/> class.
  57778. </summary>
  57779. <remarks>
  57780. Creates a new <see cref="T:MailKit.MessageFlagsChangedEventArgs"/>.
  57781. </remarks>
  57782. <param name="index">The message index.</param>
  57783. <param name="flags">The message flags.</param>
  57784. <param name="modseq">The modification sequence value.</param>
  57785. <exception cref="T:System.ArgumentOutOfRangeException">
  57786. <paramref name="index"/> is out of range.
  57787. </exception>
  57788. </member>
  57789. <member name="M:MailKit.MessageFlagsChangedEventArgs.#ctor(System.Int32,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.UInt64)">
  57790. <summary>
  57791. Initializes a new instance of the <see cref="T:MailKit.MessageFlagsChangedEventArgs"/> class.
  57792. </summary>
  57793. <remarks>
  57794. Creates a new <see cref="T:MailKit.MessageFlagsChangedEventArgs"/>.
  57795. </remarks>
  57796. <param name="index">The message index.</param>
  57797. <param name="flags">The message flags.</param>
  57798. <param name="keywords">The user-defined message flags.</param>
  57799. <param name="modseq">The modification sequence value.</param>
  57800. <exception cref="T:System.ArgumentNullException">
  57801. <paramref name="keywords"/> is <c>null</c>.
  57802. </exception>
  57803. <exception cref="T:System.ArgumentOutOfRangeException">
  57804. <paramref name="index"/> is out of range.
  57805. </exception>
  57806. </member>
  57807. <member name="M:MailKit.MessageFlagsChangedEventArgs.#ctor(System.Int32,MailKit.UniqueId,MailKit.MessageFlags)">
  57808. <summary>
  57809. Initializes a new instance of the <see cref="T:MailKit.MessageFlagsChangedEventArgs"/> class.
  57810. </summary>
  57811. <remarks>
  57812. Creates a new <see cref="T:MailKit.MessageFlagsChangedEventArgs"/>.
  57813. </remarks>
  57814. <param name="index">The message index.</param>
  57815. <param name="uid">The unique id of the message.</param>
  57816. <param name="flags">The message flags.</param>
  57817. <exception cref="T:System.ArgumentOutOfRangeException">
  57818. <paramref name="index"/> is out of range.
  57819. </exception>
  57820. </member>
  57821. <member name="M:MailKit.MessageFlagsChangedEventArgs.#ctor(System.Int32,MailKit.UniqueId,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String})">
  57822. <summary>
  57823. Initializes a new instance of the <see cref="T:MailKit.MessageFlagsChangedEventArgs"/> class.
  57824. </summary>
  57825. <remarks>
  57826. Creates a new <see cref="T:MailKit.MessageFlagsChangedEventArgs"/>.
  57827. </remarks>
  57828. <param name="index">The message index.</param>
  57829. <param name="uid">The unique id of the message.</param>
  57830. <param name="flags">The message flags.</param>
  57831. <param name="keywords">The user-defined message flags.</param>
  57832. <exception cref="T:System.ArgumentNullException">
  57833. <paramref name="keywords"/> is <c>null</c>.
  57834. </exception>
  57835. <exception cref="T:System.ArgumentOutOfRangeException">
  57836. <paramref name="index"/> is out of range.
  57837. </exception>
  57838. </member>
  57839. <member name="M:MailKit.MessageFlagsChangedEventArgs.#ctor(System.Int32,MailKit.UniqueId,MailKit.MessageFlags,System.UInt64)">
  57840. <summary>
  57841. Initializes a new instance of the <see cref="T:MailKit.MessageFlagsChangedEventArgs"/> class.
  57842. </summary>
  57843. <remarks>
  57844. Creates a new <see cref="T:MailKit.MessageFlagsChangedEventArgs"/>.
  57845. </remarks>
  57846. <param name="index">The message index.</param>
  57847. <param name="uid">The unique id of the message.</param>
  57848. <param name="flags">The message flags.</param>
  57849. <param name="modseq">The modification sequence value.</param>
  57850. <exception cref="T:System.ArgumentOutOfRangeException">
  57851. <paramref name="index"/> is out of range.
  57852. </exception>
  57853. </member>
  57854. <member name="M:MailKit.MessageFlagsChangedEventArgs.#ctor(System.Int32,MailKit.UniqueId,MailKit.MessageFlags,System.Collections.Generic.HashSet{System.String},System.UInt64)">
  57855. <summary>
  57856. Initializes a new instance of the <see cref="T:MailKit.MessageFlagsChangedEventArgs"/> class.
  57857. </summary>
  57858. <remarks>
  57859. Creates a new <see cref="T:MailKit.MessageFlagsChangedEventArgs"/>.
  57860. </remarks>
  57861. <param name="index">The message index.</param>
  57862. <param name="uid">The unique id of the message.</param>
  57863. <param name="flags">The message flags.</param>
  57864. <param name="keywords">The user-defined message flags.</param>
  57865. <param name="modseq">The modification sequence value.</param>
  57866. <exception cref="T:System.ArgumentNullException">
  57867. <paramref name="keywords"/> is <c>null</c>.
  57868. </exception>
  57869. <exception cref="T:System.ArgumentOutOfRangeException">
  57870. <paramref name="index"/> is out of range.
  57871. </exception>
  57872. </member>
  57873. <member name="P:MailKit.MessageFlagsChangedEventArgs.Flags">
  57874. <summary>
  57875. Gets the updated message flags.
  57876. </summary>
  57877. <remarks>
  57878. Gets the updated message flags.
  57879. </remarks>
  57880. <value>The updated message flags.</value>
  57881. </member>
  57882. <member name="P:MailKit.MessageFlagsChangedEventArgs.Keywords">
  57883. <summary>
  57884. Gets the updated user-defined message flags.
  57885. </summary>
  57886. <remarks>
  57887. Gets the updated user-defined message flags.
  57888. </remarks>
  57889. <value>The updated user-defined message flags.</value>
  57890. </member>
  57891. <member name="P:MailKit.MessageFlagsChangedEventArgs.UserFlags">
  57892. <summary>
  57893. Gets the updated user-defined message flags.
  57894. </summary>
  57895. <remarks>
  57896. Gets the updated user-defined message flags.
  57897. </remarks>
  57898. <value>The updated user-defined message flags.</value>
  57899. </member>
  57900. <member name="P:MailKit.MessageFlagsChangedEventArgs.ModSeq">
  57901. <summary>
  57902. Gets the updated mod-sequence value of the message, if available.
  57903. </summary>
  57904. <remarks>
  57905. Gets the updated mod-sequence value of the message, if available.
  57906. </remarks>
  57907. <value>The mod-sequence value.</value>
  57908. </member>
  57909. <member name="T:MailKit.MessageLabelsChangedEventArgs">
  57910. <summary>
  57911. Event args for the <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> event.
  57912. </summary>
  57913. <remarks>
  57914. Event args for the <see cref="E:MailKit.IMailFolder.MessageLabelsChanged"/> event.
  57915. </remarks>
  57916. </member>
  57917. <member name="M:MailKit.MessageLabelsChangedEventArgs.#ctor(System.Int32)">
  57918. <summary>
  57919. Initializes a new instance of the <see cref="T:MailKit.MessageLabelsChangedEventArgs"/> class.
  57920. </summary>
  57921. <remarks>
  57922. Creates a new <see cref="T:MailKit.MessageLabelsChangedEventArgs"/>.
  57923. </remarks>
  57924. <param name="index">The message index.</param>
  57925. <exception cref="T:System.ArgumentOutOfRangeException">
  57926. <paramref name="index"/> is out of range.
  57927. </exception>
  57928. </member>
  57929. <member name="M:MailKit.MessageLabelsChangedEventArgs.#ctor(System.Int32,System.Collections.Generic.IList{System.String})">
  57930. <summary>
  57931. Initializes a new instance of the <see cref="T:MailKit.MessageLabelsChangedEventArgs"/> class.
  57932. </summary>
  57933. <remarks>
  57934. Creates a new <see cref="T:MailKit.MessageLabelsChangedEventArgs"/>.
  57935. </remarks>
  57936. <param name="index">The message index.</param>
  57937. <param name="labels">The message labels.</param>
  57938. <exception cref="T:System.ArgumentNullException">
  57939. <paramref name="labels"/> is <c>null</c>.
  57940. </exception>
  57941. <exception cref="T:System.ArgumentOutOfRangeException">
  57942. <paramref name="index"/> is out of range.
  57943. </exception>
  57944. </member>
  57945. <member name="M:MailKit.MessageLabelsChangedEventArgs.#ctor(System.Int32,System.Collections.Generic.IList{System.String},System.UInt64)">
  57946. <summary>
  57947. Initializes a new instance of the <see cref="T:MailKit.MessageLabelsChangedEventArgs"/> class.
  57948. </summary>
  57949. <remarks>
  57950. Creates a new <see cref="T:MailKit.MessageLabelsChangedEventArgs"/>.
  57951. </remarks>
  57952. <param name="index">The message index.</param>
  57953. <param name="labels">The message labels.</param>
  57954. <param name="modseq">The modification sequence value.</param>
  57955. <exception cref="T:System.ArgumentNullException">
  57956. <paramref name="labels"/> is <c>null</c>.
  57957. </exception>
  57958. <exception cref="T:System.ArgumentOutOfRangeException">
  57959. <paramref name="index"/> is out of range.
  57960. </exception>
  57961. </member>
  57962. <member name="M:MailKit.MessageLabelsChangedEventArgs.#ctor(System.Int32,MailKit.UniqueId,System.Collections.Generic.IList{System.String})">
  57963. <summary>
  57964. Initializes a new instance of the <see cref="T:MailKit.MessageLabelsChangedEventArgs"/> class.
  57965. </summary>
  57966. <remarks>
  57967. Creates a new <see cref="T:MailKit.MessageLabelsChangedEventArgs"/>.
  57968. </remarks>
  57969. <param name="index">The message index.</param>
  57970. <param name="uid">The unique id of the message.</param>
  57971. <param name="labels">The message labels.</param>
  57972. <exception cref="T:System.ArgumentNullException">
  57973. <paramref name="labels"/> is <c>null</c>.
  57974. </exception>
  57975. <exception cref="T:System.ArgumentOutOfRangeException">
  57976. <paramref name="index"/> is out of range.
  57977. </exception>
  57978. </member>
  57979. <member name="M:MailKit.MessageLabelsChangedEventArgs.#ctor(System.Int32,MailKit.UniqueId,System.Collections.Generic.IList{System.String},System.UInt64)">
  57980. <summary>
  57981. Initializes a new instance of the <see cref="T:MailKit.MessageLabelsChangedEventArgs"/> class.
  57982. </summary>
  57983. <remarks>
  57984. Creates a new <see cref="T:MailKit.MessageLabelsChangedEventArgs"/>.
  57985. </remarks>
  57986. <param name="index">The message index.</param>
  57987. <param name="uid">The unique id of the message.</param>
  57988. <param name="labels">The message labels.</param>
  57989. <param name="modseq">The modification sequence value.</param>
  57990. <exception cref="T:System.ArgumentNullException">
  57991. <paramref name="labels"/> is <c>null</c>.
  57992. </exception>
  57993. <exception cref="T:System.ArgumentOutOfRangeException">
  57994. <paramref name="index"/> is out of range.
  57995. </exception>
  57996. </member>
  57997. <member name="P:MailKit.MessageLabelsChangedEventArgs.Labels">
  57998. <summary>
  57999. Gets the updated labels.
  58000. </summary>
  58001. <remarks>
  58002. Gets the updated labels.
  58003. </remarks>
  58004. <value>The updated labels.</value>
  58005. </member>
  58006. <member name="P:MailKit.MessageLabelsChangedEventArgs.ModSeq">
  58007. <summary>
  58008. Gets the updated mod-sequence value of the message, if available.
  58009. </summary>
  58010. <remarks>
  58011. Gets the updated mod-sequence value of the message, if available.
  58012. </remarks>
  58013. <value>The mod-sequence value.</value>
  58014. </member>
  58015. <member name="T:MailKit.MessageNotFoundException">
  58016. <summary>
  58017. The exception that is thrown when a message (or body part) could not be found.
  58018. </summary>
  58019. <remarks>
  58020. This exception is thrown by methods such as
  58021. <a href="Overload_MailKit_IMailFolder_GetMessage.htm">IMailFolder.GetMessage</a>,
  58022. <a href="Overload_MailKit_IMailFolder_GetBodyPart.htm">IMailFolder.GetBodyPart</a>, or
  58023. <a href="Overload_MailKit_IMailFolder_GetStream.htm">IMailFolder.GetStream</a>
  58024. when the server's response does not contain the message, body part, or stream data requested.
  58025. </remarks>
  58026. </member>
  58027. <member name="M:MailKit.MessageNotFoundException.#ctor(System.String,System.Exception)">
  58028. <summary>
  58029. Initializes a new instance of the <see cref="T:MailKit.MessageNotFoundException"/> class.
  58030. </summary>
  58031. <remarks>
  58032. Creates a new <see cref="T:MailKit.MessageNotFoundException"/>.
  58033. </remarks>
  58034. <param name="message">The error message.</param>
  58035. <param name="innerException">The inner exception.</param>
  58036. <exception cref="T:System.ArgumentNullException">
  58037. </exception>
  58038. </member>
  58039. <member name="M:MailKit.MessageNotFoundException.#ctor(System.String)">
  58040. <summary>
  58041. Initializes a new instance of the <see cref="T:MailKit.MessageNotFoundException"/> class.
  58042. </summary>
  58043. <remarks>
  58044. Creates a new <see cref="T:MailKit.MessageNotFoundException"/>.
  58045. </remarks>
  58046. <param name="message">The error message.</param>
  58047. </member>
  58048. <member name="T:MailKit.MessageSentEventArgs">
  58049. <summary>
  58050. Event args used when a message is successfully sent.
  58051. </summary>
  58052. <remarks>
  58053. Event args used when message is successfully sent.
  58054. </remarks>
  58055. </member>
  58056. <member name="M:MailKit.MessageSentEventArgs.#ctor(MimeKit.MimeMessage,System.String)">
  58057. <summary>
  58058. Initializes a new instance of the <see cref="T:MailKit.MessageSentEventArgs"/> class.
  58059. </summary>
  58060. <remarks>
  58061. Creates a new <see cref="T:MailKit.MessageSentEventArgs"/>.
  58062. </remarks>
  58063. <param name="message">The message that was just sent.</param>
  58064. <param name="response">The response from the server.</param>
  58065. <exception cref="T:System.ArgumentNullException">
  58066. <para><paramref name="message"/> is <c>null</c>.</para>
  58067. <para>-or-</para>
  58068. <para><paramref name="response"/> is <c>null</c>.</para>
  58069. </exception>
  58070. </member>
  58071. <member name="P:MailKit.MessageSentEventArgs.Message">
  58072. <summary>
  58073. Get the message that was just sent.
  58074. </summary>
  58075. <remarks>
  58076. Gets the message that was just sent.
  58077. </remarks>
  58078. <value>The message.</value>
  58079. </member>
  58080. <member name="P:MailKit.MessageSentEventArgs.Response">
  58081. <summary>
  58082. Get the server's response.
  58083. </summary>
  58084. <remarks>
  58085. Gets the server's response.
  58086. </remarks>
  58087. <value>The response.</value>
  58088. </member>
  58089. <member name="T:MailKit.MessageSorter">
  58090. <summary>
  58091. Routines for sorting messages.
  58092. </summary>
  58093. <remarks>
  58094. Routines for sorting messages.
  58095. </remarks>
  58096. </member>
  58097. <member name="M:MailKit.MessageSorter.Sort``1(System.Collections.Generic.IEnumerable{``0},System.Collections.Generic.IList{MailKit.Search.OrderBy})">
  58098. <summary>
  58099. Sorts the messages by the specified ordering.
  58100. </summary>
  58101. <remarks>
  58102. Sorts the messages by the specified ordering.
  58103. </remarks>
  58104. <returns>The sorted messages.</returns>
  58105. <typeparam name="T">The message items must implement the <see cref="T:MailKit.IMessageSummary"/> interface.</typeparam>
  58106. <param name="messages">The messages to sort.</param>
  58107. <param name="orderBy">The sort ordering.</param>
  58108. <exception cref="T:System.ArgumentNullException">
  58109. <para><paramref name="messages"/> is <c>null</c>.</para>
  58110. <para>-or-</para>
  58111. <para><paramref name="orderBy"/> is <c>null</c>.</para>
  58112. </exception>
  58113. <exception cref="T:System.ArgumentException">
  58114. <para><paramref name="messages"/> contains one or more items that is missing information needed for sorting.</para>
  58115. <para>-or-</para>
  58116. <para><paramref name="orderBy"/> is an empty list.</para>
  58117. </exception>
  58118. </member>
  58119. <member name="M:MailKit.MessageSorter.Sort``1(System.Collections.Generic.List{``0},System.Collections.Generic.IList{MailKit.Search.OrderBy})">
  58120. <summary>
  58121. Sorts the messages by the specified ordering.
  58122. </summary>
  58123. <remarks>
  58124. Sorts the messages by the specified ordering.
  58125. </remarks>
  58126. <returns>The sorted messages.</returns>
  58127. <typeparam name="T">The message items must implement the <see cref="T:MailKit.IMessageSummary"/> interface.</typeparam>
  58128. <param name="messages">The messages to sort.</param>
  58129. <param name="orderBy">The sort ordering.</param>
  58130. <exception cref="T:System.ArgumentNullException">
  58131. <para><paramref name="messages"/> is <c>null</c>.</para>
  58132. <para>-or-</para>
  58133. <para><paramref name="orderBy"/> is <c>null</c>.</para>
  58134. </exception>
  58135. <exception cref="T:System.ArgumentException">
  58136. <para><paramref name="messages"/> contains one or more items that is missing information needed for sorting.</para>
  58137. <para>-or-</para>
  58138. <para><paramref name="orderBy"/> is an empty list.</para>
  58139. </exception>
  58140. </member>
  58141. <member name="T:MailKit.MessageSummary">
  58142. <summary>
  58143. A summary of a message.
  58144. </summary>
  58145. <remarks>
  58146. A <see cref="T:MailKit.MessageSummary"/> is returned by
  58147. <see cref="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Threading.CancellationToken)"/>.
  58148. The properties of the <see cref="T:MailKit.MessageSummary"/> that will be available
  58149. depend on the <see cref="T:MailKit.MessageSummaryItems"/> passed to the aformentioned method.
  58150. </remarks>
  58151. </member>
  58152. <member name="M:MailKit.MessageSummary.#ctor(System.Int32)">
  58153. <summary>
  58154. Initializes a new instance of the <see cref="T:MailKit.MessageSummary"/> class.
  58155. </summary>
  58156. <remarks>
  58157. Creates a new <see cref="T:MailKit.MessageSummary"/>.
  58158. </remarks>
  58159. <param name="index">The message index.</param>
  58160. <exception cref="T:System.ArgumentOutOfRangeException">
  58161. <paramref name="index"/> is negative.
  58162. </exception>
  58163. </member>
  58164. <member name="P:MailKit.MessageSummary.Fields">
  58165. <summary>
  58166. Get a bitmask of fields that have been populated.
  58167. </summary>
  58168. <remarks>
  58169. Gets a bitmask of fields that have been populated.
  58170. </remarks>
  58171. <value>The fields that have been populated.</value>
  58172. </member>
  58173. <member name="P:MailKit.MessageSummary.Body">
  58174. <summary>
  58175. Gets the body structure of the message, if available.
  58176. </summary>
  58177. <remarks>
  58178. <para>The body will be one of <see cref="T:MailKit.BodyPartText"/>,
  58179. <see cref="T:MailKit.BodyPartMessage"/>, <see cref="T:MailKit.BodyPartBasic"/>,
  58180. or <see cref="T:MailKit.BodyPartMultipart"/>.</para>
  58181. <para>This property will only be set if either the
  58182. <see cref="F:MailKit.MessageSummaryItems.Body"/> flag or the
  58183. <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/> flag is passed to
  58184. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58185. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58186. methods.</para>
  58187. </remarks>
  58188. <value>The body structure of the message.</value>
  58189. </member>
  58190. <member name="P:MailKit.MessageSummary.TextBody">
  58191. <summary>
  58192. Gets the text body part of the message if it exists.
  58193. </summary>
  58194. <remarks>
  58195. <para>Gets the <c>text/plain</c> body part of the message.</para>
  58196. <para>This property will only be usable if the
  58197. <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/> flag is passed to
  58198. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58199. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58200. methods.</para>
  58201. </remarks>
  58202. <example>
  58203. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  58204. </example>
  58205. <value>The text body if it exists; otherwise, <c>null</c>.</value>
  58206. </member>
  58207. <member name="P:MailKit.MessageSummary.HtmlBody">
  58208. <summary>
  58209. Gets the html body part of the message if it exists.
  58210. </summary>
  58211. <remarks>
  58212. <para>Gets the <c>text/html</c> body part of the message.</para>
  58213. <para>This property will only be usable if the
  58214. <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/> flag is passed to
  58215. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58216. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58217. methods.</para>
  58218. </remarks>
  58219. <value>The html body if it exists; otherwise, <c>null</c>.</value>
  58220. </member>
  58221. <member name="P:MailKit.MessageSummary.BodyParts">
  58222. <summary>
  58223. Gets the body parts of the message.
  58224. </summary>
  58225. <remarks>
  58226. <para>Traverses over the <see cref="P:MailKit.MessageSummary.Body"/>, enumerating all of the
  58227. <see cref="T:MailKit.BodyPartBasic"/> objects.</para>
  58228. <para>This property will only be usable if either the
  58229. <see cref="F:MailKit.MessageSummaryItems.Body"/> flag or the
  58230. <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/> flag is passed to
  58231. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58232. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58233. methods.</para>
  58234. </remarks>
  58235. <value>The body parts.</value>
  58236. </member>
  58237. <member name="P:MailKit.MessageSummary.Attachments">
  58238. <summary>
  58239. Gets the attachments.
  58240. </summary>
  58241. <remarks>
  58242. <para>Traverses over the <see cref="P:MailKit.MessageSummary.Body"/>, enumerating all of the
  58243. <see cref="T:MailKit.BodyPartBasic"/> objects that have a <c>Content-Disposition</c>
  58244. header set to <c>"attachment"</c>.</para>
  58245. <para>This property will only be usable if the
  58246. <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/> flag is passed to
  58247. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58248. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58249. methods.</para>
  58250. </remarks>
  58251. <example>
  58252. <code language="c#" source="Examples\ImapExamples.cs" region="DownloadBodyParts"/>
  58253. </example>
  58254. <value>The attachments.</value>
  58255. </member>
  58256. <member name="P:MailKit.MessageSummary.PreviewText">
  58257. <summary>
  58258. Gets the preview text of the message.
  58259. </summary>
  58260. <remarks>
  58261. <para>The preview text is a short snippet of the beginning of the message
  58262. text, typically shown in a mail client's message list to provide the user
  58263. with a sense of what the message is about.</para>
  58264. <para>This property will only be set if the
  58265. <see cref="F:MailKit.MessageSummaryItems.PreviewText"/> flag is passed to
  58266. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58267. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58268. methods.</para>
  58269. </remarks>
  58270. <value>The preview text.</value>
  58271. </member>
  58272. <member name="P:MailKit.MessageSummary.Envelope">
  58273. <summary>
  58274. Gets the envelope of the message, if available.
  58275. </summary>
  58276. <remarks>
  58277. <para>The envelope of a message contains information such as the
  58278. date the message was sent, the subject of the message,
  58279. the sender of the message, who the message was sent to,
  58280. which message(s) the message may be in reply to,
  58281. and the message id.</para>
  58282. <para>This property will only be set if the
  58283. <see cref="F:MailKit.MessageSummaryItems.Envelope"/> flag is passed to
  58284. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58285. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58286. methods.</para>
  58287. </remarks>
  58288. <value>The envelope of the message.</value>
  58289. </member>
  58290. <member name="P:MailKit.MessageSummary.NormalizedSubject">
  58291. <summary>
  58292. Gets the normalized subject.
  58293. </summary>
  58294. <remarks>
  58295. A normalized Subject header value where prefixes such as
  58296. "Re:", "Re[#]:", etc have been pruned.
  58297. </remarks>
  58298. <value>The normalized subject.</value>
  58299. </member>
  58300. <member name="P:MailKit.MessageSummary.IsReply">
  58301. <summary>
  58302. Gets whether or not the message is a reply.
  58303. </summary>
  58304. <remarks>
  58305. This value should be based on whether the message subject contained any "Re:" or "Fwd:" prefixes.
  58306. </remarks>
  58307. <value><c>true</c> if the message is a reply; otherwise, <c>false</c>.</value>
  58308. </member>
  58309. <member name="P:MailKit.MessageSummary.Date">
  58310. <summary>
  58311. Gets the Date header value.
  58312. </summary>
  58313. <remarks>
  58314. Gets the Date header value. If the Date header is not present, the arrival date is used.
  58315. If neither are known, <see cref="F:System.DateTimeOffset.MinValue"/> is returned.
  58316. </remarks>
  58317. <value>The date.</value>
  58318. </member>
  58319. <member name="P:MailKit.MessageSummary.Flags">
  58320. <summary>
  58321. Gets the message flags, if available.
  58322. </summary>
  58323. <remarks>
  58324. <para>Gets the message flags, if available.</para>
  58325. <para>This property will only be set if the
  58326. <see cref="F:MailKit.MessageSummaryItems.Flags"/> flag is passed to
  58327. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58328. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58329. methods.</para>
  58330. </remarks>
  58331. <value>The message flags.</value>
  58332. </member>
  58333. <member name="P:MailKit.MessageSummary.Keywords">
  58334. <summary>
  58335. Gets the user-defined message flags, if available.
  58336. </summary>
  58337. <remarks>
  58338. <para>Gets the user-defined message flags, if available.</para>
  58339. <para>This property will only be set if the
  58340. <see cref="F:MailKit.MessageSummaryItems.Flags"/> flag is passed to
  58341. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58342. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58343. methods.</para>
  58344. </remarks>
  58345. <value>The user-defined message flags.</value>
  58346. </member>
  58347. <member name="P:MailKit.MessageSummary.UserFlags">
  58348. <summary>
  58349. Gets the user-defined message flags, if available.
  58350. </summary>
  58351. <remarks>
  58352. <para>Gets the user-defined message flags, if available.</para>
  58353. <para>This property will only be set if the
  58354. <see cref="F:MailKit.MessageSummaryItems.Flags"/> flag is passed to
  58355. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58356. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58357. methods.</para>
  58358. </remarks>
  58359. <value>The user-defined message flags.</value>
  58360. </member>
  58361. <member name="P:MailKit.MessageSummary.Annotations">
  58362. <summary>
  58363. Gets the message annotations, if available.
  58364. </summary>
  58365. <remarks>
  58366. <para>Gets the message annotations, if available.</para>
  58367. <para>This property will only be set if the
  58368. <see cref="F:MailKit.MessageSummaryItems.Annotations"/> flag is passed to
  58369. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58370. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58371. methods.</para>
  58372. </remarks>
  58373. <value>The message annotations.</value>
  58374. </member>
  58375. <member name="P:MailKit.MessageSummary.Headers">
  58376. <summary>
  58377. Gets the list of headers, if available.
  58378. </summary>
  58379. <remarks>
  58380. <para>Gets the list of headers, if available.</para>
  58381. <para>This property will only be set if <see cref="F:MailKit.MessageSummaryItems.Headers"/>
  58382. is specified in a call to one of the
  58383. <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58384. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58385. methods or specific headers are requested via a one of the Fetch or FetchAsync methods
  58386. that accept list of specific headers to request for each message such as
  58387. <see cref="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Collections.Generic.IEnumerable{MimeKit.HeaderId},System.Threading.CancellationToken)"/>.
  58388. </para>
  58389. </remarks>
  58390. <value>The list of headers.</value>
  58391. </member>
  58392. <member name="P:MailKit.MessageSummary.InternalDate">
  58393. <summary>
  58394. Gets the internal date of the message (i.e. the "received" date), if available.
  58395. </summary>
  58396. <remarks>
  58397. <para>Gets the internal date of the message (i.e. the "received" date), if available.</para>
  58398. <para>This property will only be set if the
  58399. <see cref="F:MailKit.MessageSummaryItems.InternalDate"/> flag is passed to
  58400. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58401. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58402. methods.</para>
  58403. </remarks>
  58404. <value>The internal date of the message.</value>
  58405. </member>
  58406. <member name="P:MailKit.MessageSummary.Size">
  58407. <summary>
  58408. Gets the size of the message, in bytes, if available.
  58409. </summary>
  58410. <remarks>
  58411. <para>Gets the size of the message, in bytes, if available.</para>
  58412. <para>This property will only be set if the
  58413. <see cref="F:MailKit.MessageSummaryItems.Size"/> flag is passed to
  58414. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58415. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58416. methods.</para>
  58417. </remarks>
  58418. <value>The size of the message.</value>
  58419. </member>
  58420. <member name="P:MailKit.MessageSummary.ModSeq">
  58421. <summary>
  58422. Gets the mod-sequence value for the message, if available.
  58423. </summary>
  58424. <remarks>
  58425. <para>Gets the mod-sequence value for the message, if available.</para>
  58426. <para>This property will only be set if the
  58427. <see cref="F:MailKit.MessageSummaryItems.ModSeq"/> flag is passed to
  58428. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58429. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58430. methods.</para>
  58431. </remarks>
  58432. <value>The mod-sequence value.</value>
  58433. </member>
  58434. <member name="P:MailKit.MessageSummary.References">
  58435. <summary>
  58436. Gets the message-ids that the message references, if available.
  58437. </summary>
  58438. <remarks>
  58439. <para>Gets the message-ids that the message references, if available.</para>
  58440. <para>This property will only be set if the
  58441. <see cref="F:MailKit.MessageSummaryItems.References"/> flag is passed to
  58442. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58443. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58444. methods.</para>
  58445. </remarks>
  58446. <value>The references.</value>
  58447. </member>
  58448. <member name="P:MailKit.MessageSummary.EmailId">
  58449. <summary>
  58450. Get the globally unique identifier for the message, if available.
  58451. </summary>
  58452. <remarks>
  58453. <para>Gets the globally unique identifier of the message, if available.</para>
  58454. <para>This property will only be set if the
  58455. <see cref="F:MailKit.MessageSummaryItems.EmailId"/> flag is passed to
  58456. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58457. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58458. methods.</para>
  58459. <note type="info">This property maps to the <c>EMAILID</c> value defined in the
  58460. <a href="https://tools.ietf.org/html/rfc8474">OBJECTID</a> extension.</note>
  58461. </remarks>
  58462. <value>The globally unique message identifier.</value>
  58463. </member>
  58464. <member name="P:MailKit.MessageSummary.Id">
  58465. <summary>
  58466. Get the globally unique identifier for the message, if available.
  58467. </summary>
  58468. <remarks>
  58469. <para>Gets the globally unique identifier of the message, if available.</para>
  58470. <para>This property will only be set if the
  58471. <see cref="F:MailKit.MessageSummaryItems.EmailId"/> flag is passed to
  58472. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58473. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58474. methods.</para>
  58475. <note type="info">This property maps to the <c>EMAILID</c> value defined in the
  58476. <a href="https://tools.ietf.org/html/rfc8474">OBJECTID</a> extension.</note>
  58477. </remarks>
  58478. <value>The globally unique message identifier.</value>
  58479. </member>
  58480. <member name="P:MailKit.MessageSummary.ThreadId">
  58481. <summary>
  58482. Get the globally unique thread identifier for the message, if available.
  58483. </summary>
  58484. <remarks>
  58485. <para>Gets the globally unique thread identifier for the message, if available.</para>
  58486. <para>This property will only be set if the
  58487. <see cref="F:MailKit.MessageSummaryItems.ThreadId"/> flag is passed to
  58488. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58489. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58490. methods.</para>
  58491. <note type="info">This property maps to the <c>THREADID</c> value defined in the
  58492. <a href="https://tools.ietf.org/html/rfc8474">OBJECTID</a> extension.</note>
  58493. </remarks>
  58494. <value>The globally unique thread identifier.</value>
  58495. </member>
  58496. <member name="P:MailKit.MessageSummary.UniqueId">
  58497. <summary>
  58498. Gets the unique identifier of the message, if available.
  58499. </summary>
  58500. <remarks>
  58501. <para>Gets the unique identifier of the message, if available.</para>
  58502. <para>This property will only be set if the
  58503. <see cref="F:MailKit.MessageSummaryItems.UniqueId"/> flag is passed to
  58504. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58505. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58506. methods.</para>
  58507. </remarks>
  58508. <value>The uid of the message.</value>
  58509. </member>
  58510. <member name="P:MailKit.MessageSummary.Index">
  58511. <summary>
  58512. Gets the index of the message.
  58513. </summary>
  58514. <remarks>
  58515. <para>Gets the index of the message.</para>
  58516. <para>This property is always set.</para>
  58517. </remarks>
  58518. <value>The index of the message.</value>
  58519. </member>
  58520. <member name="P:MailKit.MessageSummary.GMailMessageId">
  58521. <summary>
  58522. Gets the GMail message identifier, if available.
  58523. </summary>
  58524. <remarks>
  58525. <para>Gets the GMail message identifier, if available.</para>
  58526. <para>This property will only be set if the
  58527. <see cref="F:MailKit.MessageSummaryItems.GMailMessageId"/> flag is passed to
  58528. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58529. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58530. methods.</para>
  58531. </remarks>
  58532. <value>The GMail message identifier.</value>
  58533. </member>
  58534. <member name="P:MailKit.MessageSummary.GMailThreadId">
  58535. <summary>
  58536. Gets the GMail thread identifier, if available.
  58537. </summary>
  58538. <remarks>
  58539. <para>Gets the GMail thread identifier, if available.</para>
  58540. <para>This property will only be set if the
  58541. <see cref="F:MailKit.MessageSummaryItems.GMailThreadId"/> flag is passed to
  58542. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58543. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58544. methods.</para>
  58545. </remarks>
  58546. <value>The GMail thread identifier.</value>
  58547. </member>
  58548. <member name="P:MailKit.MessageSummary.GMailLabels">
  58549. <summary>
  58550. Gets the list of GMail labels, if available.
  58551. </summary>
  58552. <remarks>
  58553. <para>Gets the list of GMail labels, if available.</para>
  58554. <para>This property will only be set if the
  58555. <see cref="F:MailKit.MessageSummaryItems.GMailLabels"/> flag is passed to
  58556. one of the <a href="Overload_MailKit_IMailFolder_Fetch.htm">Fetch</a>
  58557. or <a href="Overload_MailKit_IMailFolder_FetchAsync.htm">FetchAsync</a>
  58558. methods.</para>
  58559. </remarks>
  58560. <value>The GMail labels.</value>
  58561. </member>
  58562. <member name="T:MailKit.MessageSummaryFetchedEventArgs">
  58563. <summary>
  58564. Event args used when a message summary has been fetched from a folder.
  58565. </summary>
  58566. <remarks>
  58567. Event args used when a message summary has been fetched from a folder.
  58568. </remarks>
  58569. </member>
  58570. <member name="M:MailKit.MessageSummaryFetchedEventArgs.#ctor(MailKit.IMessageSummary)">
  58571. <summary>
  58572. Initializes a new instance of the <see cref="T:MailKit.MessageSummaryFetchedEventArgs"/> class.
  58573. </summary>
  58574. <remarks>
  58575. Creates a new <see cref="T:MailKit.MessageSummaryFetchedEventArgs"/>
  58576. </remarks>
  58577. <param name="message">The message summary.</param>
  58578. <exception cref="T:System.ArgumentNullException">
  58579. <paramref name="message"/> is <c>null</c>.
  58580. </exception>
  58581. </member>
  58582. <member name="P:MailKit.MessageSummaryFetchedEventArgs.Message">
  58583. <summary>
  58584. Get the message summary.
  58585. </summary>
  58586. <remarks>
  58587. Gets the message summary.
  58588. </remarks>
  58589. <value>The message summary.</value>
  58590. </member>
  58591. <member name="T:MailKit.MessageSummaryItems">
  58592. <summary>
  58593. A bitfield of <see cref="T:MailKit.MessageSummary"/> fields.
  58594. </summary>
  58595. <remarks>
  58596. <see cref="T:MailKit.MessageSummaryItems"/> are used to specify which properties
  58597. of <see cref="T:MailKit.MessageSummary"/> should be populated by calls to
  58598. <see cref="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{MailKit.UniqueId},MailKit.MessageSummaryItems,System.Threading.CancellationToken)"/>,
  58599. <see cref="M:MailKit.IMailFolder.Fetch(System.Collections.Generic.IList{System.Int32},MailKit.MessageSummaryItems,System.Threading.CancellationToken)"/>, or
  58600. <see cref="M:MailKit.IMailFolder.Fetch(System.Int32,System.Int32,MailKit.MessageSummaryItems,System.Threading.CancellationToken)"/>.
  58601. </remarks>
  58602. </member>
  58603. <member name="F:MailKit.MessageSummaryItems.None">
  58604. <summary>
  58605. Don't fetch any summary items.
  58606. </summary>
  58607. </member>
  58608. <member name="F:MailKit.MessageSummaryItems.Annotations">
  58609. <summary>
  58610. <para>Fetch the <see cref="P:MailKit.IMessageSummary.Annotations"/>.</para>
  58611. <para>Fetches all <c>ANNOATION</c> values as defined in
  58612. <a href="https://tools.ietf.org/html/rfc5257">rfc5257</a>.</para>
  58613. </summary>
  58614. </member>
  58615. <member name="F:MailKit.MessageSummaryItems.Body">
  58616. <summary>
  58617. <para>Fetch the <see cref="P:MailKit.IMessageSummary.Body"/>.</para>
  58618. <para>Fetches the <c>BODY</c> value as defined in
  58619. <a href="https://tools.ietf.org/html/rfc3501">rfc3501</a>.</para>
  58620. <note type="note">Unlike <see cref="F:MailKit.MessageSummaryItems.BodyStructure"/>, <c>Body</c> will not populate the
  58621. <see cref="P:MailKit.BodyPart.ContentType"/> parameters nor will it populate the
  58622. <see cref="P:MailKit.BodyPartBasic.ContentDisposition"/>, <see cref="P:MailKit.BodyPartBasic.ContentLanguage"/>
  58623. or <see cref="P:MailKit.BodyPartBasic.ContentLocation"/> properties of each <see cref="T:MailKit.BodyPartBasic"/>
  58624. body part. This makes <c>Body</c> far less useful than <c>BodyStructure</c> especially when
  58625. it is desirable to determine whether or not a body part is an attachment.</note>
  58626. </summary>
  58627. </member>
  58628. <member name="F:MailKit.MessageSummaryItems.BodyStructure">
  58629. <summary>
  58630. <para>Fetch the <see cref="P:MailKit.IMessageSummary.Body"/> (but with more details than <see cref="F:MailKit.MessageSummaryItems.Body"/>).</para>
  58631. <para>Fetches the <c>BODYSTRUCTURE</c> value as defined in
  58632. <a href="https://tools.ietf.org/html/rfc3501">rfc3501</a>.</para>
  58633. <note type="note">Unlike <see cref="F:MailKit.MessageSummaryItems.Body"/>, <c>BodyStructure</c> will also populate the
  58634. <see cref="P:MailKit.BodyPart.ContentType"/> parameters as well as the
  58635. <see cref="P:MailKit.BodyPartBasic.ContentDisposition"/>, <see cref="P:MailKit.BodyPartBasic.ContentLanguage"/>
  58636. and <see cref="P:MailKit.BodyPartBasic.ContentLocation"/> properties of each <see cref="T:MailKit.BodyPartBasic"/>
  58637. body part. The <c>Content-Disposition</c> information is especially important when trying to
  58638. determine whether or not a body part is an attachment, for example.</note>
  58639. </summary>
  58640. </member>
  58641. <member name="F:MailKit.MessageSummaryItems.Envelope">
  58642. <summary>
  58643. <para>Fetch the <see cref="P:MailKit.IMessageSummary.Envelope"/>.</para>
  58644. <para>Fetches the <c>ENVELOPE</c> value as defined in
  58645. <a href="https://tools.ietf.org/html/rfc3501">rfc3501</a>.</para>
  58646. </summary>
  58647. </member>
  58648. <member name="F:MailKit.MessageSummaryItems.Flags">
  58649. <summary>
  58650. <para>Fetch the <see cref="P:MailKit.IMessageSummary.Flags"/>.</para>
  58651. <para>Fetches the <c>FLAGS</c> value as defined in
  58652. <a href="https://tools.ietf.org/html/rfc3501">rfc3501</a>.</para>
  58653. </summary>
  58654. </member>
  58655. <member name="F:MailKit.MessageSummaryItems.InternalDate">
  58656. <summary>
  58657. <para>Fetch the <see cref="P:MailKit.IMessageSummary.InternalDate"/>.</para>
  58658. <para>Fetches the <c>INTERNALDATE</c> value as defined in
  58659. <a href="https://tools.ietf.org/html/rfc3501">rfc3501</a>.</para>
  58660. </summary>
  58661. </member>
  58662. <member name="F:MailKit.MessageSummaryItems.Size">
  58663. <summary>
  58664. <para>Fetch the <see cref="P:MailKit.IMessageSummary.Size"/>.</para>
  58665. <para>Fetches the <c>RFC822.SIZE</c> value as defined in
  58666. <a href="https://tools.ietf.org/html/rfc3501">rfc3501</a>.</para>
  58667. </summary>
  58668. </member>
  58669. <member name="F:MailKit.MessageSummaryItems.ModSeq">
  58670. <summary>
  58671. <para>Fetch the <see cref="P:MailKit.IMessageSummary.ModSeq"/>.</para>
  58672. <para>Fetches the <c>MODSEQ</c> value as defined in
  58673. <a href="https://tools.ietf.org/html/rfc4551">rfc4551</a>.</para>
  58674. </summary>
  58675. </member>
  58676. <member name="F:MailKit.MessageSummaryItems.References">
  58677. <summary>
  58678. Fetch the <see cref="P:MailKit.IMessageSummary.References"/>.
  58679. </summary>
  58680. </member>
  58681. <member name="F:MailKit.MessageSummaryItems.UniqueId">
  58682. <summary>
  58683. <para>Fetch the <see cref="P:MailKit.IMessageSummary.UniqueId"/>.</para>
  58684. <para>Fetches the <c>UID</c> value as defined in
  58685. <a href="https://tools.ietf.org/html/rfc3501">rfc3501</a>.</para>
  58686. </summary>
  58687. </member>
  58688. <member name="F:MailKit.MessageSummaryItems.EmailId">
  58689. <summary>
  58690. <para></para>Fetch the <see cref="P:MailKit.IMessageSummary.EmailId"/>.
  58691. <para>Fetches the <c>EMAILID</c> value as defined in
  58692. <a href="https://tools.ietf.org/html/rfc8474">rfc8474</a>.</para>
  58693. </summary>
  58694. </member>
  58695. <member name="F:MailKit.MessageSummaryItems.Id">
  58696. <summary>
  58697. <para></para>Fetch the <see cref="P:MailKit.IMessageSummary.EmailId"/>.
  58698. <para>Fetches the <c>EMAILID</c> value as defined in
  58699. <a href="https://tools.ietf.org/html/rfc8474">rfc8474</a>.</para>
  58700. </summary>
  58701. </member>
  58702. <member name="F:MailKit.MessageSummaryItems.ThreadId">
  58703. <summary>
  58704. <para>Fetch the <see cref="P:MailKit.IMessageSummary.ThreadId"/>.</para>
  58705. <para>Fetches the <c>THREADID</c> value as defined in
  58706. <a href="https://tools.ietf.org/html/rfc8474">rfc8474</a>.</para>
  58707. </summary>
  58708. </member>
  58709. <member name="F:MailKit.MessageSummaryItems.GMailMessageId">
  58710. <summary>
  58711. <para>Fetch the <see cref="P:MailKit.IMessageSummary.GMailMessageId"/>.</para>
  58712. <para>Fetches the <c>X-GM-MSGID</c> value as defined in Google's
  58713. <a href="https://developers.google.com/gmail/imap/imap-extensions">IMAP extensions</a>
  58714. documentation.</para>
  58715. </summary>
  58716. </member>
  58717. <member name="F:MailKit.MessageSummaryItems.GMailThreadId">
  58718. <summary>
  58719. <para>Fetch the <see cref="P:MailKit.IMessageSummary.GMailThreadId"/>.</para>
  58720. <para>Fetches the <c>X-GM-THRID</c> value as defined in Google's
  58721. <a href="https://developers.google.com/gmail/imap/imap-extensions">IMAP extensions</a>
  58722. documentation.</para>
  58723. </summary>
  58724. </member>
  58725. <member name="F:MailKit.MessageSummaryItems.GMailLabels">
  58726. <summary>
  58727. <para>Fetch the <see cref="P:MailKit.IMessageSummary.GMailLabels"/>.</para>
  58728. <para>Fetches the <c>X-GM-LABELS</c> value as defined in Google's
  58729. <a href="https://developers.google.com/gmail/imap/imap-extensions">IMAP extensions</a>
  58730. documentation.</para>
  58731. </summary>
  58732. </member>
  58733. <member name="F:MailKit.MessageSummaryItems.Headers">
  58734. <summary>
  58735. <para>Fetch the the complete list of <see cref="P:MailKit.IMessageSummary.Headers"/> for each message.</para>
  58736. </summary>
  58737. </member>
  58738. <member name="F:MailKit.MessageSummaryItems.PreviewText">
  58739. <summary>
  58740. <para>Fetch the <see cref="P:MailKit.IMessageSummary.PreviewText"/>.</para>
  58741. <note type="note">This property is quite expensive to calculate because it is not an
  58742. item that is cached on the IMAP server. Instead, MailKit must download a hunk of the
  58743. message body so that it can decode and parse it in order to generate a meaningful
  58744. text snippet. This usually involves downloading the first 512 bytes for <c>text/plain</c>
  58745. message bodies and the first 16 kilobytes for <c>text/html</c> message bodies. If a
  58746. message contains both a <c>text/plain</c> body and a <c>text/html</c> body, then the
  58747. <c>text/plain</c> content is used in order to reduce network traffic.</note>
  58748. </summary>
  58749. </member>
  58750. <member name="F:MailKit.MessageSummaryItems.All">
  58751. <summary>
  58752. <para>A macro for fetching the <see cref="F:MailKit.MessageSummaryItems.Envelope"/>, <see cref="F:MailKit.MessageSummaryItems.Flags"/>,
  58753. <see cref="F:MailKit.MessageSummaryItems.InternalDate"/>, and <see cref="F:MailKit.MessageSummaryItems.Size"/> values.</para>
  58754. <para>This macro maps to the equivalent <c>ALL</c> macro as defined in
  58755. <a href="https://tools.ietf.org/html/rfc3501">rfc3501</a>.</para>
  58756. </summary>
  58757. </member>
  58758. <member name="F:MailKit.MessageSummaryItems.Fast">
  58759. <summary>
  58760. <para>A macro for fetching the <see cref="F:MailKit.MessageSummaryItems.Flags"/>, <see cref="F:MailKit.MessageSummaryItems.InternalDate"/>, and
  58761. <see cref="F:MailKit.MessageSummaryItems.Size"/> values.</para>
  58762. <para>This macro maps to the equivalent <c>FAST</c> macro as defined in
  58763. <a href="https://tools.ietf.org/html/rfc3501">rfc3501</a>.</para>
  58764. </summary>
  58765. </member>
  58766. <member name="F:MailKit.MessageSummaryItems.Full">
  58767. <summary>
  58768. <para>A macro for fetching the <see cref="F:MailKit.MessageSummaryItems.Body"/>, <see cref="F:MailKit.MessageSummaryItems.Envelope"/>,
  58769. <see cref="F:MailKit.MessageSummaryItems.Flags"/>, <see cref="F:MailKit.MessageSummaryItems.InternalDate"/>, and <see cref="F:MailKit.MessageSummaryItems.Size"/> values.</para>
  58770. <para>This macro maps to the equivalent <c>FULL</c> macro as defined in
  58771. <a href="https://tools.ietf.org/html/rfc3501">rfc3501</a>.</para>
  58772. </summary>
  58773. </member>
  58774. <member name="T:MailKit.MessagesVanishedEventArgs">
  58775. <summary>
  58776. Event args used when a message vanishes from a folder.
  58777. </summary>
  58778. <remarks>
  58779. Event args used when a message vanishes from a folder.
  58780. </remarks>
  58781. </member>
  58782. <member name="M:MailKit.MessagesVanishedEventArgs.#ctor(System.Collections.Generic.IList{MailKit.UniqueId},System.Boolean)">
  58783. <summary>
  58784. Initializes a new instance of the <see cref="T:MailKit.MessagesVanishedEventArgs"/> class.
  58785. </summary>
  58786. <remarks>
  58787. Creates a new <see cref="T:MailKit.MessagesVanishedEventArgs"/>.
  58788. </remarks>
  58789. <param name="uids">The list of unique identifiers.</param>
  58790. <param name="earlier">If set to <c>true</c>, the messages vanished in the past as opposed to just now.</param>
  58791. <exception cref="T:System.ArgumentNullException">
  58792. <paramref name="uids"/> is <c>null</c>.
  58793. </exception>
  58794. </member>
  58795. <member name="P:MailKit.MessagesVanishedEventArgs.UniqueIds">
  58796. <summary>
  58797. Gets the unique identifiers of the messages that vanished.
  58798. </summary>
  58799. <remarks>
  58800. Gets the unique identifiers of the messages that vanished.
  58801. </remarks>
  58802. <value>The unique identifiers.</value>
  58803. </member>
  58804. <member name="P:MailKit.MessagesVanishedEventArgs.Earlier">
  58805. <summary>
  58806. Gets whether the messages vanished inthe past as opposed to just now.
  58807. </summary>
  58808. <remarks>
  58809. Gets whether the messages vanished inthe past as opposed to just now.
  58810. </remarks>
  58811. <value><c>true</c> if the messages vanished earlier; otherwise, <c>false</c>.</value>
  58812. </member>
  58813. <member name="T:MailKit.MessageThread">
  58814. <summary>
  58815. A message thread.
  58816. </summary>
  58817. <remarks>
  58818. A message thread.
  58819. </remarks>
  58820. </member>
  58821. <member name="M:MailKit.MessageThread.#ctor(System.Nullable{MailKit.UniqueId})">
  58822. <summary>
  58823. Initializes a new instance of the <see cref="T:MailKit.MessageThread"/> class.
  58824. </summary>
  58825. <remarks>
  58826. Creates a new message thread node.
  58827. </remarks>
  58828. <param name="uid">The unique identifier of the message.</param>
  58829. </member>
  58830. <member name="P:MailKit.MessageThread.UniqueId">
  58831. <summary>
  58832. Gets the unique identifier of the message.
  58833. </summary>
  58834. <remarks>
  58835. The unique identifier may be <c>null</c> if the message is missing
  58836. from the <see cref="T:MailKit.IMailFolder"/> or did not match the
  58837. <see cref="T:MailKit.Search.SearchQuery"/>.
  58838. </remarks>
  58839. <value>The unique identifier.</value>
  58840. </member>
  58841. <member name="P:MailKit.MessageThread.Children">
  58842. <summary>
  58843. Gets the children.
  58844. </summary>
  58845. <remarks>
  58846. Each child represents a reply to the message referenced by <see cref="P:MailKit.MessageThread.UniqueId"/>.
  58847. </remarks>
  58848. <value>The children.</value>
  58849. </member>
  58850. <member name="T:MailKit.MessageThreader">
  58851. <summary>
  58852. Threads messages according to the algorithms defined in rfc5256.
  58853. </summary>
  58854. <remarks>
  58855. Threads messages according to the algorithms defined in rfc5256.
  58856. </remarks>
  58857. </member>
  58858. <member name="M:MailKit.MessageThreader.Thread(System.Collections.Generic.IEnumerable{MailKit.IMessageSummary},MailKit.ThreadingAlgorithm)">
  58859. <summary>
  58860. Thread the messages according to the specified threading algorithm.
  58861. </summary>
  58862. <remarks>
  58863. Thread the messages according to the specified threading algorithm.
  58864. </remarks>
  58865. <returns>The threaded messages.</returns>
  58866. <param name="messages">The messages.</param>
  58867. <param name="algorithm">The threading algorithm.</param>
  58868. <exception cref="T:System.ArgumentNullException">
  58869. <paramref name="messages"/> is <c>null</c>.
  58870. </exception>
  58871. <exception cref="T:System.ArgumentOutOfRangeException">
  58872. <paramref name="algorithm"/> is not a valid threading algorithm.
  58873. </exception>
  58874. <exception cref="T:System.ArgumentException">
  58875. <paramref name="messages"/> contains one or more items that is missing information needed for threading.
  58876. </exception>
  58877. </member>
  58878. <member name="M:MailKit.MessageThreader.Thread(System.Collections.Generic.IEnumerable{MailKit.IMessageSummary},MailKit.ThreadingAlgorithm,System.Collections.Generic.IList{MailKit.Search.OrderBy})">
  58879. <summary>
  58880. Threads the messages according to the specified threading algorithm
  58881. and sorts the resulting threads by the specified ordering.
  58882. </summary>
  58883. <remarks>
  58884. Threads the messages according to the specified threading algorithm
  58885. and sorts the resulting threads by the specified ordering.
  58886. </remarks>
  58887. <returns>The threaded messages.</returns>
  58888. <param name="messages">The messages.</param>
  58889. <param name="algorithm">The threading algorithm.</param>
  58890. <param name="orderBy">The requested sort ordering.</param>
  58891. <exception cref="T:System.ArgumentNullException">
  58892. <para><paramref name="messages"/> is <c>null</c>.</para>
  58893. <para>-or-</para>
  58894. <para><paramref name="orderBy"/> is <c>null</c>.</para>
  58895. </exception>
  58896. <exception cref="T:System.ArgumentOutOfRangeException">
  58897. <paramref name="algorithm"/> is not a valid threading algorithm.
  58898. </exception>
  58899. <exception cref="T:System.ArgumentException">
  58900. <para><paramref name="messages"/> contains one or more items that is missing information needed for threading or sorting.</para>
  58901. <para>-or-</para>
  58902. <para><paramref name="orderBy"/> is an empty list.</para>
  58903. </exception>
  58904. </member>
  58905. <member name="M:MailKit.MessageThreader.GetThreadableSubject(System.String,System.Int32@)">
  58906. <summary>
  58907. Gets the threadable subject.
  58908. </summary>
  58909. <remarks>
  58910. Gets the threadable subject.
  58911. </remarks>
  58912. <returns>The threadable subject.</returns>
  58913. <param name="subject">The Subject header value.</param>
  58914. <param name="replyDepth">The reply depth.</param>
  58915. <exception cref="T:System.ArgumentNullException">
  58916. <paramref name="subject"/> is <c>null</c>.
  58917. </exception>
  58918. </member>
  58919. <member name="T:MailKit.Metadata">
  58920. <summary>
  58921. A metadata tag and value.
  58922. </summary>
  58923. <remarks>
  58924. A metadata tag and value.
  58925. </remarks>
  58926. </member>
  58927. <member name="M:MailKit.Metadata.#ctor(MailKit.MetadataTag,System.String)">
  58928. <summary>
  58929. Initializes a new instance of the <see cref="T:MailKit.Metadata"/> class.
  58930. </summary>
  58931. <remarks>
  58932. Creates a new <see cref="T:MailKit.Metadata"/>.
  58933. </remarks>
  58934. <param name="tag">The metadata tag.</param>
  58935. <param name="value">The metadata value.</param>
  58936. </member>
  58937. <member name="P:MailKit.Metadata.Tag">
  58938. <summary>
  58939. Gets the metadata tag.
  58940. </summary>
  58941. <remarks>
  58942. Gets the metadata tag.
  58943. </remarks>
  58944. <value>The metadata tag.</value>
  58945. </member>
  58946. <member name="P:MailKit.Metadata.Value">
  58947. <summary>
  58948. Gets the metadata value.
  58949. </summary>
  58950. <remarks>
  58951. Gets the metadata value.
  58952. </remarks>
  58953. <value>The metadata value.</value>
  58954. </member>
  58955. <member name="T:MailKit.MetadataChangedEventArgs">
  58956. <summary>
  58957. Event args used when a metadata changes.
  58958. </summary>
  58959. <remarks>
  58960. Event args used when a metadata changes.
  58961. </remarks>
  58962. </member>
  58963. <member name="M:MailKit.MetadataChangedEventArgs.#ctor(MailKit.Metadata)">
  58964. <summary>
  58965. Initializes a new instance of the <see cref="T:MailKit.MetadataChangedEventArgs"/> class.
  58966. </summary>
  58967. <remarks>
  58968. Creates a new <see cref="T:MailKit.MetadataChangedEventArgs"/>.
  58969. </remarks>
  58970. <param name="metadata">The metadata that changed.</param>
  58971. <exception cref="T:System.ArgumentNullException">
  58972. <paramref name="metadata"/> is <c>null</c>.
  58973. </exception>
  58974. </member>
  58975. <member name="P:MailKit.MetadataChangedEventArgs.Metadata">
  58976. <summary>
  58977. Get the metadata that changed.
  58978. </summary>
  58979. <remarks>
  58980. Gets the metadata that changed.
  58981. </remarks>
  58982. <value>The metadata.</value>
  58983. </member>
  58984. <member name="T:MailKit.MetadataCollection">
  58985. <summary>
  58986. A collection of metadata.
  58987. </summary>
  58988. <remarks>
  58989. A collection of metadata.
  58990. </remarks>
  58991. </member>
  58992. <member name="M:MailKit.MetadataCollection.#ctor">
  58993. <summary>
  58994. Initializes a new instance of the <see cref="T:MailKit.MetadataCollection"/> class.
  58995. </summary>
  58996. <remarks>
  58997. Creates a new <see cref="T:MailKit.MetadataCollection"/>
  58998. </remarks>
  58999. </member>
  59000. <member name="M:MailKit.MetadataCollection.#ctor(System.Collections.Generic.IEnumerable{MailKit.Metadata})">
  59001. <summary>
  59002. Initializes a new instance of the <see cref="T:MailKit.MetadataCollection"/> class.
  59003. </summary>
  59004. <remarks>
  59005. Creates a new <see cref="T:MailKit.MetadataCollection"/>.
  59006. </remarks>
  59007. <param name="collection">A collection of metadata.</param>
  59008. </member>
  59009. <member name="T:MailKit.MetadataOptions">
  59010. <summary>
  59011. A set of options to use when requesting metadata.
  59012. </summary>
  59013. <remarks>
  59014. A set of options to use when requesting metadata.
  59015. </remarks>
  59016. </member>
  59017. <member name="M:MailKit.MetadataOptions.#ctor">
  59018. <summary>
  59019. Initializes a new instance of the <see cref="T:MailKit.MetadataOptions"/> class.
  59020. </summary>
  59021. <remarks>
  59022. Creates a new set of options to use when requesting metadata.
  59023. </remarks>
  59024. </member>
  59025. <member name="P:MailKit.MetadataOptions.Depth">
  59026. <summary>
  59027. Get or set the depth.
  59028. </summary>
  59029. <remarks>
  59030. <para>When the <see cref="P:MailKit.MetadataOptions.Depth"/> option is specified, it extends the list of metadata tag
  59031. values returned by the GetMetadata() call. For each <see cref="T:MailKit.MetadataTag"/> specified in the
  59032. the GetMetadata() call, the method returns the value of the specified metadata tag (if it exists),
  59033. plus all metadata tags below the specified entry up to the specified depth.</para>
  59034. <para>Three values are allowed for <see cref="P:MailKit.MetadataOptions.Depth"/>:</para>
  59035. <para><c>0</c> - no entries below the specified metadata tag are returned.</para>
  59036. <para><c>1</c> - only entries immediately below the specified metadata tag are returned.</para>
  59037. <para><see cref="F:System.Int32.MaxValue"/> - all entries below the specified metadata tag are returned.</para>
  59038. <para>Thus, a depth of <c>1</c> for a tag entry of <c>"/a"</c> will match <c>"/a"</c> as well as its children
  59039. entries (e.g., <c>"/a/b"</c>), but will not match grandchildren entries (e.g., <c>"/a/b/c"</c>).</para>
  59040. <para>If the Depth option is not specified, this is the same as specifying <c>0</c>.</para>
  59041. </remarks>
  59042. <value>The depth.</value>
  59043. <exception cref="T:System.ArgumentOutOfRangeException">
  59044. <paramref name="value"/> is out of range.
  59045. </exception>
  59046. </member>
  59047. <member name="P:MailKit.MetadataOptions.MaxSize">
  59048. <summary>
  59049. Get or set the max size of the metadata tags to request.
  59050. </summary>
  59051. <remarks>
  59052. When specified, the <see cref="P:MailKit.MetadataOptions.MaxSize"/> property is used to filter the metadata tags
  59053. returned by the GetMetadata() call to only those with a value shorter than the max size
  59054. specified.
  59055. </remarks>
  59056. <value>The size of the max.</value>
  59057. </member>
  59058. <member name="P:MailKit.MetadataOptions.LongEntries">
  59059. <summary>
  59060. Get the length of the longest metadata value.
  59061. </summary>
  59062. <remarks>
  59063. If the <see cref="P:MailKit.MetadataOptions.MaxSize"/> property is specified, once the GetMetadata() call returns,
  59064. the <see cref="P:MailKit.MetadataOptions.LongEntries"/> property will be set to the length of the longest metadata
  59065. value that exceeded the <see cref="P:MailKit.MetadataOptions.MaxSize"/> limit, otherwise a value of <c>0</c> will
  59066. be set.
  59067. </remarks>
  59068. <value>The length of the longest metadata value that exceeded the max size.</value>
  59069. </member>
  59070. <member name="T:MailKit.MetadataTag">
  59071. <summary>
  59072. A metadata tag.
  59073. </summary>
  59074. <remarks>
  59075. A metadata tag.
  59076. </remarks>
  59077. </member>
  59078. <member name="F:MailKit.MetadataTag.SharedAdmin">
  59079. <summary>
  59080. A metadata tag for specifying the contact information for the server administrator.
  59081. </summary>
  59082. <remarks>
  59083. Used to get the contact information of the administrator on a
  59084. <see cref="T:MailKit.IMailStore"/>.
  59085. </remarks>
  59086. </member>
  59087. <member name="F:MailKit.MetadataTag.PrivateComment">
  59088. <summary>
  59089. A metadata tag for private comments.
  59090. </summary>
  59091. <remarks>
  59092. Used to get or set a private comment on a <see cref="T:MailKit.IMailFolder"/>.
  59093. </remarks>
  59094. </member>
  59095. <member name="F:MailKit.MetadataTag.SharedComment">
  59096. <summary>
  59097. A metadata tag for shared comments.
  59098. </summary>
  59099. <remarks>
  59100. Used to get or set a shared comment on a <see cref="T:MailKit.IMailStore"/>
  59101. or <see cref="T:MailKit.IMailFolder"/>.
  59102. </remarks>
  59103. </member>
  59104. <member name="F:MailKit.MetadataTag.PrivateSpecialUse">
  59105. <summary>
  59106. A metadata tag for specifying the special use of a folder.
  59107. </summary>
  59108. <remarks>
  59109. Used to get or set the special use of a <see cref="T:MailKit.IMailFolder"/>.
  59110. </remarks>
  59111. </member>
  59112. <member name="M:MailKit.MetadataTag.#ctor(System.String)">
  59113. <summary>
  59114. Initializes a new instance of the <see cref="T:MailKit.MetadataTag"/> struct.
  59115. </summary>
  59116. <remarks>
  59117. Creates a new <see cref="T:MailKit.MetadataTag"/>.
  59118. </remarks>
  59119. <param name="id">The metadata tag identifier.</param>
  59120. <exception cref="T:System.ArgumentNullException">
  59121. <paramref name="id"/> is <c>null</c>.
  59122. </exception>
  59123. <exception cref="T:System.ArgumentException">
  59124. <paramref name="id"/> is an empty string.
  59125. </exception>
  59126. </member>
  59127. <member name="P:MailKit.MetadataTag.Id">
  59128. <summary>
  59129. Get the metadata tag identifier.
  59130. </summary>
  59131. <remarks>
  59132. Gets the metadata tag identifier.
  59133. </remarks>
  59134. <value>The metadata tag identifier.</value>
  59135. </member>
  59136. <member name="M:MailKit.MetadataTag.Equals(System.Object)">
  59137. <summary>
  59138. Determine whether the specified <see cref="T:System.Object"/> is equal to the current <see cref="T:MailKit.MetadataTag"/>.
  59139. </summary>
  59140. <remarks>
  59141. Determines whether the specified <see cref="T:System.Object"/> is equal to the current <see cref="T:MailKit.MetadataTag"/>.
  59142. </remarks>
  59143. <param name="obj">The <see cref="T:System.Object"/> to compare with the current <see cref="T:MailKit.MetadataTag"/>.</param>
  59144. <returns><c>true</c> if the specified <see cref="T:System.Object"/> is equal to the current
  59145. <see cref="T:MailKit.MetadataTag"/>; otherwise, <c>false</c>.</returns>
  59146. </member>
  59147. <member name="M:MailKit.MetadataTag.GetHashCode">
  59148. <summary>
  59149. Serves as a hash function for a <see cref="T:MailKit.MetadataTag"/> object.
  59150. </summary>
  59151. <remarks>
  59152. Serves as a hash function for a <see cref="T:MailKit.MetadataTag"/> object.
  59153. </remarks>
  59154. <returns>A hash code for this instance that is suitable for use in hashing algorithms and data structures such as a hash table.</returns>
  59155. </member>
  59156. <member name="M:MailKit.MetadataTag.ToString">
  59157. <summary>
  59158. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.MetadataTag"/>.
  59159. </summary>
  59160. <remarks>
  59161. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.MetadataTag"/>.
  59162. </remarks>
  59163. <returns>A <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.MetadataTag"/>.</returns>
  59164. </member>
  59165. <member name="T:MailKit.ModSeqChangedEventArgs">
  59166. <summary>
  59167. Event args for the <see cref="E:MailKit.IMailFolder.ModSeqChanged"/> event.
  59168. </summary>
  59169. <remarks>
  59170. Event args for the <see cref="E:MailKit.IMailFolder.ModSeqChanged"/> event.
  59171. </remarks>
  59172. </member>
  59173. <member name="M:MailKit.ModSeqChangedEventArgs.#ctor(System.Int32)">
  59174. <summary>
  59175. Initializes a new instance of the <see cref="T:MailKit.ModSeqChangedEventArgs"/> class.
  59176. </summary>
  59177. <remarks>
  59178. Creates a new <see cref="T:MailKit.ModSeqChangedEventArgs"/>.
  59179. </remarks>
  59180. <param name="index">The message index.</param>
  59181. </member>
  59182. <member name="M:MailKit.ModSeqChangedEventArgs.#ctor(System.Int32,System.UInt64)">
  59183. <summary>
  59184. Initializes a new instance of the <see cref="T:MailKit.MessageFlagsChangedEventArgs"/> class.
  59185. </summary>
  59186. <remarks>
  59187. Creates a new <see cref="T:MailKit.MessageFlagsChangedEventArgs"/>.
  59188. </remarks>
  59189. <param name="index">The message index.</param>
  59190. <param name="modseq">The modification sequence value.</param>
  59191. </member>
  59192. <member name="M:MailKit.ModSeqChangedEventArgs.#ctor(System.Int32,MailKit.UniqueId,System.UInt64)">
  59193. <summary>
  59194. Initializes a new instance of the <see cref="T:MailKit.ModSeqChangedEventArgs"/> class.
  59195. </summary>
  59196. <remarks>
  59197. Creates a new <see cref="T:MailKit.ModSeqChangedEventArgs"/>.
  59198. </remarks>
  59199. <param name="index">The message index.</param>
  59200. <param name="uid">The unique id of the message.</param>
  59201. <param name="modseq">The modification sequence value.</param>
  59202. </member>
  59203. <member name="P:MailKit.ModSeqChangedEventArgs.ModSeq">
  59204. <summary>
  59205. Gets the updated mod-sequence value of the message.
  59206. </summary>
  59207. <remarks>
  59208. Gets the updated mod-sequence value of the message.
  59209. </remarks>
  59210. <value>The mod-sequence value.</value>
  59211. </member>
  59212. <member name="T:MailKit.NullProtocolLogger">
  59213. <summary>
  59214. A protocol logger that does not log to anywhere.
  59215. </summary>
  59216. <remarks>
  59217. By default, the <see cref="T:MailKit.Net.Smtp.SmtpClient"/>,
  59218. <see cref="T:MailKit.Net.Pop3.Pop3Client"/>, and
  59219. <see cref="T:MailKit.Net.Imap.ImapClient"/> all use a
  59220. <see cref="T:MailKit.NullProtocolLogger"/>.
  59221. </remarks>
  59222. </member>
  59223. <member name="M:MailKit.NullProtocolLogger.#ctor">
  59224. <summary>
  59225. Initializes a new instance of the <see cref="T:MailKit.NullProtocolLogger"/> class.
  59226. </summary>
  59227. <remarks>
  59228. Creates a new <see cref="T:MailKit.NullProtocolLogger"/>.
  59229. </remarks>
  59230. </member>
  59231. <member name="M:MailKit.NullProtocolLogger.LogConnect(System.Uri)">
  59232. <summary>
  59233. Logs a connection to the specified URI.
  59234. </summary>
  59235. <remarks>
  59236. This method does nothing.
  59237. </remarks>
  59238. <param name="uri">The URI.</param>
  59239. </member>
  59240. <member name="M:MailKit.NullProtocolLogger.LogClient(System.Byte[],System.Int32,System.Int32)">
  59241. <summary>
  59242. Logs a sequence of bytes sent by the client.
  59243. </summary>
  59244. <remarks>
  59245. This method does nothing.
  59246. </remarks>
  59247. <param name='buffer'>The buffer to log.</param>
  59248. <param name='offset'>The offset of the first byte to log.</param>
  59249. <param name='count'>The number of bytes to log.</param>
  59250. <exception cref="T:System.ArgumentNullException">
  59251. <paramref name="buffer"/> is <c>null</c>.
  59252. </exception>
  59253. </member>
  59254. <member name="M:MailKit.NullProtocolLogger.LogServer(System.Byte[],System.Int32,System.Int32)">
  59255. <summary>
  59256. Logs a sequence of bytes sent by the server.
  59257. </summary>
  59258. <remarks>
  59259. This method does nothing.
  59260. </remarks>
  59261. <param name='buffer'>The buffer to log.</param>
  59262. <param name='offset'>The offset of the first byte to log.</param>
  59263. <param name='count'>The number of bytes to log.</param>
  59264. <exception cref="T:System.ArgumentNullException">
  59265. <paramref name="buffer"/> is <c>null</c>.
  59266. </exception>
  59267. </member>
  59268. <member name="M:MailKit.NullProtocolLogger.Dispose">
  59269. <summary>
  59270. Releases all resource used by the <see cref="T:MailKit.NullProtocolLogger"/> object.
  59271. </summary>
  59272. <remarks>Call <see cref="M:MailKit.NullProtocolLogger.Dispose"/> when you are finished using the <see cref="T:MailKit.NullProtocolLogger"/>. The
  59273. <see cref="M:MailKit.NullProtocolLogger.Dispose"/> method leaves the <see cref="T:MailKit.NullProtocolLogger"/> in an unusable state. After
  59274. calling <see cref="M:MailKit.NullProtocolLogger.Dispose"/>, you must release all references to the <see cref="T:MailKit.NullProtocolLogger"/> so
  59275. the garbage collector can reclaim the memory that the <see cref="T:MailKit.NullProtocolLogger"/> was occupying.</remarks>
  59276. </member>
  59277. <member name="T:MailKit.ProtocolException">
  59278. <summary>
  59279. The exception that is thrown when there is a protocol error.
  59280. </summary>
  59281. <remarks>
  59282. <para>A <see cref="T:MailKit.ProtocolException"/> can be thrown by any of the various client
  59283. methods in MailKit.</para>
  59284. <para>Since many protocol exceptions are fatal, it is important to check whether
  59285. or not the client is still connected using the <see cref="P:MailKit.IMailService.IsConnected"/>
  59286. property when this exception is thrown.</para>
  59287. </remarks>
  59288. </member>
  59289. <member name="M:MailKit.ProtocolException.#ctor(System.String,System.Exception)">
  59290. <summary>
  59291. Initializes a new instance of the <see cref="T:MailKit.ProtocolException"/> class.
  59292. </summary>
  59293. <remarks>
  59294. Creates a new <see cref="T:MailKit.ProtocolException"/>.
  59295. </remarks>
  59296. <param name="message">The error message.</param>
  59297. <param name="innerException">An inner exception.</param>
  59298. </member>
  59299. <member name="M:MailKit.ProtocolException.#ctor(System.String)">
  59300. <summary>
  59301. Initializes a new instance of the <see cref="T:MailKit.ProtocolException"/> class.
  59302. </summary>
  59303. <remarks>
  59304. Creates a new <see cref="T:MailKit.ProtocolException"/>.
  59305. </remarks>
  59306. <param name="message">The error message.</param>
  59307. </member>
  59308. <member name="M:MailKit.ProtocolException.#ctor">
  59309. <summary>
  59310. Initializes a new instance of the <see cref="T:MailKit.ProtocolException"/> class.
  59311. </summary>
  59312. <remarks>
  59313. Creates a new <see cref="T:MailKit.ProtocolException"/>.
  59314. </remarks>
  59315. </member>
  59316. <member name="T:MailKit.ProtocolLogger">
  59317. <summary>
  59318. A default protocol logger for logging the communication between a client and server.
  59319. </summary>
  59320. <remarks>
  59321. A default protocol logger for logging the communication between a client and server.
  59322. </remarks>
  59323. <example>
  59324. <code language="c#" source="Examples\SmtpExamples.cs" region="ProtocolLogger" />
  59325. </example>
  59326. </member>
  59327. <member name="M:MailKit.ProtocolLogger.#ctor(System.String,System.Boolean)">
  59328. <summary>
  59329. Initializes a new instance of the <see cref="T:MailKit.ProtocolLogger"/> class.
  59330. </summary>
  59331. <remarks>
  59332. Creates a new <see cref="T:MailKit.ProtocolLogger"/> to log to a specified file. The file is created if it does not exist.
  59333. </remarks>
  59334. <example>
  59335. <code language="c#" source="Examples\SmtpExamples.cs" region="ProtocolLogger" />
  59336. </example>
  59337. <param name="fileName">The file name.</param>
  59338. <param name="append"><c>true</c> if the file should be appended to; otherwise, <c>false</c>. Defaults to <c>true</c>.</param>
  59339. </member>
  59340. <member name="M:MailKit.ProtocolLogger.#ctor(System.IO.Stream,System.Boolean)">
  59341. <summary>
  59342. Initializes a new instance of the <see cref="T:MailKit.ProtocolLogger"/> class.
  59343. </summary>
  59344. <remarks>
  59345. Creates a new <see cref="T:MailKit.ProtocolLogger"/> to log to a specified stream.
  59346. </remarks>
  59347. <param name="stream">The stream.</param>
  59348. <param name="leaveOpen"><c>true</c> if the stream should be left open after the protocol logger is disposed.</param>
  59349. </member>
  59350. <member name="M:MailKit.ProtocolLogger.Finalize">
  59351. <summary>
  59352. Releases unmanaged resources and performs other cleanup operations before the <see cref="T:MailKit.ProtocolLogger"/>
  59353. is reclaimed by garbage collection.
  59354. </summary>
  59355. <remarks>
  59356. Releases unmanaged resources and performs other cleanup operations before the <see cref="T:MailKit.ProtocolLogger"/>
  59357. is reclaimed by garbage collection.
  59358. </remarks>
  59359. </member>
  59360. <member name="P:MailKit.ProtocolLogger.Stream">
  59361. <summary>
  59362. Get the log stream.
  59363. </summary>
  59364. <remarks>
  59365. Gets the log stream.
  59366. </remarks>
  59367. <value>The log sstream.</value>
  59368. </member>
  59369. <member name="M:MailKit.ProtocolLogger.LogConnect(System.Uri)">
  59370. <summary>
  59371. Logs a connection to the specified URI.
  59372. </summary>
  59373. <remarks>
  59374. Logs a connection to the specified URI.
  59375. </remarks>
  59376. <param name="uri">The URI.</param>
  59377. <exception cref="T:System.ArgumentNullException">
  59378. <paramref name="uri"/> is <c>null</c>.
  59379. </exception>
  59380. <exception cref="T:System.ObjectDisposedException">
  59381. The logger has been disposed.
  59382. </exception>
  59383. <exception cref="T:System.IO.IOException">
  59384. An I/O error occurred.
  59385. </exception>
  59386. </member>
  59387. <member name="M:MailKit.ProtocolLogger.LogClient(System.Byte[],System.Int32,System.Int32)">
  59388. <summary>
  59389. Logs a sequence of bytes sent by the client.
  59390. </summary>
  59391. <remarks>
  59392. <para>Logs a sequence of bytes sent by the client.</para>
  59393. <para><see cref="M:MailKit.ProtocolLogger.LogClient(System.Byte[],System.Int32,System.Int32)"/> is called by the <see cref="T:MailKit.IMailService"/> upon every successful
  59394. write operation to its underlying network stream, passing the exact same <paramref name="buffer"/>,
  59395. <paramref name="offset"/>, and <paramref name="count"/> arguments to the logging function.</para>
  59396. </remarks>
  59397. <param name='buffer'>The buffer to log.</param>
  59398. <param name='offset'>The offset of the first byte to log.</param>
  59399. <param name='count'>The number of bytes to log.</param>
  59400. <exception cref="T:System.ArgumentNullException">
  59401. <paramref name="buffer"/> is <c>null</c>.
  59402. </exception>
  59403. <exception cref="T:System.ArgumentOutOfRangeException">
  59404. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  59405. <para>-or-</para>
  59406. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  59407. at the specified <paramref name="offset"/>.</para>
  59408. </exception>
  59409. <exception cref="T:System.ObjectDisposedException">
  59410. The logger has been disposed.
  59411. </exception>
  59412. <exception cref="T:System.IO.IOException">
  59413. An I/O error occurred.
  59414. </exception>
  59415. </member>
  59416. <member name="M:MailKit.ProtocolLogger.LogServer(System.Byte[],System.Int32,System.Int32)">
  59417. <summary>
  59418. Logs a sequence of bytes sent by the server.
  59419. </summary>
  59420. <remarks>
  59421. <para>Logs a sequence of bytes sent by the server.</para>
  59422. <para><see cref="M:MailKit.ProtocolLogger.LogServer(System.Byte[],System.Int32,System.Int32)"/> is called by the <see cref="T:MailKit.IMailService"/> upon every successful
  59423. read of its underlying network stream with the exact buffer that was read.</para>
  59424. </remarks>
  59425. <param name='buffer'>The buffer to log.</param>
  59426. <param name='offset'>The offset of the first byte to log.</param>
  59427. <param name='count'>The number of bytes to log.</param>
  59428. <exception cref="T:System.ArgumentNullException">
  59429. <paramref name="buffer"/> is <c>null</c>.
  59430. </exception>
  59431. <exception cref="T:System.ArgumentOutOfRangeException">
  59432. <para><paramref name="offset"/> is less than zero or greater than the length of <paramref name="buffer"/>.</para>
  59433. <para>-or-</para>
  59434. <para>The <paramref name="buffer"/> is not large enough to contain <paramref name="count"/> bytes strting
  59435. at the specified <paramref name="offset"/>.</para>
  59436. </exception>
  59437. <exception cref="T:System.ObjectDisposedException">
  59438. The logger has been disposed.
  59439. </exception>
  59440. <exception cref="T:System.IO.IOException">
  59441. An I/O error occurred.
  59442. </exception>
  59443. </member>
  59444. <member name="M:MailKit.ProtocolLogger.Dispose(System.Boolean)">
  59445. <summary>
  59446. Releases the unmanaged resources used by the <see cref="T:MailKit.ProtocolLogger"/> and
  59447. optionally releases the managed resources.
  59448. </summary>
  59449. <remarks>
  59450. Releases the unmanaged resources used by the <see cref="T:MailKit.ProtocolLogger"/> and
  59451. optionally releases the managed resources.
  59452. </remarks>
  59453. <param name="disposing"><c>true</c> to release both managed and unmanaged resources;
  59454. <c>false</c> to release only the unmanaged resources.</param>
  59455. </member>
  59456. <member name="M:MailKit.ProtocolLogger.Dispose">
  59457. <summary>
  59458. Releases all resource used by the <see cref="T:MailKit.ProtocolLogger"/> object.
  59459. </summary>
  59460. <remarks>Call <see cref="M:MailKit.ProtocolLogger.Dispose"/> when you are finished using the <see cref="T:MailKit.ProtocolLogger"/>. The
  59461. <see cref="M:MailKit.ProtocolLogger.Dispose"/> method leaves the <see cref="T:MailKit.ProtocolLogger"/> in an unusable state. After calling
  59462. <see cref="M:MailKit.ProtocolLogger.Dispose"/>, you must release all references to the <see cref="T:MailKit.ProtocolLogger"/> so the garbage
  59463. collector can reclaim the memory that the <see cref="T:MailKit.ProtocolLogger"/> was occupying.</remarks>
  59464. </member>
  59465. <member name="T:MailKit.ServiceNotAuthenticatedException">
  59466. <summary>
  59467. The exception that is thrown when the <see cref="T:MailKit.IMailService"/> is not authenticated.
  59468. </summary>
  59469. <remarks>
  59470. This exception is thrown when an operation on a service could not be completed
  59471. due to the service not being authenticated.
  59472. </remarks>
  59473. </member>
  59474. <member name="M:MailKit.ServiceNotAuthenticatedException.#ctor(System.String,System.Exception)">
  59475. <summary>
  59476. Initializes a new instance of the <see cref="T:MailKit.ServiceNotAuthenticatedException"/> class.
  59477. </summary>
  59478. <remarks>
  59479. Creates a new <see cref="T:MailKit.ServiceNotAuthenticatedException"/>.
  59480. </remarks>
  59481. <param name="message">The error message.</param>
  59482. <param name="innerException">The inner exception.</param>
  59483. </member>
  59484. <member name="M:MailKit.ServiceNotAuthenticatedException.#ctor(System.String)">
  59485. <summary>
  59486. Initializes a new instance of the <see cref="T:MailKit.ServiceNotAuthenticatedException"/> class.
  59487. </summary>
  59488. <remarks>
  59489. Creates a new <see cref="T:MailKit.ServiceNotAuthenticatedException"/>.
  59490. </remarks>
  59491. <param name="message">The error message.</param>
  59492. </member>
  59493. <member name="M:MailKit.ServiceNotAuthenticatedException.#ctor">
  59494. <summary>
  59495. Initializes a new instance of the <see cref="T:MailKit.ServiceNotAuthenticatedException"/> class.
  59496. </summary>
  59497. <remarks>
  59498. Creates a new <see cref="T:MailKit.ServiceNotAuthenticatedException"/>.
  59499. </remarks>
  59500. </member>
  59501. <member name="T:MailKit.ServiceNotConnectedException">
  59502. <summary>
  59503. The exception that is thrown when the <see cref="T:MailKit.IMailService"/> is not connected.
  59504. </summary>
  59505. <remarks>
  59506. This exception is thrown when an operation on a service could not be completed
  59507. due to the service not being connected.
  59508. </remarks>
  59509. </member>
  59510. <member name="M:MailKit.ServiceNotConnectedException.#ctor(System.String,System.Exception)">
  59511. <summary>
  59512. Initializes a new instance of the <see cref="T:MailKit.ServiceNotConnectedException"/> class.
  59513. </summary>
  59514. <remarks>
  59515. Creates a new <see cref="T:MailKit.ServiceNotConnectedException"/>.
  59516. </remarks>
  59517. <param name="message">The error message.</param>
  59518. <param name="innerException">The inner exception.</param>
  59519. </member>
  59520. <member name="M:MailKit.ServiceNotConnectedException.#ctor(System.String)">
  59521. <summary>
  59522. Initializes a new instance of the <see cref="T:MailKit.ServiceNotConnectedException"/> class.
  59523. </summary>
  59524. <remarks>
  59525. Creates a new <see cref="T:MailKit.ServiceNotConnectedException"/>.
  59526. </remarks>
  59527. <param name="message">The error message.</param>
  59528. </member>
  59529. <member name="M:MailKit.ServiceNotConnectedException.#ctor">
  59530. <summary>
  59531. Initializes a new instance of the <see cref="T:MailKit.ServiceNotConnectedException"/> class.
  59532. </summary>
  59533. <remarks>
  59534. Creates a new <see cref="T:MailKit.ServiceNotConnectedException"/>.
  59535. </remarks>
  59536. </member>
  59537. <member name="T:MailKit.SpecialFolder">
  59538. <summary>
  59539. An enumeration of special folders.
  59540. </summary>
  59541. <remarks>
  59542. An enumeration of special folders.
  59543. </remarks>
  59544. </member>
  59545. <member name="F:MailKit.SpecialFolder.All">
  59546. <summary>
  59547. The special folder containing an aggregate of all messages.
  59548. </summary>
  59549. </member>
  59550. <member name="F:MailKit.SpecialFolder.Archive">
  59551. <summary>
  59552. The special folder that contains archived messages.
  59553. </summary>
  59554. </member>
  59555. <member name="F:MailKit.SpecialFolder.Drafts">
  59556. <summary>
  59557. The special folder that contains message drafts.
  59558. </summary>
  59559. </member>
  59560. <member name="F:MailKit.SpecialFolder.Flagged">
  59561. <summary>
  59562. The special folder that contains important messages.
  59563. </summary>
  59564. </member>
  59565. <member name="F:MailKit.SpecialFolder.Junk">
  59566. <summary>
  59567. The special folder that contains spam messages.
  59568. </summary>
  59569. </member>
  59570. <member name="F:MailKit.SpecialFolder.Sent">
  59571. <summary>
  59572. The special folder that contains sent messages.
  59573. </summary>
  59574. </member>
  59575. <member name="F:MailKit.SpecialFolder.Trash">
  59576. <summary>
  59577. The special folder that contains deleted messages.
  59578. </summary>
  59579. </member>
  59580. <member name="T:MailKit.StatusItems">
  59581. <summary>
  59582. Status items.
  59583. </summary>
  59584. <remarks>
  59585. Used with <see cref="M:MailKit.IMailFolder.Status(MailKit.StatusItems,System.Threading.CancellationToken)"/>
  59586. </remarks>
  59587. </member>
  59588. <member name="F:MailKit.StatusItems.None">
  59589. <summary>
  59590. No status requested.
  59591. </summary>
  59592. </member>
  59593. <member name="F:MailKit.StatusItems.Count">
  59594. <summary>
  59595. Updates <see cref="P:MailKit.IMailFolder.Count"/>.
  59596. </summary>
  59597. </member>
  59598. <member name="F:MailKit.StatusItems.Recent">
  59599. <summary>
  59600. Updates <see cref="P:MailKit.IMailFolder.Recent"/>.
  59601. </summary>
  59602. </member>
  59603. <member name="F:MailKit.StatusItems.UidNext">
  59604. <summary>
  59605. Updates <see cref="P:MailKit.IMailFolder.UidNext"/>.
  59606. </summary>
  59607. </member>
  59608. <member name="F:MailKit.StatusItems.UidValidity">
  59609. <summary>
  59610. Updates <see cref="P:MailKit.IMailFolder.UidValidity"/>.
  59611. </summary>
  59612. </member>
  59613. <member name="F:MailKit.StatusItems.Unread">
  59614. <summary>
  59615. Updates <see cref="P:MailKit.IMailFolder.Unread"/>.
  59616. </summary>
  59617. </member>
  59618. <member name="F:MailKit.StatusItems.HighestModSeq">
  59619. <summary>
  59620. Updates <see cref="P:MailKit.IMailFolder.HighestModSeq"/>.
  59621. </summary>
  59622. </member>
  59623. <member name="F:MailKit.StatusItems.AppendLimit">
  59624. <summary>
  59625. Updates <see cref="P:MailKit.IMailFolder.AppendLimit"/>.
  59626. </summary>
  59627. </member>
  59628. <member name="F:MailKit.StatusItems.Size">
  59629. <summary>
  59630. Updates <see cref="P:MailKit.IMailFolder.Size"/>.
  59631. </summary>
  59632. </member>
  59633. <member name="F:MailKit.StatusItems.MailboxId">
  59634. <summary>
  59635. Updates <see cref="P:MailKit.IMailFolder.Id"/>.
  59636. </summary>
  59637. </member>
  59638. <member name="T:MailKit.ThreadingAlgorithm">
  59639. <summary>
  59640. An enumeration of threading algorithms.
  59641. </summary>
  59642. <remarks>
  59643. A threading algorithm is used to group messages and their
  59644. replies together.
  59645. </remarks>
  59646. </member>
  59647. <member name="F:MailKit.ThreadingAlgorithm.OrderedSubject">
  59648. <summary>
  59649. Thread messages based on their Subject headers.
  59650. </summary>
  59651. </member>
  59652. <member name="F:MailKit.ThreadingAlgorithm.References">
  59653. <summary>
  59654. Threads messages based on their References, In-Reply-To, and Message-Id headers.
  59655. This algorithm is far better than <see cref="F:MailKit.ThreadingAlgorithm.OrderedSubject"/> but is also more
  59656. expensive to calculate.
  59657. </summary>
  59658. </member>
  59659. <member name="T:MailKit.UniqueId">
  59660. <summary>
  59661. A unique identifier.
  59662. </summary>
  59663. <remarks>
  59664. Represents a unique identifier for messages in a <see cref="T:MailKit.IMailFolder"/>.
  59665. </remarks>
  59666. </member>
  59667. <member name="F:MailKit.UniqueId.Invalid">
  59668. <summary>
  59669. The invalid <see cref="T:MailKit.UniqueId"/> value.
  59670. </summary>
  59671. <remarks>
  59672. The invalid <see cref="T:MailKit.UniqueId"/> value.
  59673. </remarks>
  59674. </member>
  59675. <member name="F:MailKit.UniqueId.MinValue">
  59676. <summary>
  59677. The minimum <see cref="T:MailKit.UniqueId"/> value.
  59678. </summary>
  59679. <remarks>
  59680. The minimum <see cref="T:MailKit.UniqueId"/> value.
  59681. </remarks>
  59682. </member>
  59683. <member name="F:MailKit.UniqueId.MaxValue">
  59684. <summary>
  59685. The maximum <see cref="T:MailKit.UniqueId"/> value.
  59686. </summary>
  59687. <remarks>
  59688. The maximum <see cref="T:MailKit.UniqueId"/> value.
  59689. </remarks>
  59690. </member>
  59691. <member name="M:MailKit.UniqueId.#ctor(System.UInt32,System.UInt32)">
  59692. <summary>
  59693. Initializes a new instance of the <see cref="T:MailKit.UniqueId"/> struct.
  59694. </summary>
  59695. <remarks>
  59696. Creates a new <see cref="T:MailKit.UniqueId"/> with the specified validity and value.
  59697. </remarks>
  59698. <param name="validity">The uid validity.</param>
  59699. <param name="id">The unique identifier.</param>
  59700. <exception cref="T:System.ArgumentOutOfRangeException">
  59701. <paramref name="id"/> is <c>0</c>.
  59702. </exception>
  59703. </member>
  59704. <member name="M:MailKit.UniqueId.#ctor(System.UInt32)">
  59705. <summary>
  59706. Initializes a new instance of the <see cref="T:MailKit.UniqueId"/> struct.
  59707. </summary>
  59708. <remarks>
  59709. Creates a new <see cref="T:MailKit.UniqueId"/> with the specified value.
  59710. </remarks>
  59711. <param name="id">The unique identifier.</param>
  59712. <exception cref="T:System.ArgumentOutOfRangeException">
  59713. <paramref name="id"/> is <c>0</c>.
  59714. </exception>
  59715. </member>
  59716. <member name="P:MailKit.UniqueId.Id">
  59717. <summary>
  59718. Gets the identifier.
  59719. </summary>
  59720. <remarks>
  59721. The identifier.
  59722. </remarks>
  59723. <value>The identifier.</value>
  59724. </member>
  59725. <member name="P:MailKit.UniqueId.Validity">
  59726. <summary>
  59727. Gets the validity, if non-zero.
  59728. </summary>
  59729. <remarks>
  59730. Gets the UidValidity of the containing folder.
  59731. </remarks>
  59732. <value>The UidValidity of the containing folder.</value>
  59733. </member>
  59734. <member name="P:MailKit.UniqueId.IsValid">
  59735. <summary>
  59736. Gets whether or not the unique identifier is valid.
  59737. </summary>
  59738. <remarks>
  59739. Gets whether or not the unique identifier is valid.
  59740. </remarks>
  59741. <value><c>true</c> if the unique identifier is valid; otherwise, <c>false</c>.</value>
  59742. </member>
  59743. <member name="M:MailKit.UniqueId.CompareTo(MailKit.UniqueId)">
  59744. <summary>
  59745. Compares two <see cref="T:MailKit.UniqueId"/> objects.
  59746. </summary>
  59747. <remarks>
  59748. Compares two <see cref="T:MailKit.UniqueId"/> objects.
  59749. </remarks>
  59750. <returns>
  59751. A value less than <c>0</c> if this <see cref="T:MailKit.UniqueId"/> is less than <paramref name="other"/>,
  59752. a value of <c>0</c> if this <see cref="T:MailKit.UniqueId"/> is equal to <paramref name="other"/>, or
  59753. a value greater than <c>0</c> if this <see cref="T:MailKit.UniqueId"/> is greater than <paramref name="other"/>.
  59754. </returns>
  59755. <param name="other">The other unique identifier.</param>
  59756. </member>
  59757. <member name="M:MailKit.UniqueId.Equals(MailKit.UniqueId)">
  59758. <summary>
  59759. Determines whether the specified <see cref="T:MailKit.UniqueId"/> is equal to the current <see cref="T:MailKit.UniqueId"/>.
  59760. </summary>
  59761. <remarks>
  59762. Determines whether the specified <see cref="T:MailKit.UniqueId"/> is equal to the current <see cref="T:MailKit.UniqueId"/>.
  59763. </remarks>
  59764. <param name="other">The <see cref="T:MailKit.UniqueId"/> to compare with the current <see cref="T:MailKit.UniqueId"/>.</param>
  59765. <returns><c>true</c> if the specified <see cref="T:MailKit.UniqueId"/> is equal to the current
  59766. <see cref="T:MailKit.UniqueId"/>; otherwise, <c>false</c>.</returns>
  59767. </member>
  59768. <member name="M:MailKit.UniqueId.op_Equality(MailKit.UniqueId,MailKit.UniqueId)">
  59769. <summary>
  59770. Determines whether two unique identifiers are equal.
  59771. </summary>
  59772. <remarks>
  59773. Determines whether two unique identifiers are equal.
  59774. </remarks>
  59775. <returns><c>true</c> if <paramref name="uid1"/> and <paramref name="uid2"/> are equal; otherwise, <c>false</c>.</returns>
  59776. <param name="uid1">The first unique id to compare.</param>
  59777. <param name="uid2">The second unique id to compare.</param>
  59778. </member>
  59779. <member name="M:MailKit.UniqueId.op_GreaterThan(MailKit.UniqueId,MailKit.UniqueId)">
  59780. <summary>
  59781. Determines whether one unique identifier is greater than another unique identifier.
  59782. </summary>
  59783. <remarks>
  59784. Determines whether one unique identifier is greater than another unique identifier.
  59785. </remarks>
  59786. <returns><c>true</c> if <paramref name="uid1"/> is greater than <paramref name="uid2"/>; otherwise, <c>false</c>.</returns>
  59787. <param name="uid1">The first unique id to compare.</param>
  59788. <param name="uid2">The second unique id to compare.</param>
  59789. </member>
  59790. <member name="M:MailKit.UniqueId.op_GreaterThanOrEqual(MailKit.UniqueId,MailKit.UniqueId)">
  59791. <summary>
  59792. Determines whether one unique identifier is greater than or equal to another unique identifier.
  59793. </summary>
  59794. <remarks>
  59795. Determines whether one unique identifier is greater than or equal to another unique identifier.
  59796. </remarks>
  59797. <returns><c>true</c> if <paramref name="uid1"/> is greater than or equal to <paramref name="uid2"/>; otherwise, <c>false</c>.</returns>
  59798. <param name="uid1">The first unique id to compare.</param>
  59799. <param name="uid2">The second unique id to compare.</param>
  59800. </member>
  59801. <member name="M:MailKit.UniqueId.op_Inequality(MailKit.UniqueId,MailKit.UniqueId)">
  59802. <summary>
  59803. Determines whether two unique identifiers are not equal.
  59804. </summary>
  59805. <remarks>
  59806. Determines whether two unique identifiers are not equal.
  59807. </remarks>
  59808. <returns><c>true</c> if <paramref name="uid1"/> and <paramref name="uid2"/> are not equal; otherwise, <c>false</c>.</returns>
  59809. <param name="uid1">The first unique id to compare.</param>
  59810. <param name="uid2">The second unique id to compare.</param>
  59811. </member>
  59812. <member name="M:MailKit.UniqueId.op_LessThan(MailKit.UniqueId,MailKit.UniqueId)">
  59813. <summary>
  59814. Determines whether one unique identifier is less than another unique identifier.
  59815. </summary>
  59816. <remarks>
  59817. Determines whether one unique identifier is less than another unique identifier.
  59818. </remarks>
  59819. <returns><c>true</c> if <paramref name="uid1"/> is less than <paramref name="uid2"/>; otherwise, <c>false</c>.</returns>
  59820. <param name="uid1">The first unique id to compare.</param>
  59821. <param name="uid2">The second unique id to compare.</param>
  59822. </member>
  59823. <member name="M:MailKit.UniqueId.op_LessThanOrEqual(MailKit.UniqueId,MailKit.UniqueId)">
  59824. <summary>
  59825. Determines whether one unique identifier is less than or equal to another unique identifier.
  59826. </summary>
  59827. <remarks>
  59828. Determines whether one unique identifier is less than or equal to another unique identifier.
  59829. </remarks>
  59830. <returns><c>true</c> if <paramref name="uid1"/> is less than or equal to <paramref name="uid2"/>; otherwise, <c>false</c>.</returns>
  59831. <param name="uid1">The first unique id to compare.</param>
  59832. <param name="uid2">The second unique id to compare.</param>
  59833. </member>
  59834. <member name="M:MailKit.UniqueId.Equals(System.Object)">
  59835. <summary>
  59836. Determines whether the specified <see cref="T:System.Object"/> is equal to the current <see cref="T:MailKit.UniqueId"/>.
  59837. </summary>
  59838. <remarks>
  59839. Determines whether the specified <see cref="T:System.Object"/> is equal to the current <see cref="T:MailKit.UniqueId"/>.
  59840. </remarks>
  59841. <param name="obj">The <see cref="T:System.Object"/> to compare with the current <see cref="T:MailKit.UniqueId"/>.</param>
  59842. <returns><c>true</c> if the specified <see cref="T:System.Object"/> is equal to the current <see cref="T:MailKit.UniqueId"/>;
  59843. otherwise, <c>false</c>.</returns>
  59844. </member>
  59845. <member name="M:MailKit.UniqueId.GetHashCode">
  59846. <summary>
  59847. Serves as a hash function for a <see cref="T:MailKit.UniqueId"/> object.
  59848. </summary>
  59849. <remarks>
  59850. Serves as a hash function for a <see cref="T:MailKit.UniqueId"/> object.
  59851. </remarks>
  59852. <returns>A hash code for this instance that is suitable for use in hashing algorithms and data structures such as a hash table.</returns>
  59853. </member>
  59854. <member name="M:MailKit.UniqueId.ToString">
  59855. <summary>
  59856. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.UniqueId"/>.
  59857. </summary>
  59858. <remarks>
  59859. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.UniqueId"/>.
  59860. </remarks>
  59861. <returns>A <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.UniqueId"/>.</returns>
  59862. </member>
  59863. <member name="M:MailKit.UniqueId.TryParse(System.String,System.Int32@,System.UInt32@)">
  59864. <summary>
  59865. Attempt to parse a unique identifier.
  59866. </summary>
  59867. <remarks>
  59868. Attempts to parse a unique identifier.
  59869. </remarks>
  59870. <returns><c>true</c> if the unique identifier was successfully parsed; otherwise, <c>false.</c>.</returns>
  59871. <param name="token">The token to parse.</param>
  59872. <param name="index">The index to start parsing.</param>
  59873. <param name="uid">The unique identifier.</param>
  59874. </member>
  59875. <member name="M:MailKit.UniqueId.TryParse(System.String,System.UInt32,MailKit.UniqueId@)">
  59876. <summary>
  59877. Attempt to parse a unique identifier.
  59878. </summary>
  59879. <remarks>
  59880. Attempts to parse a unique identifier.
  59881. </remarks>
  59882. <returns><c>true</c> if the unique identifier was successfully parsed; otherwise, <c>false.</c>.</returns>
  59883. <param name="token">The token to parse.</param>
  59884. <param name="validity">The UIDVALIDITY value.</param>
  59885. <param name="uid">The unique identifier.</param>
  59886. <exception cref="T:System.ArgumentNullException">
  59887. <paramref name="token"/> is <c>null</c>.
  59888. </exception>
  59889. </member>
  59890. <member name="M:MailKit.UniqueId.TryParse(System.String,MailKit.UniqueId@)">
  59891. <summary>
  59892. Attempt to parse a unique identifier.
  59893. </summary>
  59894. <remarks>
  59895. Attempts to parse a unique identifier.
  59896. </remarks>
  59897. <returns><c>true</c> if the unique identifier was successfully parsed; otherwise, <c>false.</c>.</returns>
  59898. <param name="token">The token to parse.</param>
  59899. <param name="uid">The unique identifier.</param>
  59900. <exception cref="T:System.ArgumentNullException">
  59901. <paramref name="token"/> is <c>null</c>.
  59902. </exception>
  59903. </member>
  59904. <member name="M:MailKit.UniqueId.Parse(System.String,System.UInt32)">
  59905. <summary>
  59906. Parse a unique identifier.
  59907. </summary>
  59908. <remarks>
  59909. Parses a unique identifier.
  59910. </remarks>
  59911. <returns>The unique identifier.</returns>
  59912. <param name="token">A string containing the unique identifier.</param>
  59913. <param name="validity">The UIDVALIDITY.</param>
  59914. <exception cref="T:System.ArgumentNullException">
  59915. <paramref name="token"/> is <c>null</c>.
  59916. </exception>
  59917. <exception cref="T:System.FormatException">
  59918. <paramref name="token"/> is not in the correct format.
  59919. </exception>
  59920. <exception cref="T:System.OverflowException">
  59921. The unique identifier is greater than <see cref="F:MailKit.UniqueId.MaxValue"/>.
  59922. </exception>
  59923. </member>
  59924. <member name="M:MailKit.UniqueId.Parse(System.String)">
  59925. <summary>
  59926. Parse a unique identifier.
  59927. </summary>
  59928. <remarks>
  59929. Parses a unique identifier.
  59930. </remarks>
  59931. <returns>The unique identifier.</returns>
  59932. <param name="token">A string containing the unique identifier.</param>
  59933. <exception cref="T:System.ArgumentNullException">
  59934. <paramref name="token"/> is <c>null</c>.
  59935. </exception>
  59936. <exception cref="T:System.FormatException">
  59937. <paramref name="token"/> is not in the correct format.
  59938. </exception>
  59939. <exception cref="T:System.OverflowException">
  59940. The unique identifier is greater than <see cref="F:MailKit.UniqueId.MaxValue"/>.
  59941. </exception>
  59942. </member>
  59943. <member name="T:MailKit.UniqueIdMap">
  59944. <summary>
  59945. A mapping of unique identifiers.
  59946. </summary>
  59947. <remarks>
  59948. <para>A <see cref="T:MailKit.UniqueIdMap"/> can be used to discover the mapping of one set of unique identifiers
  59949. to another.</para>
  59950. <para>For example, when copying or moving messages from one folder to another, it is often desirable
  59951. to know what the unique identifiers are for each of the messages in the destination folder.</para>
  59952. </remarks>
  59953. </member>
  59954. <member name="F:MailKit.UniqueIdMap.Empty">
  59955. <summary>
  59956. Any empty mapping of unique identifiers.
  59957. </summary>
  59958. <remarks>
  59959. Any empty mapping of unique identifiers.
  59960. </remarks>
  59961. </member>
  59962. <member name="M:MailKit.UniqueIdMap.#ctor(System.Collections.Generic.IList{MailKit.UniqueId},System.Collections.Generic.IList{MailKit.UniqueId})">
  59963. <summary>
  59964. Initializes a new instance of the <see cref="T:MailKit.UniqueIdMap"/> class.
  59965. </summary>
  59966. <remarks>
  59967. Creates a new <see cref="T:MailKit.UniqueIdMap"/>.
  59968. </remarks>
  59969. <param name="source">The unique identifiers used in the source folder.</param>
  59970. <param name="destination">The unique identifiers used in the destination folder.</param>
  59971. <exception cref="T:System.ArgumentNullException">
  59972. <para><paramref name="source"/> is <c>null</c>.</para>
  59973. <para>-or-</para>
  59974. <para><paramref name="destination"/> is <c>null</c>.</para>
  59975. </exception>
  59976. </member>
  59977. <member name="P:MailKit.UniqueIdMap.Source">
  59978. <summary>
  59979. Gets the list of unique identifiers used in the source folder.
  59980. </summary>
  59981. <remarks>
  59982. Gets the list of unique identifiers used in the source folder.
  59983. </remarks>
  59984. <value>The unique identifiers used in the source folder.</value>
  59985. </member>
  59986. <member name="P:MailKit.UniqueIdMap.Destination">
  59987. <summary>
  59988. Gets the list of unique identifiers used in the destination folder.
  59989. </summary>
  59990. <remarks>
  59991. Gets the list of unique identifiers used in the destination folder.
  59992. </remarks>
  59993. <value>The unique identifiers used in the destination folder.</value>
  59994. </member>
  59995. <member name="P:MailKit.UniqueIdMap.Count">
  59996. <summary>
  59997. Gets the number of unique identifiers that have been remapped.
  59998. </summary>
  59999. <remarks>
  60000. Gets the number of unique identifiers that have been remapped.
  60001. </remarks>
  60002. <value>The count.</value>
  60003. </member>
  60004. <member name="P:MailKit.UniqueIdMap.Keys">
  60005. <summary>
  60006. Gets the keys.
  60007. </summary>
  60008. <remarks>
  60009. Gets the keys.
  60010. </remarks>
  60011. <value>The keys.</value>
  60012. </member>
  60013. <member name="P:MailKit.UniqueIdMap.Values">
  60014. <summary>
  60015. Gets the values.
  60016. </summary>
  60017. <remarks>
  60018. Gets the values.
  60019. </remarks>
  60020. <value>The values.</value>
  60021. </member>
  60022. <member name="M:MailKit.UniqueIdMap.ContainsKey(MailKit.UniqueId)">
  60023. <summary>
  60024. Checks if the specified unique identifier has been remapped.
  60025. </summary>
  60026. <remarks>
  60027. Checks if the specified unique identifier has been remapped.
  60028. </remarks>
  60029. <returns><c>true</c> if the unique identifier has been remapped; otherwise, <c>false</c>.</returns>
  60030. <param name="key">The unique identifier.</param>
  60031. </member>
  60032. <member name="M:MailKit.UniqueIdMap.TryGetValue(MailKit.UniqueId,MailKit.UniqueId@)">
  60033. <summary>
  60034. Tries to get the remapped unique identifier.
  60035. </summary>
  60036. <remarks>
  60037. Attempts to get the remapped unique identifier.
  60038. </remarks>
  60039. <returns><c>true</c> on success; otherwise, <c>false</c>.</returns>
  60040. <param name="key">The unique identifier of the message in the source folder.</param>
  60041. <param name="value">The unique identifier of the message in the destination folder.</param>
  60042. </member>
  60043. <member name="P:MailKit.UniqueIdMap.Item(MailKit.UniqueId)">
  60044. <summary>
  60045. Gets the remapped unique identifier.
  60046. </summary>
  60047. <remarks>
  60048. Gets the remapped unique identifier.
  60049. </remarks>
  60050. <param name="index">The unique identifier of the message in the source folder.</param>
  60051. <exception cref="T:System.ArgumentOutOfRangeException">
  60052. <paramref name="index"/> is out of range.
  60053. </exception>
  60054. </member>
  60055. <member name="M:MailKit.UniqueIdMap.GetEnumerator">
  60056. <summary>
  60057. Gets the enumerator for the remapped unique identifiers.
  60058. </summary>
  60059. <remarks>
  60060. Gets the enumerator for the remapped unique identifiers.
  60061. </remarks>
  60062. <returns>The enumerator.</returns>
  60063. </member>
  60064. <member name="M:MailKit.UniqueIdMap.System#Collections#IEnumerable#GetEnumerator">
  60065. <summary>
  60066. Gets the enumerator for the remapped unique identifiers.
  60067. </summary>
  60068. <remarks>
  60069. Gets the enumerator for the remapped unique identifiers.
  60070. </remarks>
  60071. <returns>The enumerator.</returns>
  60072. </member>
  60073. <member name="T:MailKit.UniqueIdRange">
  60074. <summary>
  60075. A range of <see cref="T:MailKit.UniqueId"/> items.
  60076. </summary>
  60077. <remarks>
  60078. When dealing with a large range, it is more efficient to use a
  60079. <see cref="T:MailKit.UniqueIdRange"/> than a typical
  60080. IList&lt;<see cref="T:MailKit.UniqueId"/>&gt;.
  60081. </remarks>
  60082. </member>
  60083. <member name="F:MailKit.UniqueIdRange.All">
  60084. <summary>
  60085. A <see cref="T:MailKit.UniqueIdRange"/> that encompases all messages in the folder.
  60086. </summary>
  60087. <remarks>
  60088. Represents the range of messages from <see cref="F:MailKit.UniqueId.MinValue"/> to
  60089. <see cref="F:MailKit.UniqueId.MaxValue"/>.
  60090. </remarks>
  60091. </member>
  60092. <member name="M:MailKit.UniqueIdRange.#ctor">
  60093. <summary>
  60094. Initializes a new instance of the <see cref="T:MailKit.UniqueIdRange"/> class.
  60095. </summary>
  60096. <remarks>
  60097. Creates a new (invalid) range of unique identifiers.
  60098. </remarks>
  60099. </member>
  60100. <member name="M:MailKit.UniqueIdRange.#ctor(System.UInt32,System.UInt32,System.UInt32)">
  60101. <summary>
  60102. Initializes a new instance of the <see cref="T:MailKit.UniqueIdRange"/> class.
  60103. </summary>
  60104. <remarks>
  60105. Creates a new range of unique identifiers.
  60106. </remarks>
  60107. <param name="validity">The uid validity.</param>
  60108. <param name="start">The first unique identifier in the range.</param>
  60109. <param name="end">The last unique identifier in the range.</param>
  60110. </member>
  60111. <member name="M:MailKit.UniqueIdRange.#ctor(MailKit.UniqueId,MailKit.UniqueId)">
  60112. <summary>
  60113. Initializes a new instance of the <see cref="T:MailKit.UniqueIdRange"/> class.
  60114. </summary>
  60115. <remarks>
  60116. Creates a new range of unique identifiers.
  60117. </remarks>
  60118. <param name="start">The first <see cref="T:MailKit.UniqueId"/> in the range.</param>
  60119. <param name="end">The last <see cref="T:MailKit.UniqueId"/> in the range.</param>
  60120. <exception cref="T:System.ArgumentOutOfRangeException">
  60121. <para><paramref name="start"/> is invalid.</para>
  60122. <para>-or-</para>
  60123. <para><paramref name="end"/> is invalid.</para>
  60124. </exception>
  60125. </member>
  60126. <member name="P:MailKit.UniqueIdRange.Validity">
  60127. <summary>
  60128. Gets the validity, if non-zero.
  60129. </summary>
  60130. <remarks>
  60131. Gets the UidValidity of the containing folder.
  60132. </remarks>
  60133. <value>The UidValidity of the containing folder.</value>
  60134. </member>
  60135. <member name="P:MailKit.UniqueIdRange.Min">
  60136. <summary>
  60137. Gets the minimum unique identifier in the range.
  60138. </summary>
  60139. <remarks>
  60140. Gets the minimum unique identifier in the range.
  60141. </remarks>
  60142. <value>The minimum unique identifier.</value>
  60143. </member>
  60144. <member name="P:MailKit.UniqueIdRange.Max">
  60145. <summary>
  60146. Gets the maximum unique identifier in the range.
  60147. </summary>
  60148. <remarks>
  60149. Gets the maximum unique identifier in the range.
  60150. </remarks>
  60151. <value>The maximum unique identifier.</value>
  60152. </member>
  60153. <member name="P:MailKit.UniqueIdRange.Start">
  60154. <summary>
  60155. Get the start of the unique identifier range.
  60156. </summary>
  60157. <remarks>
  60158. Gets the start of the unique identifier range.
  60159. </remarks>
  60160. <value>The start of the range.</value>
  60161. </member>
  60162. <member name="P:MailKit.UniqueIdRange.End">
  60163. <summary>
  60164. Get the end of the unique identifier range.
  60165. </summary>
  60166. <remarks>
  60167. Gets the end of the unique identifier range.
  60168. </remarks>
  60169. <value>The end of the range.</value>
  60170. </member>
  60171. <member name="P:MailKit.UniqueIdRange.Count">
  60172. <summary>
  60173. Get the number of unique identifiers in the range.
  60174. </summary>
  60175. <remarks>
  60176. Gets the number of unique identifiers in the range.
  60177. </remarks>
  60178. <value>The count.</value>
  60179. </member>
  60180. <member name="P:MailKit.UniqueIdRange.IsReadOnly">
  60181. <summary>
  60182. Get whether or not the range is read only.
  60183. </summary>
  60184. <remarks>
  60185. A <see cref="T:MailKit.UniqueIdRange"/> is always read-only.
  60186. </remarks>
  60187. <value><c>true</c> if the range is read only; otherwise, <c>false</c>.</value>
  60188. </member>
  60189. <member name="M:MailKit.UniqueIdRange.Add(MailKit.UniqueId)">
  60190. <summary>
  60191. Adds the unique identifier to the range.
  60192. </summary>
  60193. <remarks>
  60194. Since a <see cref="T:MailKit.UniqueIdRange"/> is read-only, unique ids cannot
  60195. be added to the range.
  60196. </remarks>
  60197. <param name="uid">The unique identifier to add.</param>
  60198. <exception cref="T:System.NotSupportedException">
  60199. The list does not support adding items.
  60200. </exception>
  60201. </member>
  60202. <member name="M:MailKit.UniqueIdRange.Clear">
  60203. <summary>
  60204. Clears the list.
  60205. </summary>
  60206. <remarks>
  60207. Since a <see cref="T:MailKit.UniqueIdRange"/> is read-only, the range cannot be cleared.
  60208. </remarks>
  60209. <exception cref="T:System.NotSupportedException">
  60210. The list does not support being cleared.
  60211. </exception>
  60212. </member>
  60213. <member name="M:MailKit.UniqueIdRange.Contains(MailKit.UniqueId)">
  60214. <summary>
  60215. Checks if the range contains the specified unique id.
  60216. </summary>
  60217. <remarks>
  60218. Determines whether or not the range contains the specified unique id.
  60219. </remarks>
  60220. <returns><value>true</value> if the specified unique identifier is in the range; otherwise <value>false</value>.</returns>
  60221. <param name="uid">The unique id.</param>
  60222. </member>
  60223. <member name="M:MailKit.UniqueIdRange.CopyTo(MailKit.UniqueId[],System.Int32)">
  60224. <summary>
  60225. Copies all of the unique ids in the range to the specified array.
  60226. </summary>
  60227. <remarks>
  60228. Copies all of the unique ids within the range into the array,
  60229. starting at the specified array index.
  60230. </remarks>
  60231. <param name="array">The array to copy the unique ids to.</param>
  60232. <param name="arrayIndex">The index into the array.</param>
  60233. <exception cref="T:System.ArgumentNullException">
  60234. <paramref name="array"/> is <c>null</c>.
  60235. </exception>
  60236. <exception cref="T:System.ArgumentOutOfRangeException">
  60237. <paramref name="arrayIndex"/> is out of range.
  60238. </exception>
  60239. </member>
  60240. <member name="M:MailKit.UniqueIdRange.Remove(MailKit.UniqueId)">
  60241. <summary>
  60242. Removes the unique identifier from the range.
  60243. </summary>
  60244. <remarks>
  60245. Since a <see cref="T:MailKit.UniqueIdRange"/> is read-only, unique ids cannot be removed.
  60246. </remarks>
  60247. <returns><value>true</value> if the unique identifier was removed; otherwise <value>false</value>.</returns>
  60248. <param name="uid">The unique identifier to remove.</param>
  60249. <exception cref="T:System.NotSupportedException">
  60250. The list does not support removing items.
  60251. </exception>
  60252. </member>
  60253. <member name="M:MailKit.UniqueIdRange.IndexOf(MailKit.UniqueId)">
  60254. <summary>
  60255. Gets the index of the specified unique id, if it exists.
  60256. </summary>
  60257. <remarks>
  60258. Finds the index of the specified unique id, if it exists.
  60259. </remarks>
  60260. <returns>The index of the specified unique id; otherwise <value>-1</value>.</returns>
  60261. <param name="uid">The unique id.</param>
  60262. </member>
  60263. <member name="M:MailKit.UniqueIdRange.Insert(System.Int32,MailKit.UniqueId)">
  60264. <summary>
  60265. Inserts the specified unique identifier at the given index.
  60266. </summary>
  60267. <remarks>
  60268. Inserts the unique identifier at the specified index in the range.
  60269. </remarks>
  60270. <param name="index">The index to insert the unique id.</param>
  60271. <param name="uid">The unique id.</param>
  60272. <exception cref="T:System.NotSupportedException">
  60273. The list does not support inserting items.
  60274. </exception>
  60275. </member>
  60276. <member name="M:MailKit.UniqueIdRange.RemoveAt(System.Int32)">
  60277. <summary>
  60278. Removes the unique identifier at the specified index.
  60279. </summary>
  60280. <remarks>
  60281. Removes the unique identifier at the specified index.
  60282. </remarks>
  60283. <param name="index">The index.</param>
  60284. <exception cref="T:System.NotSupportedException">
  60285. The list does not support removing items.
  60286. </exception>
  60287. </member>
  60288. <member name="P:MailKit.UniqueIdRange.Item(System.Int32)">
  60289. <summary>
  60290. Gets or sets the unique identifier at the specified index.
  60291. </summary>
  60292. <remarks>
  60293. Gets or sets the unique identifier at the specified index.
  60294. </remarks>
  60295. <value>The unique identifier at the specified index.</value>
  60296. <param name="index">The index.</param>
  60297. <exception cref="T:System.ArgumentOutOfRangeException">
  60298. <paramref name="index"/> is out of range.
  60299. </exception>
  60300. <exception cref="T:System.NotSupportedException">
  60301. The list does not support setting items.
  60302. </exception>
  60303. </member>
  60304. <member name="M:MailKit.UniqueIdRange.GetEnumerator">
  60305. <summary>
  60306. Gets an enumerator for the range of unique ids.
  60307. </summary>
  60308. <remarks>
  60309. Gets an enumerator for the range of unique ids.
  60310. </remarks>
  60311. <returns>The enumerator.</returns>
  60312. </member>
  60313. <member name="M:MailKit.UniqueIdRange.System#Collections#IEnumerable#GetEnumerator">
  60314. <summary>
  60315. Gets an enumerator for the range of unique ids.
  60316. </summary>
  60317. <remarks>
  60318. Gets an enumerator for the range of unique ids.
  60319. </remarks>
  60320. <returns>The enumerator.</returns>
  60321. </member>
  60322. <member name="M:MailKit.UniqueIdRange.ToString">
  60323. <summary>
  60324. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.UniqueIdRange"/>.
  60325. </summary>
  60326. <remarks>
  60327. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.UniqueIdRange"/>.
  60328. </remarks>
  60329. <returns>A <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.UniqueIdRange"/>.</returns>
  60330. </member>
  60331. <member name="M:MailKit.UniqueIdRange.TryParse(System.String,System.UInt32,MailKit.UniqueIdRange@)">
  60332. <summary>
  60333. Attempt to parse a unique identifier range.
  60334. </summary>
  60335. <remarks>
  60336. Attempts to parse a unique identifier range.
  60337. </remarks>
  60338. <returns><c>true</c> if the unique identifier range was successfully parsed; otherwise, <c>false.</c>.</returns>
  60339. <param name="token">The token to parse.</param>
  60340. <param name="validity">The UIDVALIDITY value.</param>
  60341. <param name="range">The unique identifier range.</param>
  60342. <exception cref="T:System.ArgumentNullException">
  60343. <paramref name="token"/> is <c>null</c>.
  60344. </exception>
  60345. </member>
  60346. <member name="M:MailKit.UniqueIdRange.TryParse(System.String,MailKit.UniqueIdRange@)">
  60347. <summary>
  60348. Attempt to parse a unique identifier range.
  60349. </summary>
  60350. <remarks>
  60351. Attempts to parse a unique identifier range.
  60352. </remarks>
  60353. <returns><c>true</c> if the unique identifier range was successfully parsed; otherwise, <c>false.</c>.</returns>
  60354. <param name="token">The token to parse.</param>
  60355. <param name="range">The unique identifier range.</param>
  60356. <exception cref="T:System.ArgumentNullException">
  60357. <paramref name="token"/> is <c>null</c>.
  60358. </exception>
  60359. </member>
  60360. <member name="T:MailKit.UniqueIdSet">
  60361. <summary>
  60362. A set of unique identifiers.
  60363. </summary>
  60364. <remarks>
  60365. When dealing with a large number of unique identifiers, it may be more efficient to use a
  60366. <see cref="T:MailKit.UniqueIdSet"/> than a typical IList&lt;<see cref="T:MailKit.UniqueId"/>&gt;.
  60367. </remarks>
  60368. </member>
  60369. <member name="M:MailKit.UniqueIdSet.#ctor(System.UInt32,MailKit.Search.SortOrder)">
  60370. <summary>
  60371. Initializes a new instance of the <see cref="T:MailKit.UniqueIdSet"/> class.
  60372. </summary>
  60373. <remarks>
  60374. Creates a new unique identifier set.
  60375. </remarks>
  60376. <param name="validity">The uid validity.</param>
  60377. <param name="order">The sorting order to use for the unique identifiers.</param>
  60378. <exception cref="T:System.ArgumentOutOfRangeException">
  60379. <paramref name="order"/> is invalid.
  60380. </exception>
  60381. </member>
  60382. <member name="M:MailKit.UniqueIdSet.#ctor(MailKit.Search.SortOrder)">
  60383. <summary>
  60384. Initializes a new instance of the <see cref="T:MailKit.UniqueIdSet"/> class.
  60385. </summary>
  60386. <remarks>
  60387. Creates a new unique identifier set.
  60388. </remarks>
  60389. <param name="order">The sorting order to use for the unique identifiers.</param>
  60390. <exception cref="T:System.ArgumentOutOfRangeException">
  60391. <paramref name="order"/> is invalid.
  60392. </exception>
  60393. </member>
  60394. <member name="M:MailKit.UniqueIdSet.#ctor(System.Collections.Generic.IEnumerable{MailKit.UniqueId},MailKit.Search.SortOrder)">
  60395. <summary>
  60396. Initializes a new instance of the <see cref="T:MailKit.UniqueIdSet"/> class.
  60397. </summary>
  60398. <remarks>
  60399. Creates a new set of unique identifier set containing the specified uids.
  60400. </remarks>
  60401. <param name="uids">An initial set of unique ids.</param>
  60402. <param name="order">The sorting order to use for the unique identifiers.</param>
  60403. <exception cref="T:System.ArgumentOutOfRangeException">
  60404. <paramref name="order"/> is invalid.
  60405. </exception>
  60406. </member>
  60407. <member name="P:MailKit.UniqueIdSet.SortOrder">
  60408. <summary>
  60409. Gets the sort order of the unique identifiers.
  60410. </summary>
  60411. <remarks>
  60412. Gets the sort order of the unique identifiers.
  60413. </remarks>
  60414. <value>The sort order.</value>
  60415. </member>
  60416. <member name="P:MailKit.UniqueIdSet.Validity">
  60417. <summary>
  60418. Gets the validity, if non-zero.
  60419. </summary>
  60420. <remarks>
  60421. Gets the UidValidity of the containing folder.
  60422. </remarks>
  60423. <value>The UidValidity of the containing folder.</value>
  60424. </member>
  60425. <member name="P:MailKit.UniqueIdSet.Count">
  60426. <summary>
  60427. Get the number of unique ids in the set.
  60428. </summary>
  60429. <remarks>
  60430. Gets the number of unique ids in the set.
  60431. </remarks>
  60432. <value>The count.</value>
  60433. </member>
  60434. <member name="P:MailKit.UniqueIdSet.IsReadOnly">
  60435. <summary>
  60436. Get whether or not the set is read only.
  60437. </summary>
  60438. <remarks>
  60439. Gets whether or not the set is read-only.
  60440. </remarks>
  60441. <value><c>true</c> if the set is read only; otherwise, <c>false</c>.</value>
  60442. </member>
  60443. <member name="M:MailKit.UniqueIdSet.Add(MailKit.UniqueId)">
  60444. <summary>
  60445. Adds the unique identifier to the set.
  60446. </summary>
  60447. <remarks>
  60448. Adds the unique identifier to the set.
  60449. </remarks>
  60450. <param name="uid">The unique identifier to add.</param>
  60451. <exception cref="T:System.ArgumentException">
  60452. <paramref name="uid"/> is invalid.
  60453. </exception>
  60454. </member>
  60455. <member name="M:MailKit.UniqueIdSet.AddRange(System.Collections.Generic.IEnumerable{MailKit.UniqueId})">
  60456. <summary>
  60457. Adds all of the uids to the set.
  60458. </summary>
  60459. <remarks>
  60460. Adds all of the uids to the set.
  60461. </remarks>
  60462. <param name="uids">The collection of uids.</param>
  60463. </member>
  60464. <member name="M:MailKit.UniqueIdSet.Clear">
  60465. <summary>
  60466. Clears the list.
  60467. </summary>
  60468. <remarks>
  60469. Clears the list.
  60470. </remarks>
  60471. <exception cref="T:System.InvalidOperationException">
  60472. The collection is readonly.
  60473. </exception>
  60474. </member>
  60475. <member name="M:MailKit.UniqueIdSet.Contains(MailKit.UniqueId)">
  60476. <summary>
  60477. Checks if the set contains the specified unique id.
  60478. </summary>
  60479. <remarks>
  60480. Determines whether or not the set contains the specified unique id.
  60481. </remarks>
  60482. <returns><value>true</value> if the specified unique identifier is in the set; otherwise <value>false</value>.</returns>
  60483. <param name="uid">The unique id.</param>
  60484. </member>
  60485. <member name="M:MailKit.UniqueIdSet.CopyTo(MailKit.UniqueId[],System.Int32)">
  60486. <summary>
  60487. Copies all of the unique ids in the set to the specified array.
  60488. </summary>
  60489. <remarks>
  60490. Copies all of the unique ids within the set into the array,
  60491. starting at the specified array index.
  60492. </remarks>
  60493. <param name="array">The array to copy the unique ids to.</param>
  60494. <param name="arrayIndex">The index into the array.</param>
  60495. <exception cref="T:System.ArgumentNullException">
  60496. <paramref name="array"/> is <c>null</c>.
  60497. </exception>
  60498. <exception cref="T:System.ArgumentOutOfRangeException">
  60499. <paramref name="arrayIndex"/> is out of set.
  60500. </exception>
  60501. </member>
  60502. <member name="M:MailKit.UniqueIdSet.Remove(MailKit.UniqueId)">
  60503. <summary>
  60504. Removes the unique identifier from the set.
  60505. </summary>
  60506. <remarks>
  60507. Removes the unique identifier from the set.
  60508. </remarks>
  60509. <returns><value>true</value> if the unique identifier was removed; otherwise <value>false</value>.</returns>
  60510. <param name="uid">The unique identifier to remove.</param>
  60511. </member>
  60512. <member name="M:MailKit.UniqueIdSet.IndexOf(MailKit.UniqueId)">
  60513. <summary>
  60514. Gets the index of the specified unique id, if it exists.
  60515. </summary>
  60516. <remarks>
  60517. Finds the index of the specified unique id, if it exists.
  60518. </remarks>
  60519. <returns>The index of the specified unique id; otherwise <value>-1</value>.</returns>
  60520. <param name="uid">The unique id.</param>
  60521. </member>
  60522. <member name="M:MailKit.UniqueIdSet.Insert(System.Int32,MailKit.UniqueId)">
  60523. <summary>
  60524. Inserts the specified unique identifier at the given index.
  60525. </summary>
  60526. <remarks>
  60527. Inserts the unique identifier at the specified index in the set.
  60528. </remarks>
  60529. <param name="index">The index to insert the unique id.</param>
  60530. <param name="uid">The unique id.</param>
  60531. <exception cref="T:System.NotSupportedException">
  60532. The list does not support inserting items.
  60533. </exception>
  60534. </member>
  60535. <member name="M:MailKit.UniqueIdSet.RemoveAt(System.Int32)">
  60536. <summary>
  60537. Removes the unique identifier at the specified index.
  60538. </summary>
  60539. <remarks>
  60540. Removes the unique identifier at the specified index.
  60541. </remarks>
  60542. <param name="index">The index.</param>
  60543. <exception cref="T:System.ArgumentOutOfRangeException">
  60544. <paramref name="index"/> is out of range.
  60545. </exception>
  60546. </member>
  60547. <member name="P:MailKit.UniqueIdSet.Item(System.Int32)">
  60548. <summary>
  60549. Gets or sets the unique identifier at the specified index.
  60550. </summary>
  60551. <remarks>
  60552. Gets or sets the unique identifier at the specified index.
  60553. </remarks>
  60554. <value>The unique identifier at the specified index.</value>
  60555. <param name="index">The index.</param>
  60556. <exception cref="T:System.ArgumentOutOfRangeException">
  60557. <paramref name="index"/> is out of range.
  60558. </exception>
  60559. <exception cref="T:System.NotSupportedException">
  60560. The list does not support setting items.
  60561. </exception>
  60562. </member>
  60563. <member name="M:MailKit.UniqueIdSet.GetEnumerator">
  60564. <summary>
  60565. Gets an enumerator for the set of unique ids.
  60566. </summary>
  60567. <remarks>
  60568. Gets an enumerator for the set of unique ids.
  60569. </remarks>
  60570. <returns>The enumerator.</returns>
  60571. </member>
  60572. <member name="M:MailKit.UniqueIdSet.System#Collections#IEnumerable#GetEnumerator">
  60573. <summary>
  60574. Gets an enumerator for the set of unique ids.
  60575. </summary>
  60576. <remarks>
  60577. Gets an enumerator for the set of unique ids.
  60578. </remarks>
  60579. <returns>The enumerator.</returns>
  60580. </member>
  60581. <member name="M:MailKit.UniqueIdSet.ToString">
  60582. <summary>
  60583. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.UniqueIdSet"/>.
  60584. </summary>
  60585. <remarks>
  60586. Returns a <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.UniqueIdSet"/>.
  60587. </remarks>
  60588. <returns>A <see cref="T:System.String"/> that represents the current <see cref="T:MailKit.UniqueIdSet"/>.</returns>
  60589. </member>
  60590. <member name="M:MailKit.UniqueIdSet.ToString(System.Collections.Generic.IList{MailKit.UniqueId})">
  60591. <summary>
  60592. Format a generic list of unique identifiers as a string.
  60593. </summary>
  60594. <remarks>
  60595. Formats a generic list of unique identifiers as a string.
  60596. </remarks>
  60597. <returns>The string representation of the collection of unique identifiers.</returns>
  60598. <param name="uids">The unique identifiers.</param>
  60599. <exception cref="T:System.ArgumentNullException">
  60600. <paramref name="uids"/> is <c>null</c>.
  60601. </exception>
  60602. <exception cref="T:System.ArgumentException">
  60603. One or more of the unique identifiers is invalid (has a value of <c>0</c>).
  60604. </exception>
  60605. </member>
  60606. <member name="M:MailKit.UniqueIdSet.EnumerateSerializedSubsets(System.Int32)">
  60607. <summary>
  60608. Format the set of unique identifiers as multiple strings that fit within the maximum defined character length.
  60609. </summary>
  60610. <remarks>
  60611. Formats the set of unique identifiers as multiple strings that fit within the maximum defined character length.
  60612. </remarks>
  60613. <returns>A list of strings representing the collection of unique identifiers.</returns>
  60614. <param name="maxLength">The maximum length of any returned string of UIDs.</param>
  60615. <exception cref="T:System.ArgumentOutOfRangeException">
  60616. <paramref name="maxLength"/> is negative.
  60617. </exception>
  60618. </member>
  60619. <member name="M:MailKit.UniqueIdSet.EnumerateSerializedSubsets(System.Collections.Generic.IList{MailKit.UniqueId},System.Int32)">
  60620. <summary>
  60621. Format a generic list of unique identifiers as multiple strings that fit within the maximum defined character length.
  60622. </summary>
  60623. <remarks>
  60624. Formats a generic list of unique identifiers as multiple strings that fit within the maximum defined character length.
  60625. </remarks>
  60626. <returns>A list of strings representing the collection of unique identifiers.</returns>
  60627. <param name="uids">The unique identifiers.</param>
  60628. <param name="maxLength">The maximum length of any returned string of UIDs.</param>
  60629. <exception cref="T:System.ArgumentNullException">
  60630. <paramref name="uids"/> is <c>null</c>.
  60631. </exception>
  60632. <exception cref="T:System.ArgumentException">
  60633. One or more of the unique identifiers is invalid (has a value of <c>0</c>).
  60634. </exception>
  60635. <exception cref="T:System.ArgumentOutOfRangeException">
  60636. <paramref name="maxLength"/> is negative.
  60637. </exception>
  60638. </member>
  60639. <member name="M:MailKit.UniqueIdSet.TryParse(System.String,System.UInt32,MailKit.UniqueIdSet@)">
  60640. <summary>
  60641. Attempt to parse the specified token as a set of unique identifiers.
  60642. </summary>
  60643. <remarks>
  60644. Attempts to parse the specified token as a set of unique identifiers.
  60645. </remarks>
  60646. <returns><c>true</c> if the set of unique identifiers were successfully parsed; otherwise, <c>false</c>.</returns>
  60647. <param name="token">The token containing the set of unique identifiers.</param>
  60648. <param name="validity">The UIDVALIDITY value.</param>
  60649. <param name="uids">The set of unique identifiers.</param>
  60650. <exception cref="T:System.ArgumentNullException">
  60651. <paramref name="token"/> is <c>null</c>.
  60652. </exception>
  60653. </member>
  60654. <member name="M:MailKit.UniqueIdSet.TryParse(System.String,MailKit.UniqueIdSet@)">
  60655. <summary>
  60656. Attempt to parse the specified token as a set of unique identifiers.
  60657. </summary>
  60658. <remarks>
  60659. Attempts to parse the specified token as a set of unique identifiers.
  60660. </remarks>
  60661. <returns><c>true</c> if the set of unique identifiers were successfully parsed; otherwise, <c>false</c>.</returns>
  60662. <param name="token">The token containing the set of unique identifiers.</param>
  60663. <param name="uids">The set of unique identifiers.</param>
  60664. <exception cref="T:System.ArgumentNullException">
  60665. <paramref name="token"/> is <c>null</c>.
  60666. </exception>
  60667. </member>
  60668. </members>
  60669. </doc>